الفهرس
AccessibleBiddingStrategy
(رسالة)AccessibleBiddingStrategy.MaximizeConversionValue
(رسالة)AccessibleBiddingStrategy.MaximizeConversions
(رسالة)AccessibleBiddingStrategy.TargetCpa
(رسالة)AccessibleBiddingStrategy.TargetImpressionShare
(رسالة)AccessibleBiddingStrategy.TargetRoas
(رسالة)AccessibleBiddingStrategy.TargetSpend
(رسالة)Ad
(رسالة)AdGroup
(رسالة)AdGroupAd
(رسالة)AdGroupAdLabel
(رسالة)AdGroupAsset
(رسالة)AdGroupAssetSet
(رسالة)AdGroupAudienceView
(رسالة)AdGroupBidModifier
(رسالة)AdGroupCriterion
(رسالة)AdGroupCriterion.PositionEstimates
(رسالة)AdGroupCriterion.QualityInfo
(رسالة)AdGroupCriterionLabel
(رسالة)AdGroupLabel
(رسالة)AgeRangeView
(رسالة)Asset
(رسالة)AssetGroup
(رسالة)AssetGroupAsset
(رسالة)AssetGroupAssetCombinationData
(رسالة)AssetGroupListingGroupFilter
(رسالة)AssetGroupSignal
(رسالة)AssetGroupTopCombinationView
(رسالة)AssetSet
(رسالة)AssetSetAsset
(رسالة)Audience
(رسالة)BiddingStrategy
(رسالة)Campaign
(رسالة)Campaign.DynamicSearchAdsSetting
(رسالة)Campaign.GeoTargetTypeSetting
(رسالة)Campaign.NetworkSettings
(رسالة)Campaign.OptimizationGoalSetting
(رسالة)Campaign.SelectiveOptimization
(رسالة)Campaign.ShoppingSetting
(رسالة)Campaign.TrackingSetting
(رسالة)CampaignAsset
(رسالة)CampaignAssetSet
(رسالة)CampaignAudienceView
(رسالة)CampaignBudget
(رسالة)CampaignCriterion
(رسالة)CampaignLabel
(رسالة)CartDataSalesView
(رسالة)Conversion
(رسالة)ConversionAction
(رسالة)ConversionAction.AttributionModelSettings
(رسالة)ConversionAction.FloodlightSettings
(رسالة)ConversionAction.ValueSettings
(رسالة)ConversionCustomVariable
(رسالة)ConversionCustomVariable.FloodlightConversionCustomVariableInfo
(رسالة)ConversionTrackingSetting
(رسالة)CustomColumn
(رسالة)Customer
(رسالة)CustomerAsset
(رسالة)CustomerAssetSet
(رسالة)CustomerClient
(رسالة)CustomerManagerLink
(رسالة)DoubleClickCampaignManagerSetting
(رسالة)DynamicSearchAdsSearchTermView
(رسالة)GenderView
(رسالة)GeoTargetConstant
(رسالة)KeywordView
(رسالة)Label
(رسالة)LanguageConstant
(رسالة)ListingGroupFilterDimension
(رسالة)ListingGroupFilterDimension.ProductBiddingCategory
(رسالة)ListingGroupFilterDimension.ProductBrand
(رسالة)ListingGroupFilterDimension.ProductChannel
(رسالة)ListingGroupFilterDimension.ProductCondition
(رسالة)ListingGroupFilterDimension.ProductCustomAttribute
(رسالة)ListingGroupFilterDimension.ProductItemId
(رسالة)ListingGroupFilterDimension.ProductType
(رسالة)ListingGroupFilterDimensionPath
(رسالة)LocationView
(رسالة)ProductBiddingCategoryConstant
(رسالة)ProductGroupView
(رسالة)SearchAds360Field
(رسالة)ShoppingPerformanceView
(رسالة)UserList
(رسالة)Visit
(رسالة)WebpageView
(رسالة)
AccessibleBiddingStrategy
يمثّل عرضًا لاستراتيجيات عروض الأسعار التي يملكها العميل وتتم مشاركتها معه.
وعلى عكس "عروض الأسعار" (عروض الأسعار)، يتضمّن هذا المرجع استراتيجيات يملكها مدراء العميل وتمت مشاركتها مع هذا العميل، بالإضافة إلى الاستراتيجيات التي يملكها هذا العميل. لا يوفّر هذا المرجع مقاييس، وهو يعرض فقط مجموعة فرعية محدودة من سمات "استراتيجية عروض الأسعار".
الحقول | |
---|---|
resource_name |
اسم مورد استراتيجية عروض الأسعار التي يمكن الوصول إليها. تكون أسماء موارد Accessible BiddingStrategy على النحو التالي:
|
id |
رقم تعريف استراتيجية عروض الأسعار. |
name |
اسم استراتيجية عروض الأسعار. |
type |
نوع استراتيجية عروض الأسعار. |
owner_customer_id |
رقم تعريف العميل الذي يملك استراتيجية عروض الأسعار. |
owner_descriptive_name |
segmentation_name للعميل الذي يملك استراتيجية عروض الأسعار |
حقل الاتحاد يمكن ضبط سمة واحدة فقط. يمكن أن يكون الحقل " |
|
maximize_conversion_value |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك |
maximize_conversions |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك |
target_cpa |
استراتيجية عروض أسعار تعمل على ضبط عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بتكلفة الإجراء المستهدَفة التي تحدّدها. |
target_impression_share |
استراتيجية عروض أسعار يتم تحسينها تلقائيًا لزيادة نسبة مئوية مختارة من مرات الظهور. |
target_roas |
استراتيجية عروض أسعار تساعدك على زيادة الأرباح إلى أقصى حد مع بلوغ متوسط عائد إنفاق إعلاني مستهدَف معيّن. |
target_spend |
استراتيجية عروض أسعار تحدِّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك. |
MaximizeConversionValue
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك
الحقول | |
---|---|
target_roas |
خيار عائد الإنفاق الإعلاني المستهدَف (ROAS). وفي حال تحديدها، ستؤدي استراتيجية عروض الأسعار إلى زيادة الأرباح إلى أقصى حدّ مع احتساب متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. وفي حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستهدِف استراتيجية عروض الأسعار إلى تحقيق أعلى عائد إنفاق إعلاني ممكن في الميزانية. |
MaximizeConversions
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك
الحقول | |
---|---|
target_cpa |
خيار التكلفة المستهدفة للإجراء. هذا هو متوسط المبلغ الذي تريد إنفاقه لكل عملية اكتساب. |
target_cpa_micros |
خيار التكلفة المستهدفة للإجراء. هذا هو متوسط المبلغ الذي تريد إنفاقه لكل عملية اكتساب. |
TargetCpa
استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها.
الحقول | |
---|---|
target_cpa_micros |
متوسط تكلفة الإجراء المستهدفة. يجب أن تكون قيمة هذا الاستهداف أكبر من الحد الأدنى للوحدة القابلة للفوترة أو مساويًا له استنادًا إلى عملة الحساب. |
TargetRoas
استراتيجية عروض أسعار مبرمَجة تساعدك على زيادة الأرباح إلى أقصى حد مع احتساب متوسط عائد إنفاق إعلاني مستهدَف محدّد
الحقول | |
---|---|
target_roas |
الأرباح المختارة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق. |
TargetSpend
استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.
الحقول | |
---|---|
target_spend_micros |
الإنفاق المستهدف الذي يتم بموجبه تحقيق الحد الأقصى من النقرات. سيحاول مقدِّم عروض أسعار "الإنفاق الهدف" إنفاق القيمة الأقلّ من هذه القيمة أو مبلغ الإنفاق المضبوط بشكلٍ طبيعي. وفي حال عدم تحديدها، يتم استخدام الميزانية على أنها الإنفاق المستهدف. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه بعد الآن. يمكنك الاطّلاع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html لمعرفة التفاصيل. |
cpc_bid_ceiling_micros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. |
إعلان
إعلان
الحقول | |
---|---|
resource_name |
اسم مورد الإعلان. وتكون أسماء موارد الإعلانات على النحو التالي:
|
final_urls[] |
قائمة عناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات للإعلان. |
type |
نوع الإعلان. |
id |
رقم تعريف الإعلان. |
display_url |
عنوان URL الذي يظهر في وصف الإعلان لبعض أشكال الإعلانات. |
name |
اسم الإعلان. يُستخدم هذا الإجراء فقط لتحديد الإعلان. ولا يلزم أن تكون فريدة ولا تؤثر في الإعلان المعروض. حقل الاسم متوافق حاليًا فقط مع DisplayUploadAd وImageAd وShoppingComparisonListingAd وVideoAd. |
حقل الاتحاد ad_data تفاصيل ذات صلة بنوع الإعلان يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون الحقل "ad_data " واحدًا فقط مما يلي: |
|
text_ad |
التفاصيل المتعلّقة بإعلان نصي. |
expanded_text_ad |
التفاصيل المتعلّقة بإعلان نصي موسَّع |
responsive_search_ad |
تفاصيل مرتبطة بإعلان متجاوب على شبكة البحث. |
product_ad |
التفاصيل المتعلّقة بإعلان منتج. |
expanded_dynamic_search_ad |
التفاصيل المتعلّقة بإعلان ديناميكي موسَّع على شبكة البحث |
AdGroup
مجموعة إعلانية.
الحقول | |
---|---|
resource_name |
اسم مورد المجموعة الإعلانية. وتكون أسماء موارد المجموعة الإعلانية على النحو التالي:
|
status |
حالة المجموعة الإعلانية. |
type |
نوع المجموعة الإعلانية. |
ad_rotation_mode |
وضع عرض الإعلانات بالتناوب للمجموعة الإعلانية. |
creation_time |
الطابع الزمني عند إنشاء هذه المجموعة الإعلانية. يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
targeting_setting |
إعداد لاستهداف الميزات ذات الصلة. |
labels[] |
أسماء الموارد للتصنيفات المرفقة بهذه المجموعة الإعلانية. |
engine_id |
رقم تعريف المجموعة الإعلانية في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan أو Microsoft أو Baidu أو غير ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "ad_group.id" بدلاً من ذلك. |
start_date |
تاريخ بدء هذه المجموعة الإعلانية في عرض الإعلانات. بشكلٍ افتراضي، تبدأ المجموعة الإعلانية الآن أو تاريخ بدء المجموعة الإعلانية، أيهما أبعد. إذا تم إعداد هذا الحقل، ستبدأ المجموعة الإعلانية في بداية التاريخ المحدّد في المنطقة الزمنية للعميل. هذا الحقل متاح فقط لحسابات بوابة Microsoft Advertising وFacebook. التنسيق: YYYY-MM-DD مثال: 14-03-2019 |
end_date |
تاريخ انتهاء المجموعة الإعلانية من عرض الإعلانات. بشكل افتراضي، تنتهي المجموعة الإعلانية في تاريخ انتهاء المجموعة الإعلانية. إذا تم ضبط هذا الحقل، ستنتهي المجموعة الإعلانية بنهاية التاريخ المحدّد في المنطقة الزمنية للعميل. هذا الحقل متاح فقط لحسابات بوابة Microsoft Advertising وFacebook. التنسيق: YYYY-MM-DD مثال: 14-03-2019 |
language_code |
لغة الإعلانات والكلمات الرئيسية في المجموعة الإعلانية. هذا الحقل متاح فقط لحسابات Microsoft Advertising. مزيد من التفاصيل: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last_modified_time |
تاريخ آخر تعديل لهذه المجموعة الإعلانية. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
id |
رقم تعريف المجموعة الإعلانية. |
name |
اسم المجموعة هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء مجموعات إعلانية جديدة. ويجب أن يحتوي على أقل من 255 حرفًا بالعرض الكامل لترميز UTF-8. ويجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 0xA) أو أحرف الرجوع إلى أول السطر (رمز النقطة 0xD). |
cpc_bid_micros |
عرض السعر الأقصى للنقرة. |
engine_status |
حالة محرّك البحث للمجموعة الإعلانية. |
AdGroupAd
إعلان مجموعة إعلانية.
الحقول | |
---|---|
resource_name |
اسم مورد الإعلان. وتكون أسماء موارد الإعلانات في المجموعة الإعلانية على النحو التالي:
|
status |
حالة الإعلان. |
ad |
الإعلان |
creation_time |
الطابع الزمني لوقت إنشاء ad_group_ad. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
labels[] |
أسماء الموارد للتصنيفات المرفقة بإعلان المجموعة الإعلانية هذا. |
engine_id |
رقم تعريف الإعلان في حساب محرّك البحث الخارجي هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى الكيانات غير التابعة لـ "إعلانات شبكة البحث 360"، يمكنك استخدام "ad_group_ad.ad.id" بدلاً من ذلك. |
engine_status |
حالة إضافية للإعلان في حساب محرّك البحث الخارجي تشمل الحالات المحتملة (حسب نوع الحساب الخارجي) الحالة "نشط" أو "مؤهَّل" أو "في انتظار المراجعة"، وما إلى ذلك. |
last_modified_time |
تاريخ آخر تعديل تم إجراؤه على إعلان المجموعة الإعلانية هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
AdGroupAdLabel
علاقة بين إعلان مجموعة إعلانية وتصنيف.
الحقول | |
---|---|
resource_name |
اسم المورد لتصنيف إعلان المجموعة الإعلانية. تكون أسماء موارد تصنيف الإعلان للمجموعة الإعلانية على النحو التالي: |
ad_group_ad |
إعلان المجموعة الإعلانية الذي تم إرفاق التصنيف به. |
label |
التصنيف المعيَّن لإعلان المجموعة الإعلانية. |
AdGroupAsset
تمثّل هذه السمة رابطًا بين مجموعة إعلانية ومادة عرض.
الحقول | |
---|---|
resource_name |
اسم المورد لمادة عرض المجموعة الإعلانية. تكون أسماء موارد المجموعة الإعلانية بالصيغة التالية:
|
ad_group |
مطلوبة. المجموعة الإعلانية التي ترتبط بها مادة العرض. |
asset |
مطلوبة. مادة العرض المرتبطة بالمجموعة الإعلانية. |
status |
حالة مادة عرض المجموعة الإعلانية. |
AdGroupAssetSet
GroupAssetSet هي الرابط بين مجموعة إعلانية ومجموعة مواد عرض. عند إنشاء مجموعة مواد عرض مجموعة إعلانية، يتم ربط مجموعة مواد عرض بمجموعة إعلانية.
الحقول | |
---|---|
resource_name |
اسم المورد لمجموعة مواد العرض في المجموعة الإعلانية تكون أسماء موارد مجموعة مواد العرض للمجموعة الإعلانية على النحو التالي:
|
ad_group |
المجموعة الإعلانية التي ترتبط بها مجموعة مواد العرض هذه. |
asset_set |
مجموعة مواد العرض المرتبطة بالمجموعة الإعلانية. |
status |
حالة مجموعة مواد العرض في المجموعة الإعلانية. للقراءة فقط |
AdGroupAudienceView
مشاهدة جمهور المجموعة الإعلانية. تشمل بيانات الأداء من قوائم الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على الشبكة الإعلانية وشبكة YouTube، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (قوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث)، المجمّعة على مستوى الجمهور.
الحقول | |
---|---|
resource_name |
اسم المورد لطريقة عرض الجمهور للمجموعة الإعلانية. تكون أسماء مراجع مشاهدة الجمهور في المجموعة الإعلانية على النحو التالي:
|
AdGroupBidModifier
يمثل معدِّل عروض أسعار المجموعة الإعلانية.
الحقول | |
---|---|
resource_name |
اسم المورد لمعدِّل عرض سعر المجموعة الإعلانية. تكون أسماء موارد معدِّل عروض أسعار المجموعة الإعلانية على النحو التالي:
|
bid_modifier |
معدِّل عرض السعر عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. النطاق هو 1.0 - 6.0 بالنسبة إلى PreferredContent. استخدِم 0 لإيقاف نوع جهاز. |
حقل الاتحاد مطلوب في عمليات الإنشاء التي تبدأ بـ V5. يمكن أن يكون الحقل " |
|
device |
معيار جهاز. |
AdGroupCriterion
معيار مجموعة إعلانية. لا يعرض تقرير ad_group_criterion سوى المعايير التي تمت إضافتها بشكلٍ صريح إلى المجموعة الإعلانية.
الحقول | |
---|---|
resource_name |
اسم مورد معيار المجموعة الإعلانية. تكون أسماء موارد معايير المجموعة الإعلانية على النحو التالي:
|
creation_time |
الطابع الزمني عند إنشاء معيار المجموعة الإعلانية هذا. يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
status |
حالة المعيار. هذه هي حالة كيان معيار المجموعة الإعلانية، الذي حدّده العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهَّلاً للعرض. في بعض الحالات، ما زال المعيار الذي تمت إزالته في واجهة برمجة التطبيقات يظهر على أنّه مفعّل في واجهة المستخدم. على سبيل المثال، يتم عرض الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادها. ستعرض واجهة المستخدم كل فئة عمرية على أنها "مفعّلة"، بما أنها مؤهَّلة لمشاهدة الإعلانات، إلا أنّ حالة قاعدة بيانات الإعلان: "تمت الإزالة"، بسبب عدم إضافة أي معيار إيجابي. |
quality_info |
تمثّل هذه السمة معلومات عن جودة المعيار. |
type |
نوع المعيار. |
labels[] |
أسماء موارد التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا. |
position_estimates |
تقديرات عروض أسعار المعايير في مواضع مختلفة. |
final_urls[] |
قائمة عناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات للإعلان. |
engine_id |
رقم تعريف معيار المجموعة الإعلانية في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "ad_group_criterion.criterion_id" بدلاً من ذلك. |
last_modified_time |
التاريخ والوقت لآخر تعديل لمعيار المجموعة الإعلانية هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
criterion_id |
رقم تعريف المعيار. |
ad_group |
المجموعة الإعلانية التي ينتمي إليها المعيار. |
negative |
تحديد ما إذا كان سيتم استهداف ( هذا الحقل غير قابل للتغيير. لتبديل معيار من موجب إلى سالب، عليك إزالته ثم إعادة إضافته. |
bid_modifier |
معدِّل عرض السعر عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات. |
cpc_bid_micros |
عرض سعر النقرة. |
effective_cpc_bid_micros |
عرض سعر النقرة الفعّال. |
engine_status |
حالة المحرّك لمعيار المجموعة الإعلانية. |
final_url_suffix |
نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي |
tracking_url_template |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. |
حقل الاتحاد يجب ضبط واحد بالضبط. يمكن أن يكون الحقل " |
|
keyword |
الكلمة الرئيسية. |
listing_group |
مجموعة البيانات |
age_range |
الفئة العمرية. |
gender |
الجنس. |
user_list |
قائمة المستخدمين. |
webpage |
صفحة ويب |
location |
الموقع الجغرافي. |
PositionEstimates
تقديرات عروض أسعار المعايير في مواضع مختلفة.
الحقول | |
---|---|
top_of_page_cpc_micros |
تقدير عرض سعر النقرة المطلوب لعرض الإعلان أعلى الصفحة الأولى من نتائج البحث. |
QualityInfo
حاوية لمعلومات جودة معايير المجموعة الإعلانية
الحقول | |
---|---|
quality_score |
نقاط الجودة. قد لا تتم تعبئة هذا الحقل إذا لم يكن لدى Google معلومات كافية لتحديد قيمة. |
AdGroupCriterionLabel
يشير ذلك المصطلح إلى علاقة بين معيار مجموعة إعلانية وتصنيف معيَّن.
الحقول | |
---|---|
resource_name |
اسم المورد لتصنيف معيار المجموعة الإعلانية. تكون أسماء موارد تصنيف معايير المجموعة الإعلانية على النحو التالي: |
ad_group_criterion |
معيار المجموعة الإعلانية الذي يتم إرفاق التصنيف به. |
label |
التصنيف المعيَّن لمعيار المجموعة الإعلانية. |
AdGroupLabel
علاقة بين مجموعة إعلانية وتصنيف.
الحقول | |
---|---|
resource_name |
اسم المورد لتصنيف المجموعة الإعلانية. تكون أسماء موارد تصنيف المجموعة الإعلانية على النحو التالي: |
ad_group |
المجموعة الإعلانية التي تم إرفاق التصنيف بها. |
label |
التصنيف المعيَّن للمجموعة الإعلانية. |
AgeRangeView
عرض الفئة العمرية.
الحقول | |
---|---|
resource_name |
اسم المورد لعرض الفئة العمرية. تكون أسماء موارد الاطّلاع على الفئة العمرية على النحو التالي:
|
مادة العرض
مادة العرض هي جزء من إعلان يمكن مشاركته مع إعلانات متعددة. ويمكن أن تكون مواد العرض صورة (ImageAsset) أو فيديو (YoutubeVideoAsset) وما إلى ذلك. مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف عرض مادة عرض، يجب إزالتها من الكيان الذي يستخدمها.
الحقول | |
---|---|
resource_name |
اسم مورد مادة العرض. وتكون أسماء موارد مواد العرض على النحو التالي:
|
type |
نوع مادة العرض |
final_urls[] |
قائمة بعناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات. |
status |
حالة مادة العرض |
creation_time |
الطابع الزمني عند إنشاء مادة العرض هذه يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
last_modified_time |
تمثّل هذه السمة تاريخ آخر تعديل لمادة العرض هذه. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
id |
رقم تعريف مادة العرض |
name |
اسم اختياري لمادة العرض |
tracking_url_template |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. |
engine_status |
حالة محرّك البحث لمادة العرض |
حقل الاتحاد asset_data النوع المحدد لمادة العرض. يمكن أن يكون الحقل "asset_data " واحدًا فقط مما يلي: |
|
youtube_video_asset |
مادة عرض فيديو على YouTube. |
image_asset |
مادّة عرض صورة |
text_asset |
مادة عرض نصية. |
callout_asset |
مادة عرض وسيلة شرح موحّدة |
sitelink_asset |
مادة عرض رابط أقسام موقع موحَّدة |
page_feed_asset |
مادة عرض خلاصة صفحة موحّدة. |
mobile_app_asset |
مادة عرض تطبيق للأجهزة الجوّالة. |
call_asset |
مادة عرض مكالمة موحّدة. |
call_to_action_asset |
مادة عرض عبارة الحثّ على اتّخاذ إجراء. |
location_asset |
مادة عرض موقع جغرافي موحَّدة |
AssetGroup
مجموعة مواد عرض. يتمّ استخدام AssetGroupAsset لربط مادة عرض بمجموعة مواد العرض. يتمّ استخدام AssetGroupSignal لربط إشارة بمجموعة مواد عرض.
الحقول | |
---|---|
resource_name |
اسم المورد لمجموعة مواد العرض. تكون أسماء موارد مجموعة مواد العرض على النحو التالي:
|
id |
رقم تعريف مجموعة مواد العرض. |
campaign |
الحملة التي ترتبط بها مجموعة مواد العرض هذه. مادة العرض المرتبطة بمجموعة مواد العرض. |
name |
مطلوبة. اسم مجموعة مواد العرض مطلوبة. يجب أن يبلغ طولها 1 كحد أدنى و128 طولاً كحد أقصى. ويجب أن يكون فريدًا ضمن أي حملة. |
final_urls[] |
قائمة بعناوين URL النهائية بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهَّلة للتوسيع ما لم يتم إيقافها. |
final_mobile_urls[] |
قائمة بعناوين URL النهائية للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهَّلة للتوسيع ما لم يتم إيقافها. |
status |
حالة مجموعة مواد العرض. |
path1 |
الجزء الأول من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان |
path2 |
الجزء الثاني من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط المسار 1. |
ad_strength |
إجمالي قوة الإعلان لمجموعة مواد العرض هذه. |
AssetGroupAsset
AssetGroupAsset هي الرابط بين مادة عرض ومجموعة مواد عرض. تؤدي إضافة AssetGroupAsset إلى ربط مادة عرض بمجموعة مواد عرض.
الحقول | |
---|---|
resource_name |
اسم المورد لمادة العرض الخاصة بمجموعة مواد العرض يكون اسم مورد مادة العرض ضمن مجموعة مواد العرض على النحو التالي:
|
asset_group |
مجموعة مواد العرض التي تربطها مادة عرض مجموعة مواد العرض هذه. |
asset |
مادة العرض التي تربطها مادة عرض مجموعة مواد العرض هذه. |
field_type |
وصف موضع إعلان مادة العرض ضمن مجموعة مواد العرض. على سبيل المثال: HEADLINE وYOUTUBE_VIDEO وما إلى ذلك |
status |
حالة الرابط بين مادة عرض ومجموعة مواد عرض. |
AssetGroupAssetCombinationData
بيانات تركيبات مواد العرض في مجموعة مواد العرض
الحقول | |
---|---|
asset_combination_served_assets[] |
مواد العرض المعروضة. |
AssetGroupListingGroupFilter
يمثّل AssetGroupListingGroupFilter عقدة شجرة بيانات لمجموعة البيانات في مجموعة مواد عرض.
الحقول | |
---|---|
resource_name |
اسم المصدر لفلتر مجموعة بيانات مجموعة مواد العرض يكون اسم مورد فلتر مجموعة بيانات مجموعة مواد العرض على النحو التالي:
|
asset_group |
مجموعة مواد العرض التي يشكّل فلتر مجموعة بيانات مجموعة مواد العرض هذا جزءًا منها. |
id |
رقم تعريف ListingGroupFilter. |
type |
نوع عقدة فلتر مجموعة البيانات. |
vertical |
العمود الذي تمثله شجرة العُقد الحالية. يجب أن تنتمي جميع العُقد في نفس الشجرة إلى العمود نفسه. |
case_value |
قيمة السمة التي تعمل بها مجموعة البيانات هذه على تحسين عنصرها الرئيسي. غير معرَّف للمجموعة الجذر. |
parent_listing_group_filter |
اسم المورد للقسم الفرعي لمجموعة البيانات الرئيسية. قيمة فارغة لعقدة فلتر مجموعة بيانات الجذر. |
path |
مسار السمات التي تحدِّد فلتر مجموعة البيانات هذا. |
AssetGroupSignal
تُمثِّل AssetGroupSignal إشارة في مجموعة مواد عرض. يؤدي توفُّر إشارة إلى إعلام "حملة الأداء الأفضل" بالمستخدمين الذين يزداد احتمال أن يُجروا إحالة ناجحة. وتستخدِم "حملات الأداء الأفضل" هذه الإشارة للبحث عن مستخدِمين جدد لديهم نيّة شراء مشابهة أو أقوى حتى تتمكّن من العثور على إحالات ناجحة على مستوى "الحملات على شبكة البحث" و"الشبكة الإعلانية" و"حملات الفيديو" وغير ذلك.
الحقول | |
---|---|
resource_name |
اسم المورد لإشارة مجموعة مواد العرض. يكون اسم مورد إشارة مجموعة مواد العرض على النحو التالي:
|
asset_group |
مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه. |
حقل الاتحاد signal إشارة مجموعة مواد العرض. يمكن أن يكون الحقل "signal " واحدًا فقط مما يلي: |
|
audience |
إشارة الجمهور التي ستستخدِمها "حملة الأداء الأفضل" |
AssetGroupTopCombinationView
عرض حول استخدام مجموعة مواد عرض إعلانات المجموعة الإعلانية.
الحقول | |
---|---|
resource_name |
اسم المورد لعرض مجموعة مواد العرض بأعلى مجموعة مواد العرض تكون أسماء موارد عرض مجموعة مواد العرض الأعلى في مجموعة مواد العرض على النحو التالي: `"customers/{customer_id}/assetGroupCombinationViews/{asset_group_id}~{asset_combination_category}" |
asset_group_top_combinations[] |
أفضل مجموعات مواد العرض التي ظهرت معًا. |
AssetSet
مجموعة مواد عرض تمثِّل مجموعة من مواد العرض. استخدِم AssetSetAsset لربط مادة عرض بمجموعة مواد العرض.
الحقول | |
---|---|
id |
رقم تعريف مجموعة مواد العرض. |
resource_name |
اسم المورد لمجموعة مواد العرض. وتكون أسماء موارد مجموعة مواد العرض على النحو التالي:
|
AssetSetAsset
AssetSetAsset هو الرابط بين مادة عرض ومجموعة مواد عرض. تؤدي إضافة AssetSetAsset إلى ربط مادة عرض بمجموعة مواد عرض.
الحقول | |
---|---|
resource_name |
اسم المورد لمادة عرض مجموعة مواد العرض تكون أسماء موارد مواد العرض ضمن مجموعة مواد العرض على النحو التالي:
|
asset_set |
مجموعة مواد العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه. |
asset |
مادة العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه. |
status |
حالة مادة عرض مجموعة مواد العرض. للقراءة فقط |
الجمهور
الجمهور هو خيار استهداف فعّال يتيح لك إجراء تقاطع بين سمات شرائح مختلفة، مثل الخصائص الديمغرافية المفصّلة وشرائح الجمهور ذات الاهتمامات المشتركة، وذلك لإنشاء شرائح جمهور تمثّل أقسامًا من الشرائح المستهدَفة.
الحقول | |
---|---|
resource_name |
اسم المورد للجمهور. وتكون أسماء شرائح الجمهور على النحو التالي:
|
id |
رقم تعريف شريحة الجمهور. |
name |
مطلوبة. اسم الجمهور. يجب أن يكون فريدًا لجميع شرائح الجمهور. يجب أن يبلغ طوله 1 كحد أدنى و255 طولاً كحد أقصى. |
description |
وصف هذا الجمهور. |
BiddingStrategy
استراتيجية عروض الأسعار.
الحقول | |
---|---|
resource_name |
اسم مورد استراتيجية عروض الأسعار. تكون أسماء موارد استراتيجية عروض الأسعار على النحو التالي:
|
status |
حالة استراتيجية عروض الأسعار. هذا الحقل للقراءة فقط. |
type |
نوع استراتيجية عروض الأسعار. أنشِئ استراتيجية عروض أسعار عن طريق إعداد مخطط عروض الأسعار. هذا الحقل للقراءة فقط. |
currency_code |
العملة المستخدمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217). بالنسبة إلى استراتيجيات عروض الأسعار في حسابات العملاء الإدارية، يمكن ضبط هذه العملة عند الإنشاء، ويتم ضبطها تلقائيًا على عملة العميل الإداري. لا يمكن ضبط هذا الحقل لتقديم الخدمات للعملاء، فجميع الاستراتيجيات المتعلقة بالعميل الذي يقدّم الخدمة تستخدم بشكل ضمني عملة العميل الذي يقدّم الخدمة. في جميع الحالات، يعرض الحقل فعالة_currency_code العملة المستخدمة بواسطة الاستراتيجية. |
id |
رقم تعريف استراتيجية عروض الأسعار. |
name |
اسم استراتيجية عروض الأسعار. يجب تسمية جميع استراتيجيات عروض الأسعار ضمن الحساب بشكلٍ فريد. يجب أن يتراوح طول هذه السلسلة بين 1 و255، بشكل شامل، بترميز UTF-8 بايت، (قطع). |
effective_currency_code |
العملة المستخدمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217). بالنسبة إلى استراتيجيات عروض الأسعار في العملاء الإداريين، هذه هي العملة التي حدّدها المعلِن عند إنشاء الاستراتيجية. بالنسبة إلى العملاء الذين يتم تقديم الخدمات لهم، يكون هذا هو currency_code للعميل. يتم تسجيل مقاييس استراتيجية عروض الأسعار بهذه العملة. هذا الحقل للقراءة فقط. |
campaign_count |
عدد الحملات المرفقة باستراتيجية عروض الأسعار هذه. هذا الحقل للقراءة فقط. |
non_removed_campaign_count |
عدد الحملات التي لم تتم إزالتها المرفقة باستراتيجية عروض الأسعار هذه. هذا الحقل للقراءة فقط. |
حقل الاتحاد يمكن ضبط سمة واحدة فقط. يمكن أن يكون الحقل " |
|
enhanced_cpc |
استراتيجية عروض أسعار ترفع عروض أسعار النقرات التي يُرجح أن تؤدي إلى إحالة ناجحة، وتخفض عروض الأسعار للنقرات التي يقل فيها احتمال حدوثها. |
maximize_conversion_value |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك |
maximize_conversions |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك |
target_cpa |
استراتيجية عروض أسعار تعمل على ضبط عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بتكلفة الإجراء المستهدَفة التي تحدّدها. |
target_impression_share |
استراتيجية عروض أسعار يتم تحسينها تلقائيًا لزيادة نسبة مئوية مختارة من مرات الظهور. |
target_outrank_share |
يشير ذلك المصطلح إلى استراتيجية عروض أسعار تحدِّد عروض الأسعار استنادًا إلى الجزء المستهدَف من المزادات التي يجب أن يحصل فيها المعلِن على مرتبة أعلى من منافس معيّن. تم إيقاف العمل بهذا الحقل. وسيتعذّر إنشاء استراتيجية عروض أسعار جديدة في هذا الحقل أو إرفاق استراتيجيات عروض الأسعار مع هذا الحقل بإحدى الحملات. يُسمح بإجراء عمليات التغيير إلى الاستراتيجيات التي تمت تعبئة هذا المخطط لها حاليًا. |
target_roas |
استراتيجية عروض أسعار تساعدك على زيادة الأرباح إلى أقصى حد مع بلوغ متوسط عائد إنفاق إعلاني مستهدَف معيّن. |
target_spend |
استراتيجية عروض أسعار تحدِّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك. |
الحملة
حملة
الحقول | |
---|---|
resource_name |
اسم مورد الحملة. وتكون أسماء موارد الحملات على النحو التالي:
|
status |
حالة الحملة. عند إضافة حملة جديدة، يتم ضبط الحالة على "مفعَّل" بشكلٍ تلقائي. |
serving_status |
حالة عرض الإعلانات للحملة |
bidding_strategy_system_status |
حالة النظام لاستراتيجية عروض الأسعار للحملة. |
ad_serving_optimization_status |
حالة تحسين عرض الإعلانات للحملة |
advertising_channel_type |
استهداف العرض الأساسي للإعلانات داخل الحملة. يمكن تحسين خيارات الاستهداف في هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل. |
advertising_channel_sub_type |
تحسين اختياري لـ لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير هذا الحقل. |
url_custom_parameters[] |
قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصَّصة في |
real_time_bidding_setting |
إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدف شبكة Ad Exchange. |
network_settings |
إعدادات الشبكة للحملة |
dynamic_search_ads_setting |
إعداد التحكّم في الإعلانات الديناميكية على شبكة البحث (DSA). |
shopping_setting |
إعداد التحكّم في حملات التسوّق. |
geo_target_type_setting |
إعداد الاستهداف الجغرافي للإعلانات. |
labels[] |
أسماء موارد التصنيفات المرفقة بهذه الحملة. |
bidding_strategy_type |
نوع استراتيجية عروض الأسعار. يمكن إنشاء استراتيجية عروض أسعار من خلال ضبط مخطط عروض الأسعار لإنشاء استراتيجية عروض أسعار عادية أو الحقل هذا الحقل للقراءة فقط. |
accessible_bidding_strategy |
اسم مورّد Accessible BiddingStrategy (استراتيجية عروض الأسعار للوصول فقط)، وهو إعداد للقراءة فقط للسمات غير المشروطة لاستراتيجية المحفظة لعروض الأسعار المرفقة التي تم تحديدها من خلال " Bidding_strategy". هذا الحقل فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة. تتوفّر سمات الاستراتيجية غير المحدودة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويمكن الاطّلاع عليها من مرجع Accessible BiddingStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا للعميل مالك الاستراتيجية ومدرائه. لا يمكن قراءة السمات المحظورة إلا من مورد BiddingStrategy. |
frequency_caps[] |
قائمة تحدّ من عدد مرات مشاهدة كل مستخدم لإعلانات هذه الحملة. |
selective_optimization |
إعداد تحسين انتقائي لهذه الحملة، يتضمّن مجموعة من إجراءات الإحالات الناجحة لتحسين هذه الحملة لتحقيقها. لا تنطبق هذه الميزة إلا على حملات التطبيقات التي تستخدم MULTI_CHANNEL ضمن النوع AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT مثل AdvertisingChannelSubType. |
optimization_goal_setting |
إعداد أهداف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين. |
tracking_setting |
إعدادات على مستوى الحملة لتتبُّع المعلومات. |
engine_id |
رقم تعريف الحملة في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan أو Microsoft أو Baidu أو غير ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "campaign.id" بدلاً من ذلك. |
excluded_parent_asset_field_types[] |
أنواع حقول مواد العرض التي يجب استبعادها من هذه الحملة. لن تكتسب هذه الحملة روابط مواد العرض مع أنواع الحقول هذه من المستوى الأعلى. |
create_time |
الطابع الزمني عند إنشاء هذه الحملة. يظهر الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". وسيتم إيقاف create_time نهائيًا في الإصدار 1. استخدِم وقت الإنشاء بدلاً من ذلك. |
creation_time |
الطابع الزمني عند إنشاء هذه الحملة. يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
last_modified_time |
تاريخ آخر تعديل لهذه الحملة. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
id |
رقم تعريف الحملة. |
name |
اسم الحملة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. ويجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 0xA) أو أحرف الرجوع إلى أول السطر (رمز النقطة 0xD). |
tracking_url_template |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. |
campaign_budget |
ميزانية الحملة. |
start_date |
تاريخ بدء الحملة في عرض المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD. |
end_date |
اليوم الأخير من الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD. وعند إنشاء الحملة، يتم ضبطها تلقائيًا على 2037-12-30، ما يعني أنّه سيتم عرض الحملة إلى أجل غير مسمى. لضبط حملة حالية من أجل عرضها إلى أجل غير مسمى، اضبط هذا الحقل على 2037-12-30. |
final_url_suffix |
اللاحقة المستخدمة لإلحاق مَعلمات طلب البحث بالصفحات المقصودة التي يتم عرضها مع التتبّع الموازي. |
url_expansion_opt_out |
يمثِّل إيقاف توسيع عنوان URL ليشمل عناوين URL أكثر استهدافًا. في حال إيقاف هذه الميزة (صحيح)، سيتم استهداف عناوين URL النهائية فقط في مجموعة مواد العرض أو عناوين URL المحدَّدة في خلاصات بيانات النشاط التجاري أو Google Merchant Center للمعلِن. في حال الموافقة (خطأ)، سيتم استهداف النطاق بالكامل. لا يمكن ضبط هذا الحقل إلّا لـ "حملات الأداء الأفضل"، حيث تكون القيمة التلقائية "خطأ". |
حقل الاتحاد يجب أن تكون محفظة (تم إنشاؤها من خلال خدمة BiddingStrategy) أو محفظة عادية مضمّنة في الحملة. يمكن أن يكون الحقل " |
|
bidding_strategy |
استراتيجية المحفظة لعروض الأسعار التي تستخدمها الحملة. |
manual_cpa |
الإستراتيجية القياسية لعروض أسعار الإجراء اليدوية. استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدِّده المعلِن. لا تتوفّر هذه الميزة إلا لحملات "الخدمات المحلّية". |
manual_cpc |
الإستراتيجية القياسية لعروض أسعار النقرة اليدوية. عروض الأسعار اليدوية المستندة إلى النقرات والتي يدفع فيها المستخدم مقابل كل نقرة |
manual_cpm |
هي استراتيجية قياسية لعروض الأسعار اليدوية لكل ألف ظهور. عروض الأسعار اليدوية المستندة إلى مرات الظهور والتي يدفع فيها المستخدم مقابل كل ألف ظهور |
maximize_conversions |
استراتيجية عروض أسعار "تحقيق الحد الأقصى من الإحالات الناجحة" العادية التي تعمل تلقائيًا على زيادة عدد الإحالات الناجحة إلى أقصى حد مع إنفاق ميزانيتك |
maximize_conversion_value |
الاستراتيجية العادية لعروض أسعار "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" التي تضبط عروض الأسعار تلقائيًا لتحقيق الحد الأقصى من الأرباح في حدود ميزانيتك |
target_cpa |
هي الاستراتيجية العادية لعروض الأسعار المستهدفة للإجراء، والتي تحدِّد عروض الأسعار تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها. |
target_impression_share |
استراتيجية عروض أسعار "نسبة ظهور الإعلان المستهدَفة". يشير ذلك المصطلح إلى استراتيجية عروض أسعار مبرمَجة تعمل على ضبط عروض الأسعار لتحقيق نسبة محدَّدة من مرات الظهور. |
target_roas |
استراتيجية عروض أسعار "عائد الإنفاق الإعلاني المستهدف" العادية التي تعمل تلقائيًا على زيادة الأرباح إلى أقصى حد تلقائيًا مع تحقيق متوسط عائد إنفاق إعلاني مستهدَف معيّن |
target_spend |
استراتيجية عروض أسعار "الإنفاق الهدف" العادية التي تُحدِّد عروض أسعارك تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك. |
percent_cpc |
استراتيجية عروض أسعار النسبة المئوية العادية لتكلفة النقرة حيث تكون عروض الأسعار جزءًا من السعر المُعلَن عنه لبعض السلع أو الخدمات. |
target_cpm |
استراتيجية عروض أسعار تعمل على تحسين التكلفة لكل ألف ظهور تلقائيًا. |
DynamicSearchAdsSetting
إعداد التحكّم في الإعلانات الديناميكية على شبكة البحث (DSA).
الحقول | |
---|---|
domain_name |
مطلوبة. اسم نطاق الإنترنت الذي يمثله هذا الإعداد، على سبيل المثال، "google.com" أو "www.google.com". |
language_code |
مطلوبة. رمز اللغة الذي يحدّد لغة النطاق، على سبيل المثال، "en". |
use_supplied_urls_only |
ما إذا كانت الحملة تستخدم عناوين URL المقدّمة من المعلن حصريًا. |
GeoTargetTypeSetting
يمثّل مجموعة من الإعدادات ذات الصلة بالاستهداف الجغرافي للإعلانات.
الحقول | |
---|---|
positive_geo_target_type |
الإعداد المستخدَم للاستهداف الجغرافي الإيجابي في هذه الحملة تحديدًا. |
negative_geo_target_type |
الإعداد المستخدَم للاستهداف الجغرافي السلبي في هذه الحملة بالتحديد. |
NetworkSettings
إعدادات الشبكة للحملة
الحقول | |
---|---|
target_google_search |
ما إذا كان سيتم عرض الإعلانات مع نتائج بحث google.com أم لا |
target_search_network |
ما إذا كان سيتم عرض الإعلانات على مواقع الشركاء في شبكة بحث Google (يتطلب ذلك |
target_content_network |
ما إذا كان سيتم عرض الإعلانات في مواضع محدّدة على شبكة Google الإعلانية. ويتم تحديد مواضع الإعلانات باستخدام معيار موضع الإعلان. |
target_partner_search_network |
ما إذا كان سيتم عرض الإعلانات على شبكة شركاء Google أم لا. ولا تتوفّر هذه الميزة إلا لبعض حسابات شركاء Google المختارة. |
OptimizationGoalSetting
إعداد أهداف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين.
الحقول | |
---|---|
optimization_goal_types[] |
قائمة أنواع أهداف التحسين |
SelectiveOptimization
إعداد تحسين انتقائي لهذه الحملة، يتضمّن مجموعة من إجراءات الإحالات الناجحة لتحسين هذه الحملة لتحقيقها. لا تنطبق هذه الميزة إلا على حملات التطبيقات التي تستخدم MULTI_CHANNEL ضمن النوع AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT مثل AdvertisingChannelSubType.
الحقول | |
---|---|
conversion_actions[] |
المجموعة المختارة من إجراءات الإحالات الناجحة لتحسين هذه الحملة. |
ShoppingSetting
إعداد حملات التسوّق. تحدد هذه السمة مجموعة المنتجات التي يمكن الإعلان عنها من خلال الحملة، وكيفية تفاعل هذه الحملة مع "حملات Shopping" الأخرى.
الحقول | |
---|---|
feed_label |
تصنيف خلاصة المنتجات المطلوب تضمينها في الحملة يمكن ضبط سمة واحدة فقط من feed_label أو sales_country. وفي حال استخدامه بدلاً من sales_country، سيقبل حقل Feed_label رموز البلدان بالتنسيق نفسه، على سبيل المثال: "XX". ويمكن أيضًا أن يكون أيّ سلسلة مستخدَمة لتصنيف الخلاصة في Google Merchant Center. |
use_vehicle_inventory |
لتحديد ما إذا كنت تريد استهداف مستودع بيانات المركبات |
merchant_id |
رقم تعريف حساب Merchant Center. هذا الحقل مطلوب لإنشاء عمليات. هذا الحقل غير قابل للتغيير في "حملات Shopping". |
sales_country |
بلد مبيعات المنتجات المطلوب تضمينها في الحملة |
campaign_priority |
أولوية الحملة. الحملات ذات الأولويات الأعلى عدديًا لها الأولوية على تلك ذات الأولويات الأقل. هذا الحقل مطلوب لحملات التسوّق، ذات القيم بين 0 و2، بشكل شامل. هذا الحقل اختياري لحملات Shopping الذكية، ولكن يجب أن يساوي 3 في حال ضبطه. |
enable_local |
لتحديد ما إذا كان يجب تضمين المنتجات المحلية. |
TrackingSetting
إعدادات على مستوى الحملة لتتبُّع المعلومات.
الحقول | |
---|---|
tracking_url |
عنوان URL المستخدَم للتتبّع الديناميكي. |
CampaignAsset
تمثّل هذه السمة رابطًا بين حملة ومادة عرض.
الحقول | |
---|---|
resource_name |
اسم المورد لمادة عرض الحملة. تكون أسماء موارد CampaignAsset على النحو التالي:
|
status |
حالة مادة عرض الحملة. |
campaign |
الحملة التي ترتبط بها مادة العرض. |
asset |
مادة العرض المرتبطة بالحملة. |
CampaignAssetSet
CampaignAssetSet هو الرابط بين حملة ومجموعة مواد عرض. تعمل إضافة CampaignAssetSet على ربط مجموعة مواد عرض بإحدى الحملات.
الحقول | |
---|---|
resource_name |
اسم المورد لمجموعة مواد العرض للحملة تكون أسماء موارد مواد العرض ضمن مجموعة مواد العرض على النحو التالي:
|
campaign |
الحملة التي ترتبط بها مجموعة مواد العرض هذه. |
asset_set |
مجموعة مواد العرض المرتبطة بالحملة. |
status |
حالة مادة عرض مجموعة مواد العرض للحملة. للقراءة فقط |
CampaignAudienceView
طريقة عرض الجمهور للحملة يتضمن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على الشبكة الإعلانية وشبكة YouTube، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (قوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث)، المجمّعة حسب معيار الحملة والجمهور. لا تتضمّن طريقة العرض هذه سوى شرائح الجمهور المرفقة على مستوى الحملة.
الحقول | |
---|---|
resource_name |
اسم المورد لطريقة عرض جمهور الحملة. تكون أسماء مراجع مشاهدة الجمهور في الحملة على النحو التالي:
|
CampaignBudget
ميزانية الحملة.
الحقول | |
---|---|
resource_name |
اسم مورد ميزانية الحملة. تكون أسماء موارد ميزانية الحملة على النحو التالي:
|
delivery_method |
طريقة العرض التي تحدِّد معدّل إنفاق ميزانية الحملة. يتم ضبط السياسة تلقائيًا على STANDARD في حال عدم تحديدها في عملية إنشاء. |
period |
الفترة التي سيتم إنفاق الميزانية خلالها. ويتم ضبط السياسة تلقائيًا على "يومي" إذا لم يتم تحديدها. |
amount_micros |
مبلغ الميزانية بالعملة المحلية للحساب. ويتم تحديد المبلغ بالمايكرو، حيث يعادل المليون وحدة عملة واحدة. ويبلغ الحد الأقصى للإنفاق الشهري 30.4 ضِعف هذا المبلغ. |
CampaignCriterion
معيار حملة.
الحقول | |
---|---|
resource_name |
اسم المورد لمعيار الحملة. تكون أسماء موارد معايير الحملة على النحو التالي:
|
display_name |
الاسم المعروض للمعيار. يتم تجاهل هذا الحقل لعمليات التبديل. |
type |
نوع المعيار. |
status |
حالة المعيار. |
last_modified_time |
التاريخ والوقت لآخر تعديل لمعيار الحملة هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
criterion_id |
رقم تعريف المعيار. يتم تجاهل هذا الحقل أثناء عملية التبديل. |
bid_modifier |
معدِّل عروض الأسعار عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات. استخدِم 0 لإيقاف نوع جهاز. |
negative |
تحديد ما إذا كان سيتم استهداف ( |
حقل الاتحاد يجب ضبط واحد بالضبط. يمكن أن يكون الحقل " |
|
keyword |
الكلمة الرئيسية. |
location |
الموقع الجغرافي. |
device |
الجهاز. |
age_range |
الفئة العمرية. |
gender |
الجنس. |
user_list |
قائمة المستخدمين. |
language |
اللغة |
webpage |
صفحة ويب |
location_group |
مجموعة المواقع الجغرافية |
CampaignLabel
تمثل هذه السمة علاقة بين الحملة والتصنيف.
الحقول | |
---|---|
resource_name |
اسم المورد تكون أسماء موارد تصنيف الحملة على النحو التالي: |
campaign |
الحملة التي تم إرفاق التصنيف بها. |
label |
التصنيف المعيَّن للحملة. |
CartDataSalesView
عرض المبيعات في بيانات سلة التسوّق
الحقول | |
---|---|
resource_name |
اسم المورد لعرض المبيعات في بيانات سلة التسوّق تكون أسماء مراجع المبيعات في بيانات سلة التسوّق على النحو التالي: |
الإحالة الناجحة
إحالة ناجحة.
الحقول | |
---|---|
resource_name |
اسم مورد الإحالة الناجحة. وتكون أسماء موارد الإحالات الناجحة على النحو التالي:
|
id |
رقم تعريف الإحالة الناجحة |
criterion_id |
رقم تعريف معيار "إعلانات شبكة البحث 360". تشير القيمة 0 إلى أنّ المعيار غير مرتبط. |
merchant_id |
رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360". |
ad_id |
الرقم التعريفي للإعلان. تشير القيمة 0 إلى أنّه لم يتم تحديد مصدر الإعلان. |
click_id |
سلسلة فريدة للزيارة التي تُنسب إليها الإحالة الناجحة، يتم تمريرها إلى الصفحة المقصودة باعتبارها مَعلمة عنوان URL لمعرّف النقرة. |
visit_id |
رقم تعريف زيارة "إعلانات شبكة البحث 360" الذي يُنسب إليه الإحالة الناجحة. |
advertiser_conversion_id |
بالنسبة إلى الإحالات الناجحة بلا إنترنت، يمثّل هذا النوع المعرّف الذي يقدّمه المعلِنون. إذا لم يحدِّد المعلِن رقم تعريف من هذا النوع، تُنشئ "إعلانات شبكة البحث 360" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، تساوي هذه القيمة عمود "id" (رقم التعريف) أو عمود Floodlight_order_id استنادًا إلى تعليمات المعلِن على Floodlight. |
product_id |
رقم تعريف المنتج الذي تم النقر عليه. |
product_channel |
قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو محلي |
product_language_code |
اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center وتحتوي على بيانات حول المنتج. |
product_store_id |
المتجر في إعلان المنتجات داخل المتجر الذي تم النقر عليه. ويجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. |
product_country_code |
البلد (بالتنسيق ISO-3166) المسجَّل في خلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه. |
attribution_type |
ما تُنسب إليه الإحالة الناجحة: زيارة أو الكلمة الرئيسية+الإعلان. |
conversion_date_time |
الطابع الزمني لحدث الإحالة الناجحة. |
conversion_last_modified_date_time |
الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة. |
conversion_visit_date_time |
الطابع الزمني للزيارة التي تُنسب إليها الإحالة الناجحة. |
conversion_quantity |
كمية السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده المَعلمة qty لعنوان URL. المعلِن مسؤول عن تعبئة المَعلمة ديناميكيًا (مثل عدد السلع المُباعة في الإحالة الناجحة)، وبخلاف ذلك، يتم ضبطها تلقائيًا على 1. |
conversion_revenue_micros |
الأرباح المعدَّلة بوحدات المايكرو لحدث الإحالة الناجحة. وستكون دائمًا بعملة حساب عرض الإعلانات. |
floodlight_original_revenue |
الأرباح الأصلية التي لم تتغيّر والمرتبطة بحدث Floodlight (بعملة التقرير الحالي)، قبل تعديل تعليمات عملة Floodlight |
floodlight_order_id |
مُعرّف طلب Floodlight الذي قدّمه المعلِن للإحالة الناجحة. |
status |
حالة الإحالة الناجحة، إما "مفعّلة" أو "تمّت إزالتها". |
asset_id |
رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الإحالة الناجحة. |
asset_field_type |
نوع حقل مادة العرض لحدث الإحالة الناجحة. |
ConversionAction
إجراء إحالة ناجحة
الحقول | |
---|---|
resource_name |
اسم المورد لإجراء الإحالة الناجحة. تكون أسماء موارد إجراءات الإحالة الناجحة على النحو التالي:
|
creation_time |
الطابع الزمني لإنشاء نشاط Floodlight، والمنسق وفقًا لمعيار ISO 8601 |
status |
حالة إجراء الإحالة الناجحة هذا لتجميع حدث الإحالة الناجحة. |
type |
نوع إجراء الإحالة الناجحة هذا |
category |
فئة الإحالات الناجحة التي تم الإبلاغ عنها لإجراء الإحالة الناجحة هذا. |
value_settings |
الإعدادات ذات الصلة بقيمة أحداث الإحالة الناجحة المرتبطة بإجراء الإحالة الناجحة هذا. |
attribution_model_settings |
الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا |
floodlight_settings |
إعدادات Floodlight لأنواع الإحالات الناجحة في Floodlight |
id |
رقم تعريف إجراء الإحالة الناجحة. |
name |
اسم إجراء الإحالة الناجحة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء إجراءات إحالات ناجحة جديدة. |
primary_for_goal |
إذا كانت وحدة البت الأساسية_for_goal لإجراء الإحالة الناجحة غير صحيحة، لا يمكن تقديم عروض أسعار لإجراء الإحالة الناجحة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. وفي المقابل، لا تراعي أهداف الإحالات الناجحة المخصّصة Primary_for_goal، لذا إذا كانت إحدى الحملات تحتوي على هدف إحالة ناجحة مخصّص تمّ إعداده باستخدام إجراء إحالة ناجحة أساسي =primary_for_goal = خطأ، سيظل بالإمكان تقديم عروض أسعار لإجراء الإحالة الناجحة هذا. وبشكلٍ تلقائي، ستكونPrimary_for_goal صحيحة في حال عدم ضبطها. في الإصدار V9، لا يمكن ضبط حقل "Primary_for_goal" على القيمة "خطأ" إلا بعد إنشاء عملية "تعديل" لأنّه لم يتم تعريفها بأنّها اختيارية. |
owner_customer |
اسم المورد للعميل مالك إجراء الإحالة الناجحة، أو قيمة فارغة إذا كان هذا إجراء إحالة ناجحة من تحديد النظام. |
include_in_client_account_conversions_metric |
ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في المقياس "client_account_conversions" |
include_in_conversions_metric |
ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "الإحالات الناجحة" |
click_through_lookback_window_days |
الحدّ الأقصى لعدد الأيام التي قد تنقضي بين تفاعل (على سبيل المثال، نقرة) وحدث إحالة ناجحة. |
app_id |
رقم تعريف التطبيق لإجراء إحالة ناجحة خاص بالتطبيق. |
AttributionModelSettings
الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا
الحقول | |
---|---|
attribution_model |
نوع نموذج تحديد المصدر لإجراء الإحالة الناجحة هذا |
data_driven_model_status |
حالة نموذج تحديد المصدر بالاستناد إلى البيانات لإجراء الإحالة الناجحة. |
FloodlightSettings
الإعدادات ذات الصلة بإجراء إحالة ناجحة في Floodlight
الحقول | |
---|---|
activity_group_tag |
سلسلة تُستخدَم لتحديد مجموعة أنشطة Floodlight عند إعداد تقارير عن الإحالات الناجحة. |
activity_tag |
سلسلة تُستخدَم لتحديد نشاط Floodlight عند إعداد تقارير عن الإحالات الناجحة. |
activity_id |
رقم تعريف نشاط Floodlight في DoubleClick Campaign Manager |
ValueSettings
الإعدادات ذات الصلة بقيمة أحداث الإحالة الناجحة المرتبطة بإجراء الإحالة الناجحة هذا.
الحقول | |
---|---|
default_value |
القيمة المطلوب استخدامها عند إرسال أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا بقيمة غير صالحة أو غير مسموح بها أو غير متوفّرة، أو عند ضبط إجراء الإحالة الناجحة هذا لاستخدام القيمة التلقائية دائمًا. |
default_currency_code |
رمز العملة الذي سيتم استخدامه عند إرسال أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا برمز عملة غير صالح أو مفقود، أو عند إعداد إجراء الإحالة الناجحة هذا لاستخدام القيمة التلقائية دائمًا. |
always_use_default_value |
تتحكّم هذه السياسة في ما إذا كان يتم استخدام القيمة التلقائية ورمز العملة التلقائي بدلاً من القيمة ورمز العملة المحدّدَين في أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا. |
ConversionCustomVariable
متغير مخصَّص للإحالة الناجحة. اطّلِع على "لمحة عن مقاييس Floodlight المخصّصة والسمات في التجربة الجديدة من "إعلانات شبكة البحث 360" على الرابط https://support.google.com/sa360/answer/13567857.
الحقول | |
---|---|
resource_name |
اسم المورد للمتغيّر المخصّص للإحالة الناجحة تكون أسماء موارد المتغيّرات المخصّصة للإحالات الناجحة على النحو التالي:
|
id |
رقم تعريف المتغيّر المخصَّص للإحالة الناجحة. |
name |
مطلوبة. اسم المتغيّر المخصَّص للإحالة الناجحة. يجب أن يكون الاسم فريدًا. يجب ألا يزيد عدد أحرف الاسم عن 100 حرف. يجب ألا تكون هناك أي مسافات إضافية قبل الاسم وبعده. |
tag |
مطلوبة. علامة المتغيّر المخصَّص للإحالة الناجحة يجب أن تكون العلامة فريدة وتتألف من حرف "u" متبوعًا مباشرةً برقم أقل من أو يساوي 100. على سبيل المثال: "u4". |
status |
حالة المتغيّر المخصَّص للإحالة الناجحة لتجميع حدث الإحالة الناجحة |
owner_customer |
اسم المورد للعميل الذي يملك المتغيّر المخصّص للإحالة الناجحة |
family |
عائلة المتغيّر المخصَّص للإحالة الناجحة |
cardinality |
عدد القيم الفريدة للمتغيّر المخصّص للإحالة الناجحة |
floodlight_conversion_custom_variable_info |
حقول المتغيّرات المخصَّصة للإحالات الناجحة على Floodlight في "إعلانات شبكة البحث 360" |
custom_column_ids[] |
أرقام تعريف الأعمدة المخصّصة التي تستخدِم هذا المتغيّر المخصّص للإحالة الناجحة. |
FloodlightConversionCustomVariableInfo
معلومات عن المتغيّرات المخصّصة للإحالات الناجحة في Floodlight في "إعلانات شبكة البحث 360".
الحقول | |
---|---|
floodlight_variable_type |
نوع متغيّر Floodlight المحدّد في "إعلانات شبكة البحث 360". |
floodlight_variable_data_type |
نوع بيانات متغيّر Floodlight المحدّد في "إعلانات شبكة البحث 360". |
ConversionTrackingSetting
مجموعة من الإعدادات على مستوى العميل ذات الصلة بتتبُّع الإحالات الناجحة في "إعلانات شبكة البحث 360".
الحقول | |
---|---|
accepted_customer_data_terms |
ما إذا كان العميل قد وافق على بنود بيانات العملاء وفي حال استخدام تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/adspolicy/answer/7475709. |
conversion_tracking_status |
حالة تتبُّع الإحالات الناجحة. ويشير إلى ما إذا كان العميل يستخدم تتبُّع الإحالات الناجحة، وهو مالك تتبُّع الإحالات الناجحة لهذا العميل. إذا كان هذا العميل يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ستختلف القيمة المعروضة بناءً على |
enhanced_conversions_for_leads_enabled |
ما إذا كان العميل قد فعّل ميزة الإحالات الناجحة المحسّنة للعملاء المحتملين وفي حال استخدام تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. |
google_ads_conversion_customer |
اسم المورد للعميل حيث يتم إنشاء الإحالات الناجحة وإدارتها. هذا الحقل للقراءة فقط. |
conversion_tracking_id |
رقم تعريف تتبُّع الإحالات الناجحة المستخدَم لهذا الحساب. لا يشير هذا الرقم التعريفي إلى ما إذا كان العميل يستخدم تتبع الإحالة الناجحة (conversion_tracking_status). هذا الحقل للقراءة فقط. |
google_ads_cross_account_conversion_tracking_id |
رقم تعريف تتبُّع الإحالات الناجحة لمدير العميل. يتم ضبط ذلك عند تفعيل العميل لميزة "تتبُّع الإحالات الناجحة"، ويؤدي ذلك إلى إلغاء conversion_tracking_id. لا يمكن إدارة هذا الحقل إلّا من خلال واجهة مستخدِم "إعلانات Google". هذا الحقل للقراءة فقط. |
cross_account_conversion_tracking_id |
رقم تعريف تتبُّع الإحالات الناجحة لمدير العميل. يتم ضبط هذه الميزة عند تفعيل العميل لميزة "تتبُّع الإحالات الناجحة في جميع الحسابات"، وتلغي هذه العملية قيمة conversion_tracking_id. |
CustomColumn
عمود مخصّص: اطّلِع على العمود المخصّص في "إعلانات شبكة البحث 360" على https://support.google.com/sa360/answer/9633916.
الحقول | |
---|---|
resource_name |
اسم مورد العمود المخصّص. وتكون أسماء موارد الأعمدة المخصّصة على النحو التالي:
|
id |
رقم تعريف العمود المخصّص. |
name |
اسم العمود المخصّص الذي يحدّده المستخدم. |
description |
وصف من تحديد المستخدم للعمود المخصّص. |
value_type |
نوع قيمة النتيجة للعمود المخصّص. |
references_attributes |
صحيح عندما يشير العمود المخصّص إلى سمة واحدة أو أكثر. |
references_metrics |
صحيح عندما يشير العمود المخصّص إلى مقياس واحد أو أكثر. |
queryable |
صحيح عندما يكون العمود المخصّص متاحًا للاستخدام في طلب بحث SearchAds360Service.Search وSearchAds360Service.SearchStream. |
referenced_system_columns[] |
قائمة أعمدة النظام المُشار إليها في هذا العمود المخصّص. على سبيل المثال، أشار عمود مخصّص "مجموع مرّات الظهور والنقرات" إلى أعمدة النظام {"metrics.clicks", "metrics.impression"}. |
العميل
عميل.
الحقول | |
---|---|
resource_name |
اسم مورد العميل. تكون أسماء موارد العملاء على النحو التالي:
|
conversion_tracking_setting |
إعداد تتبُّع الإحالات الناجحة للعميل. |
account_type |
نوع حساب محرّك البحث، مثل "إعلانات Google" أو Microsoft Advertising أو Yahoo Japan أو Baidu أو Facebook أو Engine Track أو غير ذلك |
double_click_campaign_manager_setting |
إعداد DoubleClick Campaign Manager لعميل إداري. |
account_status |
حالة الحساب، على سبيل المثال، مفعَّل أو متوقف مؤقتًا أو مُزالة وما إلى ذلك. |
last_modified_time |
التاريخ والوقت الذي تم فيه إجراء آخر تعديل لهذا العميل يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
engine_id |
رقم تعريف الحساب في حساب محرّك البحث الخارجي |
status |
حالة العميل. |
creation_time |
الطابع الزمني عند إنشاء هذا العميل يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
id |
رقم تعريف العميل. |
descriptive_name |
اسم وصفي اختياري وغير فريد للعميل |
currency_code |
العملة التي يعمل بها الحساب. ويمكن استخدام مجموعة فرعية من رموز العملات وفقًا لمعيار ISO 4217. |
time_zone |
رقم تعريف المنطقة الزمنية المحلية للعميل |
tracking_url_template |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع باستخدام المَعلمات |
final_url_suffix |
نموذج عنوان URL لإلحاق المَعلمات بعنوان URL النهائي |
auto_tagging_enabled |
ما إذا كان وضع العلامات التلقائي مفعَّلاً للعميل أم لا. |
manager |
ما إذا كان العميل مديرًا. |
CustomerAsset
تمثّل هذه السمة رابطًا بين عميل ومادة عرض.
الحقول | |
---|---|
resource_name |
اسم المورد لمادة عرض العميل. تكون أسماء موارد CustomerAsset على النحو التالي:
|
asset |
مطلوبة. مادة العرض المرتبطة بالعميل. |
status |
حالة مادة عرض العميل. |
CustomerAssetSet
CustomerAssetSet هو الرابط بين عميل ومجموعة مواد عرض. تؤدي إضافة CustomerAssetSet إلى ربط مجموعة مواد عرض بعميل.
الحقول | |
---|---|
resource_name |
اسم المورد لمجموعة مواد العرض الخاصة بالعميل تكون أسماء موارد مواد العرض ضمن مجموعة مواد العرض على النحو التالي:
|
asset_set |
مجموعة مواد العرض المرتبطة بالعميل. |
customer |
العميل الذي ترتبط به مجموعة مواد العرض هذه. |
status |
حالة مادة عرض مجموعة مواد العرض للعميل. للقراءة فقط |
CustomerClient
تمثّل هذه السمة رابطًا بين عميل محدّد وعميل معيّن. يتوفر CustomerClients للعملاء الإداريين فقط. ويتم تضمين جميع العملاء المباشرين وغير المباشرين، بالإضافة إلى المدير نفسه.
الحقول | |
---|---|
resource_name |
اسم المورد للعميل. تكون أسماء موارد CustomerClient على النحو التالي: |
applied_labels[] |
أسماء الموارد للتصنيفات التي يملكها العميل الذي قدّم الطلب والتي يتم تطبيقها على العميل. تكون أسماء موارد التصنيف على النحو التالي:
|
status |
حالة العميل. للقراءة فقط |
client_customer |
اسم المورد للعميل - العميل المرتبط بالعميل المحدّد. للقراءة فقط |
level |
المسافة بين العميل المحدّد والعميل. بالنسبة إلى خيار الربط الذاتي، ستكون قيمة المستوى 0. للقراءة فقط |
time_zone |
تمثيل سلسلة بيانات لغة محلية مشتركة (CLDR) للمنطقة الزمنية للعميل، مثل America/Los_Angeles. للقراءة فقط |
test_account |
تحدِّد ما إذا كان العميل حسابًا تجريبيًا. للقراءة فقط |
manager |
يحدد ما إذا كان العميل مديرًا أم لا. للقراءة فقط |
descriptive_name |
تمثّل هذه السمة الاسم الوصفي للعميل. للقراءة فقط |
currency_code |
رمز العملة (على سبيل المثال، "USD" و"EUR") للعميل. للقراءة فقط |
id |
رقم تعريف العميل. للقراءة فقط |
CustomerManagerLink
يمثل علاقة الربط بين مدير العميل والعميل.
الحقول | |
---|---|
resource_name |
اسم المورد تكون أسماء موارد CustomerManagerLink على النحو التالي: |
status |
حالة الربط بين العميل والمدير. |
manager_customer |
العميل الإداري المرتبط بالعميل. |
manager_link_id |
رقم تعريف رابط مدير العميل. هذا الحقل للقراءة فقط. |
DoubleClickCampaignManagerSetting
إعداد DoubleClick Campaign Manager لعميل إداري.
الحقول | |
---|---|
advertiser_id |
رقم تعريف المعلِن في "مدير الحملة" المرتبط بهذا العميل. |
network_id |
رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا العميل. |
time_zone |
المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بهذا العميل بتنسيق قاعدة بيانات المناطق الزمنية IANA، مثل أمريكا/نيو يورك. |
DynamicSearchAdsSearchTermView
طريقة عرض عبارة بحث للإعلانات الديناميكية على شبكة البحث
الحقول | |
---|---|
resource_name |
اسم المورد لعرض عبارة البحث للإعلانات الديناميكية على شبكة البحث. وتكون أسماء موارد عرض عبارات البحث للإعلانات الديناميكية على شبكة البحث على النحو التالي:
|
landing_page |
عنوان URL للصفحة المقصودة المحدّد ديناميكيًا لمرة الظهور. هذا الحقل للقراءة فقط. |
GenderView
عرض الجنس. يعكس مورد gender_view حالة العرض الفعالة، بدلاً من المعايير التي تمت إضافتها. تظهر مجموعة إعلانية لا تحتوي على معايير الجنس بشكلٍ تلقائي لجميع الأجناس، لذلك تظهر جميع الأجناس في gender_view مع إحصاءات.
الحقول | |
---|---|
resource_name |
اسم المورد لعرض الجنس. تكون أسماء موارد عرض الجنس على النحو التالي:
|
GeoTargetConstant
عدد ثابت للاستهداف الجغرافي.
الحقول | |
---|---|
resource_name |
اسم المورد وثابت الهدف الجغرافي وتكون أسماء الموارد الثابتة للاستهداف الجغرافي على النحو التالي:
|
status |
الحالة الثابتة للاستهداف الجغرافي |
id |
رقم تعريف ثابت الهدف الجغرافي. |
name |
الاستهداف الجغرافي لاسم ثابت باللغة الإنجليزية. |
country_code |
تمثّل هذه السمة رمز البلد وفقًا لمعيار ISO-3166-1 alpha-2 المرتبط بالهدف. |
target_type |
نوع استهداف ثابت للاستهداف الجغرافي |
canonical_name |
تمثّل هذه السمة الاسم باللغة الإنجليزية المؤهل بالكامل، ويتكون من اسم الهدف واسم البلد الأصلي والبلد. |
parent_geo_target |
اسم المورد وثابت الهدف الجغرافي الرئيسي وتكون أسماء الموارد الثابتة للاستهداف الجغرافي على النحو التالي:
|
KeywordView
طريقة عرض الكلمات الرئيسية.
الحقول | |
---|---|
resource_name |
اسم المورد لعرض الكلمات الرئيسية. وتكون أسماء موارد عرض الكلمات الرئيسية على النحو التالي:
|
التصنيف
التصنيف
الحقول | |
---|---|
resource_name |
اسم المورد تكون أسماء موارد التصنيفات على النحو التالي: |
status |
حالة التصنيف. للقراءة فقط |
text_label |
يشير ذلك المصطلح إلى نوع من التصنيفات يعرض نصًا على خلفية ملوّنة. |
id |
رقم تعريف التصنيف. للقراءة فقط |
name |
اسم التصنيف. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء تصنيف جديد. يجب أن يتراوح طول هذه السلسلة بين 1 و80، بشكل شامل. |
LanguageConstant
لغة.
الحقول | |
---|---|
resource_name |
تمثّل هذه السمة اسم المورد الثابت اللغوي. وتكون أسماء موارد اللغة الثابتة على النحو التالي:
|
id |
معرّف ثابت اللغة. |
code |
رمز اللغة، على سبيل المثال، "en_US" و"en_AU" و"es" و"fr" وما إلى ذلك. |
name |
الاسم الكامل للغة الإنجليزية، مثل "الإنجليزية (الولايات المتحدة)" أو "الإسبانية" إلخ. |
targetable |
ما إذا كانت اللغة قابلة للاستهداف أم لا. |
ListingGroupFilterDimension
سمات البيانات لفلتر مجموعة بيانات مجموعة مواد العرض
الحقول | |
---|---|
حقل الاتحاد dimension ويكون أحد السمات الواردة أدناه موجودًا دائمًا. يمكن أن يكون الحقل "dimension " واحدًا فقط مما يلي: |
|
product_bidding_category |
فئة عروض الأسعار لعرض منتج. |
product_brand |
العلامة التجارية لعرض المنتج. |
product_channel |
المنطقة المحلية لعرض المنتج. |
product_condition |
حالة عرض المنتج. |
product_custom_attribute |
السمة المخصّصة لعرض منتج. |
product_item_id |
معرّف السلعة لعرض منتج معيّن. |
product_type |
نوع العرض الترويجي للمنتج. |
ProductBiddingCategory
عنصر واحد في فئة عروض الأسعار على مستوى معيّن وفئات المستوى الأعلى تكون في المستوى 1، وأطفالهم في المستوى 2، وهكذا. نتيح حاليًا استخدام ما يصل إلى 5 مستويات. يجب أن يحدّد المستخدِم نوع سمة يشير إلى مستوى الفئة. يجب أن يكون لكل حالات التقسيم الفرعي نفسه نوع السمة نفسه (مستوى الفئة).
الحقول | |
---|---|
level |
يشير إلى مستوى الفئة في التصنيف. |
id |
رقم تعريف فئة عروض أسعار المنتج. يعادل هذا المعرّف رقم تعريف فئة_المنتجات google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436 |
ProductBrand
العلامة التجارية للمنتج
الحقول | |
---|---|
value |
قيمة السلسلة للعلامة التجارية للمنتج |
ProductChannel
المنطقة المحلية لعرض المنتج.
الحقول | |
---|---|
channel |
قيمة المنطقة المحلية |
ProductCondition
حالة عرض المنتج.
الحقول | |
---|---|
condition |
قيمة الشرط. |
ProductCustomAttribute
السمة المخصّصة لعرض منتج.
الحقول | |
---|---|
index |
يشير إلى فهرس السمة المخصّصة. |
value |
قيمة السلسلة للسمة المخصّصة للمنتج. |
ProductItemId
معرّف السلعة لعرض منتج معيّن.
الحقول | |
---|---|
value |
قيمة المعرّف |
ProductType
نوع العرض الترويجي للمنتج.
الحقول | |
---|---|
level |
تمثّل هذه السمة مستوى النوع. |
value |
قيمة النوع. |
ListingGroupFilterDimensionPath
المسار الذي يحدِّد السمات التي تحدِّد فلتر مجموعة البيانات.
الحقول | |
---|---|
dimensions[] |
المسار الكامل للسمات من خلال العرض الهرمي لفلتر مجموعة البيانات (باستثناء العقدة الجذر) إلى فلتر مجموعة البيانات هذا. |
LocationView
يلخِّص عرض الموقع الجغرافي أداء الحملات حسب معيار الموقع الجغرافي.
الحقول | |
---|---|
resource_name |
اسم المورد لعرض الموقع الجغرافي. تكون أسماء موارد عرض الموقع على النحو التالي:
|
ProductBiddingCategoryConstant
فئة عروض أسعار للمنتجات.
الحقول | |
---|---|
resource_name |
اسم المورد لفئة عروض أسعار المنتج. وتكون أسماء موارد فئات عروض أسعار المنتجات على النحو التالي:
|
level |
مستوى فئة عروض أسعار المنتج. |
status |
حالة فئة عروض أسعار المنتج. |
id |
رقم تعريف فئة عروض أسعار المنتج. يعادل هذا المعرّف رقم تعريف فئة_المنتجات google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436. |
country_code |
رمز بلد مكوّن من حرفَين كبيرَين ضمن فئة عروض أسعار المنتج. |
product_bidding_category_constant_parent |
اسم المورد لفئة عروض أسعار المنتجات الرئيسية |
language_code |
رمز اللغة لفئة عروض أسعار المنتج. |
localized_name |
قيمة الشبكة الإعلانية لفئة عروض أسعار المنتجات المترجَمة حسب Language_code |
ProductGroupView
عرض مجموعة منتجات.
الحقول | |
---|---|
resource_name |
اسم المورد لعرض مجموعة المنتجات. تكون أسماء الموارد المعروضة لمجموعة المنتجات على النحو التالي:
|
SearchAds360Field
حقل أو مورد (أداة) يتم استخدامه في SearchAds360Service.
الحقول | |
---|---|
resource_name |
اسم مورد العنصر. تكون أسماء موارد العناصر على النحو التالي:
|
category |
فئة العنصر. |
selectable_with[] |
أسماء جميع الموارد والشرائح والمقاييس التي يمكن اختيارها باستخدام العنصر الموصوف. |
attribute_resources[] |
أسماء جميع الموارد التي يمكن اختيارها مع العنصر الموصوف ولا تؤدي الحقول من هذه الموارد إلى تقسيم المقاييس عند تضمينها في طلبات البحث. يتم ضبط هذا الحقل فقط للعناصر التي تكون فئتها هي "Resource" (الموارد). |
metrics[] |
يسرد هذا الحقل أسماء جميع المقاييس القابلة للاختيار مع العنصر الموصوف عند استخدامه في عبارة FROM. ويتم تعيينه فقط للعناصر التي تكون فئتها هي "Resource" (الموارد). |
segments[] |
يسرد هذا الحقل أسماء جميع العناصر، سواء كانت قطعة أو موردًا آخر، والتي تقطع المقاييس عند تضمينها في طلبات البحث وعند استخدام العنصر الموصوف في عبارة FROM. ويتم تعيينه فقط للعناصر التي تكون فئتها هي "Resource" (الموارد). |
enum_values[] |
قيم يمكن أن يفترضها العنصر إذا كان حقلاً من النوع ENUM. يتم تعيين هذا الحقل فقط للعناصر من الفئة SEGMENT أو ATTRIBUTE. |
data_type |
يحدد هذا الحقل العوامل التي يمكن استخدامها مع العنصر في عبارات WHERE. |
name |
اسم العنصر. |
selectable |
ما إذا كان يمكن استخدام العنصر في عبارة SELECT في طلبات البحث. |
filterable |
ما إذا كان يمكن استخدام العنصر في عبارة WHERE في استعلامات البحث. |
sortable |
ما إذا كان يمكن استخدام العنصر في عبارة ORDER BY في استعلامات البحث. |
type_url |
تمثّل هذه السمة عنوان URL للنموذج الأوّلي الذي يصف نوع بيانات العنصر. |
is_repeated |
ما إذا كانت عناصر الحقل مكرّرة أم لا. |
ShoppingPerformanceView
عرض أداء التسوّق توفر إحصاءات حملات Shopping مجمّعة على مستويات متعددة لأبعاد المنتج. تجدر الإشارة إلى أنّ قيم سمات المنتج من Merchant Center، مثل العلامة التجارية والفئة والسمات المخصّصة وحالة المنتج ونوع المنتج، ستعكس حالة كل سمة اعتبارًا من التاريخ والوقت اللذين تمّ فيهما تسجيل الحدث المقابل.
الحقول | |
---|---|
resource_name |
اسم المورد لعرض أداء Shopping تكون أسماء مراجع عرض أداء التسوّق على النحو التالي: |
UserList
قائمة مستخدمين هذه قائمة بالمستخدمين الذين قد يستهدفهم العميل.
الحقول | |
---|---|
resource_name |
اسم المورد لقائمة المستخدمين. تكون أسماء موارد قائمة المستخدمين على النحو التالي:
|
type |
نوع هذه القائمة هذا الحقل للقراءة فقط. |
id |
رقم تعريف قائمة المستخدمين. |
name |
اسم قائمة المستخدمين هذه. قد لا يكون اسم قائمة المستخدمين فريدًا، بناءً على access_reason، (على سبيل المثال، إذا access_reason=SHARED). |
انتقال
زيارة.
الحقول | |
---|---|
resource_name |
اسم مورد الزيارة تكون أسماء موارد الزيارات على النحو التالي:
|
id |
رقم تعريف الزيارة. |
criterion_id |
رقم تعريف الكلمة الرئيسية في "إعلانات شبكة البحث 360". تشير القيمة 0 إلى أنّ الكلمة الرئيسية لم يتم تحديد مصدرها. |
merchant_id |
رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360". |
ad_id |
الرقم التعريفي للإعلان. تشير القيمة 0 إلى أنّه لم يتم تحديد مصدر الإعلان. |
click_id |
سلسلة فريدة لكل زيارة يتم تمريرها إلى الصفحة المقصودة على أنّها مَعلمة عنوان URL لمعرّف النقرة. |
visit_date_time |
الطابع الزمني لحدث الزيارة يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
product_id |
رقم تعريف المنتج الذي تم النقر عليه. |
product_channel |
قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو محلي |
product_language_code |
اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center وتحتوي على بيانات حول المنتج. |
product_store_id |
المتجر في إعلان المنتجات داخل المتجر الذي تم النقر عليه. ويجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. |
product_country_code |
البلد (بتنسيق ISO-3166) المسجَّل في خلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه. |
asset_id |
رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الزيارة. |
asset_field_type |
نوع حقل مادة العرض لحدث الزيارة |
WebpageView
طريقة عرض صفحة الويب
الحقول | |
---|---|
resource_name |
اسم المورد لعرض صفحة الويب تكون أسماء موارد عرض صفحة الويب على النحو التالي:
|