Package google.ads.searchads360.v0.resources

الفهرس

• AccessibleBiddingStrategy (رسالة)
• AccessibleBiddingStrategy.MaximizeConversionValue (رسالة)
• AccessibleBiddingStrategy.MaximizeConversions (رسالة)
• AccessibleBiddingStrategy.TargetCpa (رسالة)
• AccessibleBiddingStrategy.TargetImpressionShare (رسالة)
• AccessibleBiddingStrategy.TargetRoas (رسالة)
• AccessibleBiddingStrategy.TargetSpend (رسالة)
• Ad (رسالة)
• AdGroup (رسالة)
• AdGroupAd (رسالة)
• AdGroupAdEffectiveLabel (رسالة)
• AdGroupAdLabel (رسالة)
• AdGroupAsset (رسالة)
• AdGroupAssetSet (رسالة)
• AdGroupAudienceView (رسالة)
• AdGroupBidModifier (رسالة)
• AdGroupCriterion (رسالة)
• AdGroupCriterion.PositionEstimates (رسالة)
• AdGroupCriterion.QualityInfo (رسالة)
• AdGroupCriterionEffectiveLabel (رسالة)
• AdGroupCriterionLabel (رسالة)
• AdGroupEffectiveLabel (رسالة)
• 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 (رسالة)
• CampaignEffectiveLabel (رسالة)
• 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 (رسالة)
• UserLocationView (رسالة)
• Visit (رسالة)
• WebpageView (رسالة)

AccessibleBiddingStrategy

تمثّل هذه السمة طريقة عرض لاستراتيجيات عروض الأسعار التي يملكها العميل ويشاركها معه.

على عكس BiddingStrategy، يتضمّن هذا المرجع استراتيجيات يملكها مديرو العميل ويشاركونها مع هذا العميل، بالإضافة إلى الاستراتيجيات التي يملكها هذا العميل. لا يوفّر هذا المرجع مقاييس ويعرض فقط مجموعة فرعية محدودة من سمات BiddingStrategy.

الحقول
resource_name	string اسم المورد لاستراتيجية عروض الأسعار التي يمكن الوصول إليها. تتّخذ أسماء موارد AccessibleBiddingStrategy الشكل التالي: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 معرّف استراتيجية عروض الأسعار
name	string اسم استراتيجية عروض الأسعار
type	BiddingStrategyType نوع استراتيجية عروض الأسعار.
owner_customer_id	int64 معرّف العميل الذي يملك استراتيجية عروض الأسعار.
owner_descriptive_name	string descriptive_name الخاص بالعميل الذي يملك استراتيجية عروض الأسعار.
حقل الربط scheme نظام عروض الأسعار يمكن ضبط خيار واحد فقط. يمكن أن يكون التعليق scheme إحدى القيم التالية فقط:
maximize_conversion_value	MaximizeConversionValue استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالات الناجحة في حملاتك في حدود ميزانيتك
maximize_conversions	MaximizeConversions استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك.
target_cpa	TargetCpa استراتيجية عروض أسعار تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للاكتساب التي تحدّدها.
target_impression_share	TargetImpressionShare استراتيجية عروض أسعار تعمل تلقائيًا على التحسين لتحقيق نسبة مئوية محدّدة من مرّات الظهور.
target_roas	TargetRoas استراتيجية عروض أسعار تساعدك في تحقيق الحدّ الأقصى من الأرباح مع بلوغ متوسّط عائد إنفاق إعلاني مستهدَف محدّد.
target_spend	TargetSpend استراتيجية عروض أسعار تحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

MaximizeConversionValue

استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالات الناجحة في حملاتك في حدود ميزانيتك

الحقول

target_roas

double خيار "عائد الإنفاق الإعلاني المستهدَف" في حال ضبطها، ستعمل استراتيجية عروض الأسعار على زيادة الأرباح إلى أقصى حدّ مع بلوغ متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدَف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. في حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستسعى استراتيجية عروض الأسعار إلى تحقيق أعلى عائد إنفاق إعلاني ممكن للميزانية.

MaximizeConversions

استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك.

الحقول
target_cpa	int64 خيار "سقف التكلفة المحدّد لكل إجراء" هذا هو متوسط المبلغ الذي تريد إنفاقه مقابل كل عملية اكتساب.
target_cpa_micros	int64 خيار "سقف التكلفة المحدّد لكل إجراء" هذا هو متوسط المبلغ الذي تريد إنفاقه مقابل كل عملية اكتساب.

TargetCpa

استراتيجية عروض أسعار مُبرمَجة تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للاكتساب التي تحدِّدها.

الحقول
target_cpa_micros	int64 متوسط سقف التكلفة المحدّد لكل إجراء يجب أن يكون هذا الاستهداف أكبر من أو يساوي الحدّ الأدنى لوحدة الفوترة استنادًا إلى عملة الحساب.

TargetImpressionShare

استراتيجية عروض أسعار مبرمَجة تحدّد عروض الأسعار لكي تظهر نسبة مئوية معيّنة من الإعلانات على شبكة البحث في أعلى الصفحة الأولى (أو في موقع جغرافي مستهدَف آخر).

الحقول
location	TargetImpressionShareLocation الموقع المستهدَف في صفحة نتائج البحث
location_fraction_micros	int64 النسبة المحدّدة من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدَف بالميكرو. على سبيل المثال، %1 يساوي 10,000.
cpc_bid_ceiling_micros	int64 أعلى عرض سعر للنقرة يُسمح لنظام عروض الأسعار المبرمَجة بتحديده. هذا حقل مطلوب يدخله المعلِن ويحدّد الحدّ الأقصى ويتم تحديده في المواقع الجغرافية الصغيرة المحلية.

TargetRoas

استراتيجية عروض أسعار مبرمَجة تساعدك في زيادة الأرباح إلى أقصى حدّ مع بلوغ متوسط عائد إنفاق إعلاني مستهدَف محدّد.

الحقول
target_roas	double الإيرادات المحدّدة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق

TargetSpend

استراتيجية عروض أسعار مُبرمَجة تحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

الحقول
target_spend_micros (deprecated)	int64 تم إيقاف هذا العنصر نهائيًا. الإنفاق المستهدف الذي يجب الحصول على الحدّ الأقصى من النقرات في إطاره. سيحاول مقدّم عروض الأسعار المستند إلى استراتيجية "الإنفاق المستهدف" إنفاق المبلغ الأصغر من هذه القيمة أو مبلغ الإنفاق المحدود بشكل طبيعي. في حال عدم تحديدها، يتم استخدام الميزانية كاستهداف للإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه بعد الآن. لمزيد من التفاصيل، يُرجى الاطّلاع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpc_bid_ceiling_micros	int64 الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية.

إعلان

إعلان

الحقول
resource_name	string اسم مصدر الإعلان تتّخذ أسماء موارد الإعلانات الشكل التالي: customers/{customer_id}/ads/{ad_id}
final_urls[]	string قائمة بعناوين URL النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان.
final_app_urls[]	FinalAppUrl قائمة بعناوين URL النهائية للتطبيقات التي سيتم استخدامها على الأجهزة الجوّالة إذا كان المستخدم قد ثبّت التطبيق المحدّد.
final_mobile_urls[]	string قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد كل عمليات إعادة التوجيه على مستوى النطاقات للإعلان.
type	AdType نوع الإعلان.
synthetic_content_info	SyntheticContentInfo تمثّل هذه السمة معلومات عن المحتوى الاصطناعي في الإعلان. الإعلانات التي تتضمّن أنواعًا معيّنة من الإعلانات فقط هي المؤهّلة لتلقّي التعديلات باستخدام الحقل synthetic_content_info. قيم AdType المسموح بها: * HTML5_UPLOAD_AD * DYNAMIC_HTML5_AD * IMAGE_AD
id	int64 رقم تعريف الإعلان.
tracking_url_template	string نموذج عنوان URL لإنشاء عنوان URL للتتبّع
final_url_suffix	string اللاحقة التي سيتم استخدامها عند إنشاء عنوان URL نهائي.
display_url	string عنوان URL الذي يظهر في وصف الإعلان لبعض أشكال الإعلانات
name	string اسم الإعلان يُستخدَم هذا المعرّف فقط لتحديد الإعلان. ليس من الضروري أن يكون فريدًا ولا يؤثّر في الإعلان المعروض.
حقل الربط ad_data تفاصيل ذات صلة بنوع الإعلان يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون التعليق ad_data إحدى القيم التالية فقط:
text_ad	SearchAds360TextAdInfo تفاصيل متعلّقة بإعلان نصي
expanded_text_ad	SearchAds360ExpandedTextAdInfo تفاصيل تتعلّق بإعلان نصي موسّع تم إيقاف الإعلانات النصية الموسَّعة نهائيًا. يمكنك استخدام SearchAds360ResponsiveSearchAd كبديل.
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo تفاصيل تتعلّق بـ "إعلان متجاوب على شبكة البحث"
product_ad	SearchAds360ProductAdInfo تفاصيل تتعلّق بإعلان عن منتج
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo تفاصيل تتعلّق بإعلان ديناميكي موسّع على شبكة البحث

المجموعة الإعلانية

مجموعة إعلانية

الحقول
resource_name	string اسم المورد الخاص بالمجموعة الإعلانية. تتّخذ أسماء موارد المجموعات الإعلانية الشكل التالي: customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus حالة المجموعة الإعلانية.
type	AdGroupType نوع المجموعة الإعلانية.
ad_rotation_mode	AdGroupAdRotationMode وضع عرض الإعلانات بالتناوب في المجموعة الإعلانية.
creation_time	string الطابع الزمني لوقت إنشاء هذه المجموعة الإعلانية. يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
targeting_setting	TargetingSetting إعداد لاستهداف الميزات ذات الصلة
labels[]	string أسماء مصادر التصنيفات المرفقة بهذه المجموعة الإعلانية.
effective_labels[]	string أسماء موارد التصنيفات الفعّالة المرفقة بهذه المجموعة الإعلانية. التصنيف الفعّال هو تصنيف موروث أو تمّ تعيينه مباشرةً لهذه المجموعة الإعلانية.
engine_id	string معرّف المجموعة الإعلانية في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لـ "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى عنصر "إعلانات Google"، استخدِم "ad_group.id" بدلاً من ذلك.
start_date	string التاريخ الذي تبدأ فيه هذه المجموعة الإعلانية عرض الإعلانات. تبدأ المجموعة الإعلانية تلقائيًا الآن أو في تاريخ بدء المجموعة الإعلانية، أيهما أبعد. في حال ضبط هذا الحقل، تبدأ المجموعة الإعلانية في بداية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook. التنسيق: YYYY-MM-DD مثال: 2019-03-14
end_date	string التاريخ الذي تتوقف فيه المجموعة الإعلانية عن عرض الإعلانات. بشكلٍ تلقائي، تنتهي المجموعة الإعلانية في تاريخ انتهائها. في حال ضبط هذا الحقل، تنتهي المجموعة الإعلانية في نهاية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook. التنسيق: YYYY-MM-DD مثال: 2019-03-14
language_code	string لغة الإعلانات والكلمات الرئيسية في المجموعة الإعلانية لا يتوفّر هذا الحقل إلا لحسابات Microsoft Advertising. مزيد من التفاصيل: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time	string تمثّل هذه السمة التاريخ والوقت اللذين تم فيهما إجراء آخر تعديل على هذه المجموعة الإعلانية. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
id	int64 رقم تعريف المجموعة الإعلانية.
name	string اسم المجموعة هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء مجموعات إعلانية جديدة. يجب أن يحتوي على أقل من 255 حرفًا من أحرف UTF-8 ذات العرض الكامل. يجب ألا يحتوي على أي أحرف قيمة فارغة (قيمة موضع الرمز 0x0) أو أحرف سطر جديد (قيمة موضع الرمز 0xA) أو أحرف رجوع إلى أول السطر (قيمة موضع الرمز 0xD).
tracking_url_template	string نموذج عنوان URL لإنشاء عنوان URL للتتبّع
cpc_bid_micros	int64 عرض السعر الأقصى للنقرة يُستخدَم هذا الحقل عندما تكون استراتيجية عروض الأسعار الفعّالة للمجموعة الإعلانية هي "تكلفة النقرة اليدوية". لا ينطبق هذا الحقل وسيتم تجاهله إذا كانت حملة المجموعة الإعلانية تستخدم استراتيجية محفظة لعروض الأسعار.
engine_status	AdGroupEngineStatus حالة محرك البحث للمجموعة الإعلانية.
final_url_suffix	string نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي

AdGroupAd

إعلان على مستوى المجموعة الإعلانية

الحقول
resource_name	string اسم مصدر الإعلان تتّخذ أسماء موارد إعلانات المجموعة الإعلانية الشكل التالي: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus حالة الإعلان.
ad	Ad الإعلان
creation_time	string الطابع الزمني لوقت إنشاء هذا الإعلان على مستوى المجموعة الإعلانية. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
labels[]	string أسماء مصادر التصنيفات المرفقة بإعلان المجموعة الإعلانية هذا.
effective_labels[]	string أسماء مصادر التصنيفات السارية المرفقة بهذا الإعلان التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذا الإعلان.
engine_id	string معرّف الإعلان في حساب محرّك البحث الخارجي هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، مثل Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى العناصر غير التابعة لـ "إعلانات شبكة البحث 360"، استخدِم "ad_group_ad.ad.id" بدلاً من ذلك.
engine_status	AdGroupAdEngineStatus الحالة الإضافية للإعلان في حساب محرّك البحث الخارجي تشمل الحالات المحتملة (حسب نوع الحساب الخارجي) "نشط" و"مؤهَّل" و"في انتظار المراجعة" وما إلى ذلك.
last_modified_time	string تمثّل هذه السمة التاريخ والوقت اللذين تم فيهما إجراء آخر تعديل على إعلان المجموعة الإعلانية هذا. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".

AdGroupAdEffectiveLabel

علاقة بين إعلان المجموعة الإعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف موروث أو تمّ تعيينه مباشرةً لإعلان هذه المجموعة الإعلانية.

الحقول
resource_name	string اسم مصدر التصنيف الفعّال لإعلان المجموعة الإعلانية. تتّخذ أسماء موارد تصنيف فعالية إعلانات المجموعة الإعلانية الشكل التالي: customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string إعلان المجموعة الإعلانية الذي تمّ إرفاق التصنيف الفعّال به.
label	string التصنيف الفعّال الذي تمّ تعيينه لإعلان المجموعة الإعلانية.
owner_customer_id	int64 رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupAdLabel

تمثّل هذه السمة علاقة بين إعلان في مجموعة إعلانية وتصنيف.

الحقول
resource_name	string اسم مصدر تصنيف إعلان المجموعة الإعلانية. تتّخذ أسماء موارد تصنيف إعلانات المجموعة الإعلانية الشكل التالي: customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string إعلان المجموعة الإعلانية الذي تمّ إرفاق التصنيف به.
label	string التصنيف الذي تمّ تعيينه لإعلان المجموعة الإعلانية.
owner_customer_id	int64 معرّف العميل الذي يملك التصنيف.

AdGroupAsset

رابط بين مجموعة إعلانية ومادة عرض

الحقول
resource_name	string اسم مصدر مادة عرض المجموعة الإعلانية. تتّخذ أسماء موارد AdGroupAsset الشكل التالي: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string الحقل مطلوب. المجموعة الإعلانية التي ترتبط بها مادة العرض
asset	string الحقل مطلوب. مادة العرض المرتبطة بالمجموعة الإعلانية
status	AssetLinkStatus حالة مادة عرض المجموعة الإعلانية.

AdGroupAssetSet

‫AdGroupAssetSet هي رابطة بين مجموعة إعلانية ومجموعة مواد عرض. يؤدي إنشاء AdGroupAssetSet إلى ربط مجموعة مواد عرض بمجموعة إعلانية.

الحقول
resource_name	string اسم مصدر مجموعة مواد العرض على مستوى المجموعة الإعلانية. تتّخذ أسماء موارد مجموعة مواد العرض على مستوى المجموعة الإعلانية الشكل التالي: customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string المجموعة الإعلانية المرتبطة بمجموعة مواد العرض هذه.
asset_set	string مجموعة مواد العرض المرتبطة بالمجموعة الإعلانية
status	AssetSetLinkStatus حالة مجموعة مواد عرض المجموعة الإعلانية. للقراءة فقط.

AdGroupAudienceView

عرض لشرائح الجمهور على مستوى المجموعة الإعلانية تشمل بيانات الأداء من قوائم الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، والتي يتم تجميعها على مستوى الجمهور.

الحقول
resource_name	string اسم المورد الخاص بطريقة عرض الجمهور على مستوى المجموعة الإعلانية. تتّخذ أسماء موارد "طريقة عرض الجمهور على مستوى المجموعة الإعلانية" الشكل التالي: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

تمثّل هذه السمة معدِّل عروض أسعار المجموعة الإعلانية.

الحقول
resource_name	string اسم المورد لمعدِّل عروض الأسعار على مستوى المجموعة الإعلانية. تتّخذ أسماء موارد معدِّل عروض الأسعار للمجموعة الإعلانية الشكل التالي: customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier	double معدِّل عرض السعر عندما يتطابق المعيار. يجب أن تكون قيمة المعدِّل ضمن النطاق: 0.1 - 10.0. استخدِم 0 لإيقاف نوع الجهاز.
حقل الربط criterion معيار معدِّل عروض الأسعار للمجموعة الإعلانية هذا. مطلوب في عمليات الإنشاء بدءًا من الإصدار 5. يمكن أن يكون التعليق criterion إحدى القيم التالية فقط:
device	DeviceInfo معيار جهاز

AdGroupCriterion

معيار مجموعة إعلانية لا يعرض تقرير ad_group_criterion سوى المعايير التي تمت إضافتها بشكلٍ صريح إلى المجموعة الإعلانية.

الحقول
resource_name	string الاسم المعرِّف لمعيار المجموعة الإعلانية. تتّخذ أسماء موارد معايير المجموعة الإعلانية الشكل التالي: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time	string الطابع الزمني لوقت إنشاء معيار المجموعة الإعلانية هذا. يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
status	AdGroupCriterionStatus تمثّل هذه السمة حالة معيار الاستهداف. هذه هي حالة عنصر معيار المجموعة الإعلانية، ويحدّدها العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان معيار معيّن مؤهّلاً للعرض. في بعض الحالات، قد يستمر ظهور معيار تمت إزالته في واجهة برمجة التطبيقات على أنّه مفعّل في واجهة المستخدم. على سبيل المثال، يتم عرض الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادهم. ستعرض واجهة المستخدم كل فئة عمرية على أنّها "مفعّلة"، لأنّها مؤهَّلة للاطّلاع على الإعلانات، ولكن ستعرض AdGroupCriterion.status القيمة "removed"، لأنّه لم تتم إضافة أي معيار إيجابي.
quality_info	QualityInfo معلومات حول جودة معيار التقييم
type	CriterionType نوع المعيار.
labels[]	string أسماء مصادر التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا.
effective_labels[]	string أسماء مصادر التصنيفات السارية المرفقة بمعيار المجموعة الإعلانية هذا. التصنيف الفعّال هو تصنيف موروث أو تمّ تعيينه مباشرةً لمعيار المجموعة الإعلانية هذا.
position_estimates	PositionEstimates تقديرات لعروض أسعار المعايير في مواضع مختلفة
final_urls[]	string قائمة بعناوين URL النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان.
final_mobile_urls[]	string قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد كل عمليات إعادة التوجيه عبر النطاقات
url_custom_parameters[]	CustomParameter قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصّصة في tracking_url_template أو final_urls أو mobile_final_urls
engine_id	string معرّف معيار المجموعة الإعلانية في حساب محرّك البحث الخارجي. هذا الحقل مخصّص للحسابات غير التابعة لـ "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى عنصر "إعلانات Google"، استخدِم "ad_group_criterion.criterion_id" بدلاً من ذلك.
last_modified_time	string تاريخ ووقت آخر تعديل لمعيار المجموعة الإعلانية هذا. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
criterion_id	int64 رقم تعريف المعيار.
ad_group	string المجموعة الإعلانية التي ينتمي إليها المعيار
negative	bool تحديد ما إذا كان سيتم استهداف المعيار (false) أو استبعاده (true). هذا الحقل غير قابل للتغيير. لتحويل معيار من إيجابي إلى سلبي، عليك إزالته ثم إعادة إضافته.
bid_modifier	double معدِّل عرض السعر عندما يتطابق المعيار. يجب أن تكون قيمة المعدِّل ضمن النطاق: 0.1 - 10.0. تتيح معظم أنواع معايير الاستهداف استخدام المعدِّلات.
cpc_bid_micros	int64 عرض سعر النقرة
effective_cpc_bid_micros	int64 عرض سعر النقرة الفعّال
engine_status	AdGroupCriterionEngineStatus حالة المحرّك لمعيار المجموعة الإعلانية.
final_url_suffix	string نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي
tracking_url_template	string نموذج عنوان URL لإنشاء عنوان URL للتتبّع
حقل الربط criterion معيار المجموعة الإعلانية. يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون التعليق criterion إحدى القيم التالية فقط:
keyword	KeywordInfo الكلمة الرئيسية
listing_group	ListingGroupInfo مجموعة البيانات
age_range	AgeRangeInfo الفئة العمرية
gender	GenderInfo الجنس
user_list	UserListInfo قائمة المستخدمين
webpage	WebpageInfo صفحة ويب
location	LocationInfo الموقع الجغرافي.

PositionEstimates

تقديرات لعروض أسعار المعايير في مواضع مختلفة

الحقول
top_of_page_cpc_micros	int64 تقدير لعرض السعر بتكلفة النقرة المطلوب لعرض الإعلان في أعلى الصفحة الأولى من نتائج البحث.

QualityInfo

حاوية لمعلومات جودة معايير المجموعة الإعلانية.

الحقول
quality_score	int32 نقاط الجودة قد لا تتم تعبئة هذا الحقل إذا لم تتوفّر لدى Google معلومات كافية لتحديد قيمة.

AdGroupCriterionEffectiveLabel

تمثّل هذه السمة علاقة بين معيار مجموعة إعلانية وتصنيف فعّال. التصنيف الفعّال هو تصنيف موروث أو تمّ تعيينه مباشرةً لمعيار المجموعة الإعلانية هذا.

الحقول
resource_name	string اسم مصدر التصنيف الفعّال لمعيار المجموعة الإعلانية. تتّخذ أسماء موارد التصنيف الفعّال لمعايير المجموعة الإعلانية الشكل التالي: customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string معيار المجموعة الإعلانية الذي تم إرفاق التصنيف الفعّال به.
label	string التصنيف الفعّال الذي تمّ تعيينه لمعيار المجموعة الإعلانية.
owner_customer_id	int64 رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupCriterionLabel

تمثّل هذه السمة علاقة بين معيار مجموعة إعلانية وتصنيف.

الحقول
resource_name	string اسم مصدر تصنيف معيار المجموعة الإعلانية تتّخذ أسماء موارد تصنيفات معايير المجموعة الإعلانية الشكل التالي: customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string معيار المجموعة الإعلانية الذي تمّ إرفاق التصنيف به.
label	string التصنيف الذي تمّ تعيينه لمعيار المجموعة الإعلانية.
owner_customer_id	int64 معرّف العميل الذي يملك التصنيف.

AdGroupEffectiveLabel

علاقة بين مجموعة إعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف موروث أو تمّ تعيينه مباشرةً لهذه المجموعة الإعلانية.

الحقول
resource_name	string اسم مصدر التصنيف الفعّال للمجموعة الإعلانية. تتّخذ أسماء موارد التصنيف الفعّال للمجموعة الإعلانية الشكل التالي: customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group	string المجموعة الإعلانية التي تمّ إرفاق التصنيف الفعّال بها.
label	string التصنيف الفعّال الذي تمّ تعيينه للمجموعة الإعلانية.
owner_customer_id	int64 رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupLabel

تمثّل هذه السمة علاقة بين مجموعة إعلانية وتصنيف.

الحقول
resource_name	string اسم مصدر تصنيف المجموعة الإعلانية. تتّخذ أسماء موارد تصنيفات المجموعات الإعلانية الشكل التالي: customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string المجموعة الإعلانية التي تمّ إرفاق التصنيف بها.
label	string التصنيف الذي تمّ تعيينه للمجموعة الإعلانية.
owner_customer_id	int64 معرّف العميل الذي يملك التصنيف.

AgeRangeView

طريقة عرض الفئة العمرية

تمثّل هذه السمة عرضًا لمقاييس أداء العميل (مثل مرّات الظهور والنقرات) مجمّعة حسب الفئة العمرية. يتم تجميع جميع الإحصاءات على مستوى المجموعة الإعلانية.

ملاحظة: على الرغم من أنّه يمكنك تقسيم المقاييس حسب الفئة العمرية باستخدام age_range_view أو حسب الجنس باستخدام gender_view، لا يتيح Search Ads 360 API تقسيم المقاييس حسب الفئة العمرية والجنس في الوقت نفسه في طلب بحث واحد. لا يتيح Search Ads 360 API تحليل الأداء على مستوى كلا السمتَين معًا.

الحقول
resource_name	string اسم مورد عرض الفئة العمرية. تتّخذ أسماء موارد "عرض الفئة العمرية" الشكل التالي: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

مادة العرض

مادة العرض هي جزء من إعلان يمكن مشاركته في عدّة إعلانات. يمكن أن تكون مادة العرض صورة (ImageAsset) أو فيديو (YoutubeVideoAsset) أو غير ذلك. مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف عرض مادة عرض، عليك إزالتها من العنصر الذي يستخدمها.

الحقول
resource_name	string اسم مصدر مادة العرض تتّخذ أسماء موارد مواد العرض الشكل التالي: customers/{customer_id}/assets/{asset_id}
type	AssetType نوع مادة العرض
final_urls[]	string قائمة بعناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات
final_mobile_urls[]	string قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه على مستوى النطاقات
url_custom_parameters[]	CustomParameter قائمة بعمليات الربط التي سيتم استخدامها لاستبدال علامات مَعلمات عناوين URL المخصّصة في tracking_url_template وfinal_urls و/أو final_mobile_urls.
status	AssetStatus تمثّل هذه السمة حالة مادة العرض.
creation_time	string الطابع الزمني لوقت إنشاء مادة العرض هذه يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
last_modified_time	string تاريخ ووقت آخر تعديل على مادة العرض هذه. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
synthetic_content_info	SyntheticContentInfo معلومات المحتوى الاصطناعي لمادة العرض لا تكون مواد العرض التي تتضمّن أنواعًا معيّنة من مواد العرض مؤهّلة للتعديلات باستخدام الحقل synthetic_content_info. قيم AssetType المسموح بها: * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO
id	int64 رقم تعريف مادة العرض
name	string الاسم الاختياري لمادة العرض.
tracking_url_template	string نموذج عنوان URL لإنشاء عنوان URL للتتبّع
final_url_suffix	string نموذج عنوان URL لإلحاق المَعلمات بعناوين URL للصفحات المقصودة التي يتم عرضها باستخدام ميزة التتبُّع الموازي
engine_status	AssetEngineStatus حالة المحرك لمادة عرض
حقل الربط asset_data النوع المحدّد لمادة العرض. يمكن أن يكون التعليق asset_data إحدى القيم التالية فقط:
youtube_video_asset	YoutubeVideoAsset مادة عرض فيديو على YouTube
image_asset	ImageAsset تمثّل هذه السمة مادة عرض صورة.
text_asset	TextAsset مادة عرض نصية
callout_asset	UnifiedCalloutAsset مادة عرض موحّدة لوسائل الشرح
sitelink_asset	UnifiedSitelinkAsset مادة عرض موحّدة لروابط أقسام الموقع
page_feed_asset	UnifiedPageFeedAsset مادة عرض موحّدة لخلاصة الصفحة
mobile_app_asset	MobileAppAsset تمثّل هذه السمة مادة عرض تطبيق للأجهزة الجوّالة.
call_asset	UnifiedCallAsset مادة عرض موحّدة للمكالمات
call_to_action_asset	CallToActionAsset مادة عرض عبارة تحث المستخدم على اتخاذ إجراء
location_asset	UnifiedLocationAsset مادة عرض الموقع الجغرافي الموحّدة

AssetGroup

مجموعة مواد عرض يتم استخدام AssetGroupAsset لربط مادة عرض بمجموعة مواد العرض. يتم استخدام AssetGroupSignal لربط إشارة بمجموعة مواد عرض.

الحقول
resource_name	string اسم مورد مجموعة مواد العرض تتّخذ أسماء موارد مجموعات مواد العرض الشكل التالي: customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 معرّف مجموعة مواد العرض.
campaign	string الحملة التي ترتبط بها مجموعة مواد العرض هذه. مادة العرض المرتبطة بمجموعة مواد العرض
name	string الحقل مطلوب. اسم مجموعة مواد العرض. الحقل مطلوب. يجب أن يتراوح طوله بين حرف واحد و128 حرفًا. يجب أن يكون فريدًا ضمن حملة.
final_urls[]	string قائمة بعناوين URL النهائية بعد كل عمليات إعادة التوجيه على جميع النطاقات في "حملات الأداء الأفضل"، تكون عناوين URL مؤهّلة للتوسيع تلقائيًا ما لم يتم إيقاف هذه الميزة.
final_mobile_urls[]	string قائمة بعناوين URL النهائية للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه بين النطاقات في "حملات الأداء الأفضل"، تكون عناوين URL مؤهّلة للتوسيع تلقائيًا ما لم يتم إيقاف هذه الميزة.
status	AssetGroupStatus حالة مجموعة مواد العرض
path1	string الجزء الأول من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان.
path2	string الجزء الثاني من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان. لا يمكن ضبط هذا الحقل إلا عند ضبط path1.
ad_strength	AdStrength قوة الإعلان الإجمالية لمجموعة مواد العرض هذه

AssetGroupAsset

‫AssetGroupAsset هي الرابط بين مادة عرض ومجموعة مواد عرض. تؤدي إضافة AssetGroupAsset إلى ربط مادة عرض بمجموعة مواد عرض.

الحقول
resource_name	string اسم مصدر مادة عرض مجموعة مواد العرض. يكون اسم مورد مواد العرض لمجموعة مواد العرض بالصيغة التالية: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string مجموعة مواد العرض التي تربطها مادة عرض مجموعة مواد العرض هذه.
asset	string مادة العرض التي تربطها مادة عرض مجموعة مواد العرض هذه.
field_type	AssetFieldType وصف لموضع مادة العرض ضمن مجموعة مواد العرض على سبيل المثال: HEADLINE أو YOUTUBE_VIDEO أو غير ذلك
status	AssetLinkStatus تعرض هذه السمة حالة الربط بين مادة عرض ومجموعة مواد عرض.

AssetGroupAssetCombinationData

بيانات تركيبات مواد العرض في مجموعة مواد العرض

الحقول
asset_combination_served_assets[]	AssetUsage مواد العرض المعروضة

AssetGroupListingGroupFilter

يمثّل AssetGroupListingGroupFilter عقدة شجرة فلتر مجموعة بيانات في مجموعة مواد عرض.

الحقول
resource_name	string اسم مصدر فلتر مجموعة بيانات مجموعة مواد العرض. يكون اسم مورد فلتر مجموعة بيانات مجموعة مواد العرض بالصيغة التالية: customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string مجموعة مواد العرض التي يشكّل فلتر مجموعة بيانات مجموعة مواد العرض هذا جزءًا منها.
id	int64 رقم تعريف ListingGroupFilter.
type	ListingGroupFilterType نوع عقدة فلتر مجموعة البيانات
vertical	ListingGroupFilterVertical تمثّل هذه السمة الاتجاه العمودي لشجرة العُقد الحالية. يجب أن تنتمي جميع العُقد في الشجرة نفسها إلى الفئة العمودية نفسها.
case_value	ListingGroupFilterDimension قيمة السمة التي تعمل مجموعة البيانات هذه على تحسين العنصر الرئيسي بها. غير محدّد للمجموعة الجذر.
parent_listing_group_filter	string اسم المورد الخاص بالقسم الفرعي لمجموعة بيانات المتجر الرئيسية. قيمة فارغة لعقدة فلتر مجموعة بيانات المنتج الرئيسية
path	ListingGroupFilterDimensionPath مسار السمات التي تحدّد فلتر مجموعة بيانات الفندق هذا.

AssetGroupSignal

تمثّل AssetGroupSignal إشارة في مجموعة مواد عرض. يشير توفّر إشارة إلى "حملة الأداء الأفضل" بالمستخدمين الذين يُرجّح إجراؤهم لإحالة ناجحة. تستخدِم "حملة الأداء الأفضل" الإشارة للبحث عن مستخدِمين جدد لديهم نيّة شراء مشابهة أو أقوى حتى تتمكّن من العثور على إحالات ناجحة على مستوى "الحملات على شبكة البحث" و"الشبكة الإعلانية" و"حملات الفيديو" وغير ذلك.

الحقول
resource_name	string اسم مصدر إشارة مجموعة مواد العرض يكون اسم مورد إشارة مجموعة مواد العرض بالصيغة التالية: customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه.
حقل الربط signal إشارة مجموعة مواد العرض. يمكن أن يكون التعليق signal إحدى القيم التالية فقط:
audience	AudienceInfo إشارة الجمهور التي ستستخدِمها "حملة الأداء الأفضل".

AssetGroupTopCombinationView

تعرض هذه البطاقة معلومات عن استخدام أفضل تركيبات مواد العرض في مجموعة مواد العرض.

الحقول
resource_name	string اسم المورد الخاص بطريقة عرض أفضل تركيبة لمجموعة مواد العرض. تتّخذ أسماء موارد "أهم مجموعات مواد العرض في مجموعة مواد العرض" الشكل التالي: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]	AssetGroupAssetCombinationData أفضل مجموعات مواد العرض التي تم عرضها معًا

AssetSet

مجموعة مواد عرض تمثّل مجموعة من مواد العرض استخدِم AssetSetAsset لربط مادة عرض بمجموعة مواد العرض.

الحقول
id	int64 معرّف مجموعة مواد العرض.
resource_name	string اسم مصدر مجموعة مواد العرض. تتّخذ أسماء موارد مجموعات مواد العرض الشكل التالي: customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

‫AssetSetAsset هي الرابط بين مادة عرض ومجموعة مواد عرض. تؤدي إضافة AssetSetAsset إلى ربط مادة عرض بمجموعة مواد عرض.

الحقول
resource_name	string اسم مصدر مادة عرض مجموعة مواد العرض. تتّخذ أسماء موارد مجموعة مواد العرض الشكل التالي: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string مجموعة مواد العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
asset	string مادة العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
status	AssetSetAssetStatus حالة مادة عرض مجموعة مواد العرض. للقراءة فقط.

الجمهور

الجمهور هو خيار استهداف فعّال يسمح لك بإجراء تقاطع على مستوى سمات الشرائح المختلفة، مثل الخصائص الديمغرافية التفصيلية والجماهير ذات الاهتمامات المشتركة، وذلك لإنشاء شرائح جمهور تمثّل أقسام شرائحك المستهدَفة.

الحقول
resource_name	string اسم مورد شريحة الجمهور. تكون أسماء شرائح الجمهور على النحو التالي: customers/{customer_id}/audiences/{audience_id}
id	int64 رقم تعريف شريحة الجمهور.
name	string الحقل مطلوب. اسم شريحة الجمهور يجب أن يكون فريدًا في جميع شرائح الجمهور. يجب أن يكون الحد الأدنى للطول 1 والحد الأقصى 255.
description	string وصف شريحة الجمهور هذه

BiddingStrategy

استراتيجية عروض أسعار

الحقول
resource_name	string اسم المورد الخاص باستراتيجية عروض الأسعار. تتّخذ أسماء موارد استراتيجيات عروض الأسعار الشكل التالي: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus حالة استراتيجية عروض الأسعار هذا الحقل مخصّص للقراءة فقط.
type	BiddingStrategyType نوع استراتيجية عروض الأسعار. أنشئ استراتيجية عروض أسعار من خلال ضبط نظام عروض الأسعار. هذا الحقل مخصّص للقراءة فقط.
currency_code	string تمثّل هذه السمة العملة المستخدَمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217). بالنسبة إلى استراتيجيات عروض الأسعار في حسابات العملاء الإدارية، يمكن ضبط هذه العملة عند الإنشاء، ويتم تلقائيًا استخدام عملة حساب العميل الإداري. بالنسبة إلى العملاء الذين يعرضون إعلانات، لا يمكن ضبط هذا الحقل، لأنّ جميع الاستراتيجيات في حساب العميل الذي يعرض إعلانات تستخدم ضِمنًا عملة حساب العميل الذي يعرض إعلانات. في جميع الحالات، يعرض الحقل effective_currency_code العملة المستخدَمة في الاستراتيجية.
id	int64 معرّف استراتيجية عروض الأسعار
name	string اسم استراتيجية عروض الأسعار يجب أن يكون لكل استراتيجية عروض أسعار في الحساب اسم مميّز. يجب أن يتراوح طول هذه السلسلة بين 1 و255 بايت، بما في ذلك، بترميز UTF-8 (مع إزالة المسافات البيضاء).
effective_currency_code	string تمثّل هذه السمة العملة المستخدَمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217). بالنسبة إلى استراتيجيات عروض الأسعار في حسابات العملاء في الحساب الإداري، هذه هي العملة التي يحدّدها المعلِن عند إنشاء الاستراتيجية. بالنسبة إلى خدمة العملاء، هذا هو رمز عملة العميل. يتم عرض مقاييس استراتيجية عروض الأسعار بهذه العملة. هذا الحقل مخصّص للقراءة فقط.
campaign_count	int64 عدد الحملات المرتبطة باستراتيجية عروض الأسعار هذه هذا الحقل مخصّص للقراءة فقط.
non_removed_campaign_count	int64 عدد الحملات غير المُزالة والمرتبطة باستراتيجية عروض الأسعار هذه هذا الحقل مخصّص للقراءة فقط.
حقل الربط scheme نظام عروض الأسعار يمكن ضبط خيار واحد فقط. يمكن أن يكون التعليق scheme إحدى القيم التالية فقط:
enhanced_cpc	EnhancedCpc استراتيجية عروض أسعار ترفع عروض الأسعار للنقرات التي يزداد احتمال أن تؤدي إلى إحالة ناجحة، وتخفضها للنقرات التي يقل احتمال أن تؤدي إلى إحالة ناجحة.
maximize_conversion_value	MaximizeConversionValue استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالات الناجحة في حملاتك في حدود ميزانيتك
maximize_conversions	MaximizeConversions استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك.
target_cpa	TargetCpa استراتيجية عروض أسعار تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للاكتساب التي تحدّدها.
target_impression_share	TargetImpressionShare استراتيجية عروض أسعار تعمل تلقائيًا على التحسين لتحقيق نسبة مئوية محدّدة من مرّات الظهور.
target_outrank_share	TargetOutrankShare استراتيجية عروض أسعار تحدّد عروض الأسعار استنادًا إلى الجزء المستهدَف من المزادات الذي يجب أن يتفوّق فيه المعلِن على منافس معيّن. تم إيقاف هذا الحقل نهائيًا. سيؤدي إنشاء استراتيجية جديدة لعروض الأسعار باستخدام هذا الحقل أو إرفاق استراتيجيات عروض الأسعار التي تتضمّن هذا الحقل بحملة إلى حدوث خطأ. يُسمح بتعديل الاستراتيجيات التي تمّت تعبئة هذا المخطّط فيها.
target_roas	TargetRoas استراتيجية عروض أسعار تساعدك في تحقيق الحدّ الأقصى من الأرباح مع بلوغ متوسّط عائد إنفاق إعلاني مستهدَف محدّد.
target_spend	TargetSpend استراتيجية عروض أسعار تحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

الحملة

حملة

الحقول
resource_name	string اسم المورد الخاص بالحملة. تتّخذ أسماء موارد الحملات الشكل التالي: customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus تمثّل هذه السمة حالة الحملة. عند إضافة حملة جديدة، تكون الحالة تلقائيًا "مفعّلة".
serving_status	CampaignServingStatus حالة عرض الإعلانات على مستوى الحملة
bidding_strategy_system_status	BiddingStrategySystemStatus حالة نظام استراتيجية عروض الأسعار على مستوى الحملة
ad_serving_optimization_status	AdServingOptimizationStatus حالة تحسين عرض الإعلانات على مستوى الحملة.
advertising_channel_type	AdvertisingChannelType الاستهداف الأساسي لعرض الإعلانات ضمن الحملة يمكن تحسين خيارات الاستهداف في network_settings. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. يمكن ضبطها فقط عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل.
advertising_channel_sub_type	AdvertisingChannelSubType تحسين اختياري لـ "advertising_channel_type" يجب أن يكون نوعًا فرعيًا صالحًا لنوع القناة الرئيسية. يمكن ضبطها فقط عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل.
url_custom_parameters[]	CustomParameter قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصّصة في tracking_url_template أو final_urls أو mobile_final_urls
real_time_bidding_setting	RealTimeBiddingSetting إعدادات "عروض الأسعار في الوقت الفعلي"، وهي ميزة متاحة فقط للحملات التي تستهدف شبكة Ad Exchange
network_settings	NetworkSettings إعدادات الشبكة للحملة
dynamic_search_ads_setting	DynamicSearchAdsSetting إعداد التحكّم في "الإعلانات الديناميكية على شبكة البحث"
shopping_setting	ShoppingSetting إعداد التحكّم في "حملات Shopping"
geo_target_type_setting	GeoTargetTypeSetting إعداد الاستهداف الجغرافي للإعلانات
effective_labels[]	string أسماء مصادر التصنيفات الفعّالة المرفقة بهذه الحملة التصنيف الفعّال هو تصنيف موروث أو تمّ تعيينه مباشرةً لهذه الحملة.
labels[]	string أسماء مصادر التصنيفات المرفقة بهذه الحملة
bidding_strategy_type	BiddingStrategyType نوع استراتيجية عروض الأسعار. يمكن إنشاء استراتيجية عروض أسعار من خلال ضبط نظام عروض الأسعار لإنشاء استراتيجية عروض أسعار عادية أو ضبط الحقل bidding_strategy لإنشاء استراتيجية محفظة لعروض الأسعار. هذا الحقل مخصّص للقراءة فقط.
accessible_bidding_strategy	string اسم مورد AccessibleBiddingStrategy، وهو عرض للقراءة فقط للسمات غير المقيدة لاستراتيجية المحفظة لعروض الأسعار المرفقة التي يتم تحديدها من خلال "bidding_strategy". يكون فارغًا إذا كانت الحملة لا تستخدم استراتيجية محفظة. تتوفّر سمات الاستراتيجية غير المقيّدة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويتم قراءتها من مورد AccessibleBiddingStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا للعميل المالك للاستراتيجية والمدراء. لا يمكن قراءة السمات المحظورة إلا من مورد BiddingStrategy.
frequency_caps[]	FrequencyCapEntry قائمة تحدّد عدد مرّات ظهور إعلانات هذه الحملة لكل مستخدم.
selective_optimization	SelectiveOptimization إعداد التحسين الانتقائي لهذه الحملة، والذي يتضمّن مجموعة من إجراءات الإحالات الناجحة التي يتم تحسين هذه الحملة من أجلها لا تنطبق هذه الميزة إلا على "حملات التطبيقات" التي تستخدم MULTI_CHANNEL كـ AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT كـ AdvertisingChannelSubType.
optimization_goal_setting	OptimizationGoalSetting إعداد هدف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين
tracking_setting	TrackingSetting إعدادات على مستوى الحملة لتتبُّع المعلومات
engine_id	string معرّف الحملة في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لـ "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى عنصر "إعلانات Google"، استخدِم "campaign.id" بدلاً من ذلك.
excluded_parent_asset_field_types[]	AssetFieldType أنواع حقول مواد العرض التي يجب استبعادها من هذه الحملة. لن ترث هذه الحملة روابط مواد العرض التي تتضمّن أنواع الحقول هذه من المستوى الأعلى.
create_time	string الطابع الزمني لوقت إنشاء هذه الحملة. الطابع الزمني هو في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". سيتم إيقاف create_time نهائيًا في الإصدار 1. استخدِم creation_time بدلاً من ذلك.
creation_time	string الطابع الزمني لوقت إنشاء هذه الحملة. يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
last_modified_time	string تاريخ ووقت آخر تعديل تم إجراؤه على هذه الحملة. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
feed_types[]	AssetSetType أنواع الخلاصات المرفقة مباشرةً بهذه الحملة
id	int64 رقم تعريف الحملة.
name	string اسم الحملة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. يجب ألا يحتوي على أي أحرف قيمة فارغة (قيمة موضع الرمز 0x0) أو أحرف سطر جديد (قيمة موضع الرمز 0xA) أو أحرف رجوع إلى أول السطر (قيمة موضع الرمز 0xD).
tracking_url_template	string نموذج عنوان URL لإنشاء عنوان URL للتتبّع
campaign_budget	string اسم المورد لميزانية الحملة.
start_date	string تاريخ بدء الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD
end_date	string آخر يوم في الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD عند الإنشاء، يتم ضبط القيمة التلقائية على ‎2037-12-30، ما يعني أنّ الحملة ستستمر إلى أجل غير مسمّى. لضبط حملة حالية على العرض إلى أجل غير مسمى، اضبط هذا الحقل على 2037-12-30.
final_url_suffix	string لاحقة تُستخدَم لإلحاق مَعلمات طلب البحث بالصفحات المقصودة التي يتم عرضها باستخدام التتبُّع الموازي.
url_expansion_opt_out	bool تمثّل هذه السمة إيقاف ميزة "توسيع عنوان URL" لتوجيه الإعلانات إلى عناوين URL أكثر استهدافًا. وفي حال إيقافها (true)، يتم استهداف عناوين URL النهائية في مجموعة مواد العرض أو عناوين URL المحدّدة في خلاصات بيانات النشاط التجاري أو Google Merchant Center الخاص بالمعلِن فقط. إذا تم تفعيلها (خطأ)، سيتم استهداف النطاق بأكمله. لا يمكن ضبط هذا الحقل إلا في "حملات الأداء الأفضل"، حيث تكون القيمة التلقائية هي "خطأ".
حقل الربط campaign_bidding_strategy استراتيجية عروض الأسعار للحملة يجب أن تكون إما محفظة (تم إنشاؤها من خلال خدمة BiddingStrategy) أو عادية، أي مضمّنة في الحملة. يمكن أن يكون التعليق campaign_bidding_strategy إحدى القيم التالية فقط:
bidding_strategy	string اسم مصدر استراتيجية عروض الأسعار في المحفظة المستخدَمة في الحملة.
manual_cpa	ManualCpa استراتيجية عروض أسعار "تكلفة النقرة اليدوية" العادية استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدّده المعلِن. تتوفّر هذه الميزة فقط في "حملات الخدمات المحلية".
manual_cpc	ManualCpc استراتيجية عروض أسعار النقرة اليدوية العادية عروض الأسعار المستندة إلى النقرات يدويًا، حيث يدفع المستخدم مقابل كل نقرة
manual_cpm	ManualCpm استراتيجية عروض الأسعار اليدوية القياسية استنادًا إلى التكلفة لكلّ ألف ظهور عروض الأسعار اليدوية المستندة إلى مرات الظهور، حيث يدفع المستخدم مقابل كل ألف مرّة ظهور.
maximize_conversions	MaximizeConversions استراتيجية عروض أسعار تحقيق الحد الأقصى من الإحالات الناجحة العادية التي تعمل تلقائيًا على زيادة عدد الإحالات الناجحة إلى أقصى حدّ في حدود ميزانيتك
maximize_conversion_value	MaximizeConversionValue استراتيجية عروض أسعار "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" العادية التي تحدّد عروض الأسعار تلقائيًا لزيادة الأرباح إلى أقصى حدّ في حدود ميزانيتك
target_cpa	TargetCpa استراتيجية عروض الأسعار المستندة إلى "التكلفة المستهدفة للإجراء" العادية التي تحدّد عروض الأسعار تلقائيًا للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للاكتساب التي تحدّدها.
target_impression_share	TargetImpressionShare استراتيجية عروض الأسعار لنسبة ظهور الإعلان المستهدفة استراتيجية عروض أسعار مبرمَجة تحدِّد عروض الأسعار لتحقيق نسبة مئوية محدّدة من مرّات الظهور.
target_roas	TargetRoas استراتيجية عروض أسعار "عائد الإنفاق الإعلاني المستهدَف" العادية التي تزيد الأرباح إلى أقصى حدّ تلقائيًا مع تحقيق متوسّط عائد إنفاق إعلاني مستهدَف محدّد.
target_spend	TargetSpend استراتيجية عروض الأسعار "الإنفاق المستهدف" العادية التي تحدِّد عروض أسعارك تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.
percent_cpc	PercentCpc استراتيجية عروض أسعار "تكلفة النقرة بالنسبة المئوية" العادية التي تكون فيها عروض الأسعار جزءًا من السعر المُعلن عنه لبعض السلع أو الخدمات
target_cpm	TargetCpm استراتيجية عروض أسعار تعمل تلقائيًا على تحسين التكلفة لكل ألف مرّة ظهور.

DynamicSearchAdsSetting

إعداد التحكّم في "الإعلانات الديناميكية على شبكة البحث"

الحقول
domain_name	string الحقل مطلوب. اسم نطاق الإنترنت الذي يمثّله هذا الإعداد، مثل "google.com" أو "www.google.com".
language_code	string الحقل مطلوب. رمز اللغة الذي يحدّد لغة النطاق، مثل "ar".
use_supplied_urls_only	bool تُستخدَم لتحديد ما إذا كانت الحملة تستخدم عناوين URL التي يقدّمها المعلِن حصريًا.

GeoTargetTypeSetting

تمثّل هذه السمة مجموعة من الإعدادات المتعلّقة بالاستهداف الجغرافي للإعلانات.

الحقول
positive_geo_target_type	PositiveGeoTargetType الإعداد المستخدَم للاستهداف الجغرافي الإيجابي في هذه الحملة تحديدًا
negative_geo_target_type	NegativeGeoTargetType الإعداد المستخدَم للاستهداف الجغرافي السلبي في هذه الحملة تحديدًا

NetworkSettings

إعدادات الشبكة للحملة

الحقول
target_google_search	bool تحدّد هذه السمة ما إذا كان سيتم عرض الإعلانات مع نتائج البحث على google.com.
target_search_network	bool تحديد ما إذا كان سيتم عرض الإعلانات على المواقع الإلكترونية في "شبكة شركاء بحث Google" (يتطلّب أن تكون قيمة target_google_search هي true أيضًا)
target_content_network	bool تحديد ما إذا كان سيتم عرض الإعلانات في مواضع إعلانات محدّدة على "شبكة Google الإعلانية" يتم تحديد مواضع الإعلان باستخدام معيار "موضع الإعلان".
target_partner_search_network	bool تحديد ما إذا كان سيتم عرض الإعلانات على شبكة الشركاء يتوفّر هذا الخيار لبعض حسابات الشركاء المحدّدة فقط. ما لم يُطلب منك استخدام هذا الحقل، من المحتمل أنّه لا ينطبق على حسابك. لا يتحكّم هذا الإعداد في ما إذا كان سيتم عرض الإعلانات على "شبكة شركاء البحث" من Google، بل استخدِم target_search_network بدلاً من ذلك.

OptimizationGoalSetting

إعداد هدف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين

الحقول
optimization_goal_types[]	OptimizationGoalType قائمة بأنواع أهداف التحسين.

SelectiveOptimization

إعداد التحسين الانتقائي لهذه الحملة، والذي يتضمّن مجموعة من إجراءات الإحالات الناجحة التي يتم تحسين هذه الحملة من أجلها لا تنطبق هذه الميزة إلا على "حملات التطبيقات" التي تستخدم MULTI_CHANNEL كـ AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT كـ AdvertisingChannelSubType.

الحقول
conversion_actions[]	string المجموعة المحدّدة من أسماء الموارد لإجراءات الإحالات الناجحة من أجل تحسين هذه الحملة.

ShoppingSetting

إعداد "حملات Shopping" تحدّد هذه السمة مجموعة المنتجات التي يمكن الإعلان عنها من خلال الحملة، وكيفية تفاعل هذه الحملة مع "حملات Shopping" الأخرى.

الحقول
feed_label	string تصنيف الخلاصة للمنتجات التي سيتم تضمينها في الحملة. يمكن أن تتضمّن تصنيفات الخلاصة الصالحة 20 حرفًا كحدّ أقصى، بما في ذلك الأحرف الكبيرة والأرقام والواصلات والشرطات السفلية. إذا كنت قد استخدمت سابقًا sales_country المتوقّفة نهائيًا بتنسيق رمز البلد المكوّن من حرفين (XX)، يجب استخدام الحقل feed_label بدلاً من ذلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الدعم حول تصنيف الخلاصة.
use_vehicle_inventory	bool تحديد ما إذا كان سيتم استهداف مساحة إعلانية لـ "إعلانات بيانات المركبات"
merchant_id	int64 معرّف حساب Merchant Center هذا الحقل مطلوب لعمليات الإنشاء. هذا الحقل غير قابل للتغيير في "حملات Shopping".
sales_country	string بلد بيع المنتجات التي سيتم تضمينها في الحملة
campaign_priority	int32 أولوية الحملة تكون الأولوية للحملات ذات الأولوية الأعلى رقميًا على تلك ذات الأولوية الأقل. هذا الحقل مطلوب لحملات Shopping، ويجب أن تتراوح القيم بين 0 و2، بما في ذلك هذين الرقمَين. هذا الحقل اختياري في "حملات Shopping الذكية"، ولكن يجب أن تكون قيمته 3 إذا تم ضبطه.
enable_local	bool تحديد ما إذا كان سيتم تضمين المنتجات المحلية

TrackingSetting

إعدادات على مستوى الحملة لتتبُّع المعلومات

الحقول
tracking_url	string عنوان URL المستخدَم للتتبُّع الديناميكي.

CampaignAsset

رابط بين "حملة" و"مادة عرض"

الحقول
resource_name	string اسم مصدر مادة عرض الحملة. تتّخذ أسماء موارد CampaignAsset الشكل التالي: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus حالة مادة عرض الحملة.
campaign	string الحملة المرتبطة بمادة العرض
asset	string مادة العرض المرتبطة بالحملة

CampaignAssetSet

تمثّل CampaignAssetSet الرابط بين الحملة ومجموعة مواد العرض. تؤدي إضافة CampaignAssetSet إلى ربط مجموعة مواد عرض بحملة.

الحقول
resource_name	string اسم مصدر مجموعة مواد العرض على مستوى الحملة. تتّخذ أسماء موارد مجموعة مواد العرض الشكل التالي: customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string الحملة التي ترتبط بها مجموعة مواد العرض هذه.
asset_set	string مجموعة مواد العرض المرتبطة بالحملة
status	AssetSetLinkStatus حالة مادة عرض مجموعة مواد العرض للحملة للقراءة فقط.

CampaignAudienceView

طريقة عرض الجمهور في الحملة تشمل بيانات الأداء من قوائم الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، والتي يتم تجميعها حسب الحملة ومعيار الجمهور. لا يتضمّن هذا العرض سوى شرائح الجمهور المرفقة على مستوى الحملة.

الحقول
resource_name	string اسم المرجع الخاص بطريقة عرض شرائح الجمهور في الحملة. تكون أسماء موارد "عرض الجمهور في الحملة" على النحو التالي: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

ميزانية الحملة

الحقول
resource_name	string اسم المورد لميزانية الحملة. تتّخذ أسماء موارد ميزانية الحملة الشكل التالي: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method	BudgetDeliveryMethod طريقة العرض التي تحدّد معدّل إنفاق ميزانية الحملة. يتم ضبط القيمة تلقائيًا على STANDARD في حال عدم تحديدها في عملية إنشاء.
period	BudgetPeriod الفترة التي سيتم خلالها إنفاق الميزانية يتم ضبط القيمة تلقائيًا على DAILY في حال عدم تحديدها.
amount_micros	int64 متوسط المبلغ اليومي الذي ستنفقه الحملة. يتم استخدام هذا الحقل عندما يتم ضبط CampaignBudget period على DAILY، وهو الإعداد التلقائي. يتم تحديد المبلغ بوحدات المايكرو بالعملة المحلية للحساب. يساوي مليون وحدة ميكرو وحدة عملة واحدة. يبلغ الحد الأقصى للإنفاق الشهري الفعلي 30.4 ضعف هذا المبلغ اليومي. يستبعد هذا الحقل الحقل "total_amount_micros". يجب ضبط قيمة واحدة فقط من قيمتَي "amount_micros" أو "total_amount_micros".

CampaignCriterion

معيار حملة

الحقول
resource_name	string اسم المورد لمعيار الحملة. تتّخذ أسماء موارد معايير الحملات الشكل التالي: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name	string الاسم المعروض للمعايير. يتم تجاهل هذا الحقل في عمليات التغيير.
type	CriterionType نوع المعيار.
status	CampaignCriterionStatus تمثّل هذه السمة حالة معيار الاستهداف.
last_modified_time	string تاريخ ووقت آخر تعديل لمعيار الحملة هذا. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
criterion_id	int64 رقم تعريف المعيار. يتم تجاهل هذا الحقل أثناء التعديل.
bid_modifier	float معدّل عروض الأسعار عندما يتطابق المعيار. يجب أن تكون قيمة المعدِّل ضمن النطاق: 0.1 - 10.0. تتيح معظم أنواع معايير الاستهداف استخدام المعدِّلات. استخدِم 0 لإيقاف نوع الجهاز.
negative	bool تحديد ما إذا كان سيتم استهداف المعيار (false) أو استبعاده (true).
حقل الربط criterion معيار الحملة. يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون التعليق criterion إحدى القيم التالية فقط:
keyword	KeywordInfo الكلمة الرئيسية
location	LocationInfo الموقع الجغرافي.
device	DeviceInfo الجهاز.
age_range	AgeRangeInfo الفئة العمرية
gender	GenderInfo الجنس
user_list	UserListInfo قائمة المستخدمين
language	LanguageInfo اللغة
webpage	WebpageInfo صفحة الويب
location_group	LocationGroupInfo مجموعة المواقع الجغرافية

CampaignEffectiveLabel

تمثّل هذه السمة علاقة بين حملة وتصنيف فعّال. التصنيف الفعّال هو تصنيف موروث أو تمّ تعيينه مباشرةً لهذه الحملة.

الحقول
resource_name	string اسم المورد تتّخذ أسماء موارد CampaignEffectivelabel الشكل التالي: customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string الحملة التي تم إرفاق التصنيف الفعّال بها
label	string التصنيف الفعّال الذي تمّ تعيينه للحملة
owner_customer_id	int64 رقم تعريف العميل الذي يملك التصنيف الفعّال.

CampaignLabel

تمثّل هذه السمة علاقة بين حملة وتصنيف.

الحقول
resource_name	string اسم المورد تتّخذ أسماء موارد تصنيفات الحملات الشكل التالي: customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string تمثّل هذه السمة الحملة التي تمّ إرفاق التصنيف بها.
label	string التصنيف الذي تمّ تعيينه للحملة.
owner_customer_id	int64 معرّف العميل الذي يملك التصنيف.

CartDataSalesView

عرض المبيعات استنادًا إلى بيانات سلة التسوّق

تقدّم هذه السمة معلومات عن المنتجات التي تم شراؤها في حال تمّ تنفيذ ميزة "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق". تتوفّر مقاييس الأداء، مثل الإيرادات والأرباح الإجمالية ومقاييس العملاء المحتمَلين/البيع المتعدّد وما إلى ذلك، وسمات Merchant Center، مثل العلامة التجارية والفئة وما إلى ذلك، للمنتجات المحدّدة في خلاصة مستودع إعلاني والتي يتم بيعها نتيجةً للإعلانات على Google. بالنسبة إلى عمليات الشراء التي يتمّ تحديد مصدرها على أنّه النقرات على "إعلانات Shopping"، يمكن عرض سمات كلّ من المنتجات التي تمّ النقر عليها والمنتجات التي تمّ بيعها معًا.

الحقول
resource_name	string اسم المورد الخاص بطريقة عرض مبيعات بيانات سلة التسوّق تتّخذ أسماء موارد عرض المبيعات لبيانات سلة التسوّق الشكل التالي: customers/{customer_id}/cartDataSalesView

الإحالة الناجحة

إحالة ناجحة

الحقول
resource_name	string تمثّل هذه السمة اسم مورد الإحالة الناجحة. تكون أسماء موارد الإحالات الناجحة على النحو التالي: customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id	int64 رقم تعريف الإحالة الناجحة
criterion_id	int64 رقم تعريف معيار "إعلانات شبكة البحث 360" تشير القيمة 0 إلى أنّ المعيار غير محدّد المصدر.
merchant_id	int64 رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360".
ad_id	int64 معرّف الإعلان تشير القيمة 0 إلى أنّ الإعلان غير محدّد المصدر.
click_id	string سلسلة فريدة للزيارة التي يتمّ تحديد مصدر الإحالة الناجحة على أنّه منها، ويتمّ تمريرها إلى الصفحة المقصودة كمَعلمة عنوان URL لمعرّف النقرة.
visit_id	int64 معرّف الزيارة في "إعلانات شبكة البحث 360" الذي تُنسَب إليه الإحالة الناجحة.
advertiser_conversion_id	string بالنسبة إلى الإحالات الناجحة غير الإلكترونية، يكون هذا المعرّف مقدَّمًا من المعلِنين. إذا لم يحدّد المعلِن رقم تعريف من هذا النوع، ستنشئ "إعلانات شبكة البحث 360" رقم تعريف. بالنسبة إلى الإحالات الناجحة على الإنترنت، يكون هذا المعرّف مساويًا لعمود المعرّف أو عمود floodlight_order_id استنادًا إلى تعليمات Floodlight الخاصة بالمعلِن.
product_id	string معرّف المنتج الذي تم النقر عليه.
product_channel	ProductChannel قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو في المتجر المحلي
product_language_code	string اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center التي تحتوي على بيانات حول المنتج
product_store_id	string المتجر الذي تم النقر عليه في "إعلان للمنتجات داخل المتجر" يجب أن تتطابق هذه السمة مع معرّفات المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلية.
product_country_code	string البلد (بتنسيق ISO-3166) المسجَّل لخلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه
attribution_type	AttributionType ما تُنسب إليه الإحالة الناجحة: زيارة أو كلمة رئيسية + إعلان
conversion_date_time	string الطابع الزمني لحدث الإحالة الناجحة.
conversion_last_modified_date_time	string الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة
conversion_visit_date_time	string الطابع الزمني للزيارة التي تُنسَب إليها الإحالة الناجحة.
conversion_quantity	int64 تمثّل هذه السمة عدد السلع التي سجّلتها الإحالة الناجحة، كما هو محدّد بواسطة مَعلمة عنوان URL الخاصة بالكمية. يتحمّل المعلِن مسؤولية تعبئة المَعلمة ديناميكيًا (مثل عدد السلع التي تم بيعها في الإحالة الناجحة)، وإلا سيتم ضبط القيمة التلقائية على 1.
conversion_revenue_micros	int64 الإيرادات المعدَّلة بالمايكرو لحدث الإحالة الناجحة. ستكون هذه القيمة دائمًا بعملة حساب عرض الإعلانات.
floodlight_original_revenue	int64 الأرباح الأصلية غير المعدَّلة المرتبطة بحدث Floodlight (بعملة التقرير الحالي)، قبل تعديلات إعدادات عملة Floodlight
floodlight_order_id	string رقم تعريف الطلب في Floodlight الذي يقدّمه المعلِن للإحالة الناجحة.
status	ConversionStatus حالة الإحالة الناجحة، إما ENABLED أو REMOVED.
asset_id	int64 رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الإحالة الناجحة.
asset_field_type	AssetFieldType نوع حقل مادة العرض لحدث الإحالة الناجحة

ConversionAction

إجراء إحالة ناجحة

الحقول
resource_name	string اسم مورد إجراء الإحالة الناجحة. تتّخذ أسماء موارد إجراءات الإحالات الناجحة الشكل التالي: customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string الطابع الزمني لإنشاء نشاط Floodlight، بتنسيق ISO 8601.
status	ConversionActionStatus حالة إجراء الإحالة الناجحة هذا لاحتساب أحداث الإحالات الناجحة
type	ConversionActionType نوع إجراء الإحالة الناجحة هذا.
category	ConversionActionCategory فئة الإحالات الناجحة التي يتمّ تسجيلها لإجراء الإحالة الناجحة هذا.
value_settings	ValueSettings إعدادات متعلّقة بقيمة أحداث الإحالات الناجحة المرتبطة بإجراء الإحالة الناجحة هذا
attribution_model_settings	AttributionModelSettings إعدادات متعلّقة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا
floodlight_settings	FloodlightSettings إعدادات Floodlight لأنواع الإحالات الناجحة في Floodlight
id	int64 رقم تعريف إجراء الإحالة الناجحة.
name	string اسم إجراء الإحالة الناجحة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء إجراءات إحالات ناجحة جديدة.
primary_for_goal	bool إذا كانت قيمة primary_for_goal bit لإجراء إحالة ناجحة هي false، لن يكون إجراء الإحالة الناجحة غير قابلة للمزايدة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. ومع ذلك، لا تلتزم أهداف الإحالات الناجحة المخصّصة بالسمة primary_for_goal، لذا إذا كانت إحدى الحملات تتضمّن هدف إحالة ناجحة مخصّصًا تمّت تهيئته باستخدام إجراء إحالة ناجحة primary_for_goal = false، سيظلّ من الممكن تقديم عروض أسعار لإجراء الإحالة الناجحة هذا. تكون قيمة primary_for_goal تلقائية هي "صحيح" إذا لم يتم ضبطها. في الإصدار 9، لا يمكن ضبط primary_for_goal على "خطأ" إلا بعد الإنشاء من خلال عملية "تعديل" لأنّه لم يتم تعريفه على أنّه اختياري.
owner_customer	string اسم المورد للعميل المالك لإجراء الإحالة الناجحة، أو قيمة فارغة إذا كان هذا إجراء إحالة ناجحة محدّدًا من النظام.
include_in_client_account_conversions_metric	bool تحديد ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "client_account_conversions".
include_in_conversions_metric	bool تُستخدَم لتحديد ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "الإحالات الناجحة".
click_through_lookback_window_days	int64 الحدّ الأقصى لعدد الأيام التي قد تمرّ بين إجراء تفاعل (مثل نقرة) وحدث إحالة ناجحة
app_id	string رقم تعريف التطبيق لإجراء إحالة ناجحة خاص بالتطبيق

AttributionModelSettings

إعدادات متعلّقة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا

الحقول
attribution_model	AttributionModel نوع نموذج تحديد المصدر لإجراء الإحالة الناجحة هذا.
data_driven_model_status	DataDrivenModelStatus حالة نموذج تحديد المصدر بالاستناد إلى البيانات لإجراء الإحالة الناجحة

FloodlightSettings

إعدادات مرتبطة بإجراء إحالة ناجحة في Floodlight

الحقول
activity_group_tag	string سلسلة تُستخدَم لتحديد مجموعة أنشطة Floodlight عند تسجيل الإحالات الناجحة.
activity_tag	string سلسلة تُستخدَم لتحديد نشاط Floodlight عند تسجيل الإحالات الناجحة.
activity_id	int64 رقم تعريف نشاط Floodlight في DoubleClick Campaign Manager (DCM).

ValueSettings

إعدادات متعلّقة بقيمة أحداث الإحالات الناجحة المرتبطة بإجراء الإحالة الناجحة هذا

الحقول
default_value	double القيمة التي سيتم استخدامها عند إرسال أحداث الإحالات الناجحة لإجراء الإحالة الناجحة هذا بقيمة غير صالحة أو غير مسموح بها أو غير متوفّرة، أو عند ضبط إجراء الإحالة الناجحة هذا على استخدام القيمة التلقائية دائمًا.
default_currency_code	string رمز العملة المطلوب استخدامه عند إرسال أحداث الإحالات الناجحة لإجراء الإحالة الناجحة هذا مع رمز عملة غير صالح أو ناقص، أو عند ضبط إجراء الإحالة الناجحة هذا على استخدام القيمة التلقائية دائمًا
always_use_default_value	bool تتحكّم هذه السمة في ما إذا كان سيتم استخدام القيمة التلقائية ورمز العملة التلقائي بدلاً من القيمة ورمز العملة المحدّدين في أحداث الإحالات الناجحة لإجراء الإحالة الناجحة هذا.

ConversionCustomVariable

متغيّر مخصّص للإحالة الناجحة يمكنك الاطّلاع على "لمحة عن مقاييس Floodlight وسماته المخصّصة في التجربة الجديدة من "إعلانات شبكة البحث 360"" على الرابط https://support.google.com/sa360/answer/13567857

الحقول
resource_name	string اسم المورد الخاص بمتغيّر الإحالة الناجحة المخصّص. تتّخذ أسماء موارد المتغيّرات المخصّصة للإحالات الناجحة الشكل التالي: customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 رقم تعريف متغيّر الإحالة الناجحة المخصّص.
name	string الحقل مطلوب. اسم متغيّر الإحالة الناجحة المخصّص. يجب أن يكون الاسم فريدًا. الحد الأقصى لطول الاسم هو 100 حرف. يجب ألا تكون هناك أي مسافات إضافية قبل الاسم وبعده.
tag	string الحقل مطلوب. علامة متغيّر الإحالة الناجحة المخصّص. يجب أن تكون العلامة فريدة وأن تتألف من الحرف "u" متبوعًا مباشرةً برقم أقل من أو يساوي 100. على سبيل المثال: "u4".
status	ConversionCustomVariableStatus حالة المتغيّر المخصّص للإحالة الناجحة من أجل تجميع أحداث الإحالات الناجحة.
owner_customer	string اسم المورد الخاص بالعميل الذي يملك متغيّر الإحالة الناجحة المخصّص.
family	ConversionCustomVariableFamily مجموعة متغيّر الإحالة الناجحة المخصّص.
cardinality	ConversionCustomVariableCardinality عدد العناصر في الحقل لمتغيّر الإحالة الناجحة المخصّص.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo حقول لمتغيّرات Floodlight المخصّصة للإحالات الناجحة في "إعلانات شبكة البحث 360"
custom_column_ids[]	int64 أرقام تعريف الأعمدة المخصّصة التي تستخدم متغيّر الإحالة الناجحة المخصّص هذا

FloodlightConversionCustomVariableInfo

معلومات عن متغيّرات Floodlight المخصّصة للإحالات الناجحة في "إعلانات شبكة البحث 360"

الحقول
floodlight_variable_type	FloodlightVariableType نوع متغيّر Floodlight المحدّد في "إعلانات شبكة البحث 360"
floodlight_variable_data_type	FloodlightVariableDataType نوع بيانات متغيّر Floodlight المحدّد في "إعلانات شبكة البحث 360"

ConversionTrackingSetting

مجموعة من الإعدادات على مستوى العميل ذات الصلة بميزة "تتبُّع الإحالات الناجحة" في "إعلانات شبكة البحث 360"

الحقول
accepted_customer_data_terms	bool تُستخدَم لتحديد ما إذا كان العميل قد قبل أحكام بيانات العملاء. في حال استخدام ميزة "تتبُّع الإحالات الناجحة في جميع الحسابات"، يتمّ استيراد هذه القيمة من الحساب الإداري. هذا الحقل مخصّص للقراءة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_status	ConversionTrackingStatus حالة تتبُّع الإحالات الناجحة يشير هذا الحقل إلى ما إذا كان العميل يستخدم ميزة تتبُّع الإحالات الناجحة، وإلى الجهة المسؤولة عن تتبُّع الإحالات الناجحة لهذا العميل. إذا كان هذا العميل يستخدم ميزة "تتبُّع الإحالات الناجحة في جميع الحسابات"، ستختلف القيمة التي يتم عرضها استنادًا إلى login-customer-id للطلب.
enhanced_conversions_for_leads_enabled	bool تُستخدَم لتحديد ما إذا كان العميل قد فعّل ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين". في حال استخدام ميزة "تتبُّع الإحالات الناجحة في جميع الحسابات"، يتمّ استيراد هذه القيمة من الحساب الإداري. هذا الحقل مخصّص للقراءة فقط.
google_ads_conversion_customer	string اسم المورِد الخاص بالعميل الذي يتم فيه إنشاء الإحالات الناجحة وإدارتها. هذا الحقل مخصّص للقراءة فقط.
conversion_tracking_id	int64 معرّف تتبُّع الإحالات الناجحة المستخدَم لهذا الحساب. لا يشير رقم التعريف هذا إلى ما إذا كان العميل يستخدم ميزة تتبُّع الإحالات الناجحة (تشير إليها السمة conversion_tracking_status). هذا الحقل مخصّص للقراءة فقط.
google_ads_cross_account_conversion_tracking_id	int64 رقم تعريف تتبُّع الإحالات الناجحة الخاص بحساب المدير التابع للعميل يتم ضبط هذا المعرّف عندما يوافق العميل على تتبُّع الإحالات الناجحة، ويتجاوز المعرّف conversion_tracking_id. لا يمكن إدارة هذا الحقل إلا من خلال واجهة مستخدم "إعلانات Google". هذا الحقل مخصّص للقراءة فقط.
cross_account_conversion_tracking_id	int64 رقم تعريف تتبُّع الإحالات الناجحة الخاص بحساب المدير التابع للعميل يتم ضبط هذا المعرّف عندما يفعّل العميل ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ويتجاوز قيمة conversion_tracking_id.

CustomColumn

عمود مخصّص يمكنك الاطّلاع على العمود المخصّص في "إعلانات شبكة البحث 360" على الرابط https://support.google.com/sa360/answer/9633916

الحقول
resource_name	string اسم المورد للعمود المخصّص. تتّخذ أسماء موارد الأعمدة المخصّصة الشكل التالي: customers/{customer_id}/customColumns/{custom_column_id}
id	int64 معرّف العمود المخصّص.
name	string اسم العمود المخصّص الذي حدّده المستخدم
description	string وصف من تحديد المستخدِم للعمود المخصّص.
value_type	CustomColumnValueType تمثّل هذه السمة نوع قيمة النتيجة للعمود المخصّص.
references_attributes	bool تعرض القيمة "صحيح" عندما يشير العمود المخصّص إلى سمة واحدة أو أكثر.
references_metrics	bool تعرض القيمة "صحيح" عندما يشير العمود المخصّص إلى مقياس واحد أو أكثر.
queryable	bool تعرض القيمة "صحيح" عندما يكون العمود المخصّص متاحًا للاستخدام في طلب البحث عن SearchAds360Service.Search وSearchAds360Service.SearchStream.
referenced_system_columns[]	string قائمة أعمدة النظام المرجعية لهذا العمود المخصّص على سبيل المثال، يشير عمود مخصّص "مجموع مرّات الظهور والنقرات" إلى أعمدة النظام {"metrics.clicks", "metrics.impressions"}.
render_type	CustomColumnRenderType توضّح هذه السمة كيفية تفسير قيمة النتيجة للعمود المخصّص.

العميل

أحد العملاء

الحقول
resource_name	string اسم المورِد الخاص بالعميل تكون أسماء موارد العملاء على النحو التالي: customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting إعداد تتبُّع الإحالات الناجحة لأحد العملاء
account_type	AccountType نوع حساب محرّك البحث، مثل "إعلانات Google" وMicrosoft Advertising وYahoo Japan وBaidu وFacebook وحساب تتبُّع محرّكات البحث وما إلى ذلك
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting إعداد DoubleClick Campaign Manager (DCM) لحساب عميل إداري
account_status	AccountStatus حالة الحساب، مثل مفعَّل أو متوقّف مؤقتًا أو مُزال أو غير ذلك
last_modified_time	string تاريخ ووقت آخر تعديل على هذا العميل يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
engine_id	string معرّف الحساب في حساب المحرّك الخارجي
status	CustomerStatus تمثّل هذه السمة حالة العميل.
creation_time	string الطابع الزمني لوقت إنشاء حساب هذا العميل. يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
manager_id	int64 رقم تعريف العميل الخاص بالحساب الإداري تشير القيمة 0 إلى أنّ العميل ليس لديه حساب إداري على "إعلانات شبكة البحث 360".
manager_descriptive_name	string تمثّل هذه السمة الاسم الوصفي للمدير.
sub_manager_id	int64 رقم تعريف العميل الخاص بحساب المدير الفرعي. تشير القيمة 0 إلى أنّ العميل ليس لديه حساب مدير فرعي على "إعلانات شبكة البحث 360".
sub_manager_descriptive_name	string تمثّل هذه السمة الاسم الوصفي لحساب المدير الفرعي.
associate_manager_id	int64 رقم تعريف العميل الخاص بحساب المدير الشريك تشير القيمة 0 إلى أنّ العميل ليس لديه حساب مدير شريك في "إعلانات شبكة البحث 360".
associate_manager_descriptive_name	string تمثّل هذه السمة الاسم الوصفي لحساب المدير الشريك.
account_level	AccountLevelType مستوى حساب العميل: حساب إداري أو حساب مدير فرعي أو حساب مدير شريك أو حساب خدمة
id	int64 معرّف العميل.
descriptive_name	string اسم وصفي اختياري غير فريد للعميل
currency_code	string العملة التي يعمل بها الحساب. يتوفّر جزء من رموز العملات من معيار ISO 4217.
time_zone	string رقم تعريف المنطقة الزمنية المحلية للعميل
tracking_url_template	string نموذج عنوان URL لإنشاء عنوان URL للتتبّع من المَعلمات
final_url_suffix	string نموذج عنوان URL لإلحاق المَعلمات بعنوان URL النهائي
auto_tagging_enabled	bool تحدّد هذه السمة ما إذا كان وضع العلامات التلقائي مفعّلاً للعميل.
manager	bool تُستخدَم لتحديد ما إذا كان العميل مديرًا.

CustomerAsset

رابط بين عميل ومادة عرض

الحقول
resource_name	string اسم المورد الخاص بمادة عرض العميل تكون أسماء موارد CustomerAsset على النحو التالي: customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset	string الحقل مطلوب. مادة العرض المرتبطة بالعميل
status	AssetLinkStatus تمثّل هذه السمة حالة مادة عرض العميل.

CustomerAssetSet

‫CustomerAssetSet هي عملية الربط بين العميل ومجموعة مواد العرض. تؤدي إضافة CustomerAssetSet إلى ربط مجموعة مواد عرض بعميل.

الحقول
resource_name	string اسم المورد لمجموعة مواد عرض العميل تتّخذ أسماء موارد مجموعة مواد العرض الشكل التالي: customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set	string مجموعة مواد العرض المرتبطة بالعميل
customer	string العميل الذي ترتبط به مجموعة مواد العرض هذه.
status	AssetSetLinkStatus حالة مادة عرض مجموعة مواد عرض العملاء للقراءة فقط.

CustomerClient

رابط بين العميل المحدّد وعميل آخر لا تتوفّر CustomerClients إلا لعملاء الحساب الإداري. يتم تضمين جميع عملاء الحسابات المرتبطة مباشرةً وغير مباشرةً، بالإضافة إلى الحساب الإداري نفسه.

الحقول
resource_name	string اسم المورِد الخاص بحساب العميل تتّخذ أسماء موارد CustomerClient الشكل التالي: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]	string أسماء موارد التصنيفات التي يملكها العميل الذي يقدّم الطلب والتي يتم تطبيقها على حساب العميل. تكون أسماء مصادر التصنيفات على النحو التالي: customers/{customer_id}/labels/{label_id}
status	CustomerStatus حالة العميل. للقراءة فقط.
client_customer	string اسم المورِد الخاص بالعميل المرتبط بالعميل المحدّد للقراءة فقط.
hidden	bool تحدِّد هذه السمة ما إذا كان هذا الحساب مخفيًا. للقراءة فقط.
level	int64 المسافة بين العميل المحدّد والعميل. بالنسبة إلى الرابط الذاتي، ستكون قيمة المستوى 0. للقراءة فقط.
time_zone	string تمثيل السلسلة في Common Locale Data Repository (CLDR) للمنطقة الزمنية للعميل، على سبيل المثال، America/Los_Angeles. للقراءة فقط.
test_account	bool تحدّد ما إذا كان حساب العميل حسابًا اختباريًا. للقراءة فقط.
manager	bool تحدّد ما إذا كان العميل مديرًا. للقراءة فقط.
descriptive_name	string اسم وصفي للعميل. للقراءة فقط.
currency_code	string رمز العملة (على سبيل المثال، "USD" أو "EUR") للعميل للقراءة فقط.
id	int64 معرّف العميل. للقراءة فقط.

CustomerManagerLink

تمثّل هذه السمة علاقة الربط بين حساب العميل وحساب المدير.

الحقول
resource_name	string اسم المورد تتّخذ أسماء موارد CustomerManagerLink الشكل التالي: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
status	ManagerLinkStatus حالة الرابط بين العميل والمدير
manager_customer	string حساب العميل الإداري المرتبط بحساب العميل
manager_link_id	int64 معرّف رابط حساب العميل بحساب المدير هذا الحقل مخصّص للقراءة فقط.
start_time	string الطابع الزمني لوقت إنشاء CustomerManagerLink. يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".

DoubleClickCampaignManagerSetting

إعداد DoubleClick Campaign Manager (DCM) لحساب عميل إداري

الحقول
advertiser_id	int64 رقم تعريف المعلِن في "مدير الحملة" المرتبط بهذا العميل.
network_id	int64 رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا العميل.
time_zone	string المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بهذا العميل بتنسيق قاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA)، مثل America/New_York.

DynamicSearchAdsSearchTermView

عرض لعبارة بحث في "الإعلانات الديناميكية على شبكة البحث"

الحقول
resource_name	string اسم مصدر طريقة عرض عبارات البحث للإعلانات الديناميكية على شبكة البحث تتّخذ أسماء موارد "عبارات البحث" في "الإعلانات الديناميكية على شبكة البحث" الشكل التالي: customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page	string عنوان URL للصفحة المقصودة التي تم اختيارها ديناميكيًا لمرّة الظهور هذا الحقل مخصّص للقراءة فقط.

GenderView

تمثّل هذه السمة مصدر بيانات لعرض الجنس. تمثّل هذه السمة عرضًا لمقاييس أداء العميل مجمّعة حسب الجنس. يتم تجميع جميع الإحصاءات على مستوى المجموعة الإعلانية.

ملاحظة: على الرغم من أنّه يمكنك تقسيم المقاييس حسب الفئة العمرية باستخدام age_range_view أو حسب الجنس باستخدام gender_view، لا يتيح Search Ads 360 API تقسيم المقاييس حسب الفئة العمرية والجنس في الوقت نفسه في طلب بحث واحد. لا يتيح Search Ads 360 API تحليل الأداء على مستوى كلا السمتَين معًا.

الحقول
resource_name	string تمثّل هذه السمة اسم مصدر عرض الجنس. تتّخذ أسماء موارد عرض الجنس الشكل التالي: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

ثابت استهداف جغرافي

الحقول
resource_name	string اسم مصدر ثابت الاستهداف الجغرافي تتّخذ أسماء موارد ثوابت الاستهداف الجغرافي الشكل التالي: geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus حالة ثابتة للاستهداف الجغرافي
id	int64 رقم تعريف ثابت الاستهداف الجغرافي.
name	string الاسم الإنجليزي لثابت الاستهداف الجغرافي
country_code	string تمثّل هذه السمة رمز البلد وفقًا لمعيار ISO-3166-1 alpha-2 والمرتبط بالهدف.
target_type	string نوع الاستهداف الثابت للموقع الجغرافي المستهدَف
canonical_name	string الاسم الإنجليزي المؤهَّل بالكامل، ويتألف من اسم الهدف واسم العنصر الرئيسي والبلد.
parent_geo_target	string اسم مصدر ثابت الاستهداف الجغرافي الرئيسي. تكون أسماء موارد ثوابت الاستهداف الجغرافي على النحو التالي: geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

عرض الكلمات الرئيسية

الحقول
resource_name	string اسم المورِد الخاص بطريقة عرض الكلمات الرئيسية. تتّخذ أسماء موارد عرض الكلمات الرئيسية الشكل التالي: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

التصنيف

تصنيف

الحقول
resource_name	string اسم المورد تتّخذ أسماء موارد التصنيفات الشكل التالي: customers/{owner_customer_id}/labels/{label_id}
status	LabelStatus حالة التصنيف للقراءة فقط.
text_label	TextLabel نوع من التصنيفات يعرض نصًا على خلفية ملونة
id	int64 رقم تعريف التصنيف للقراءة فقط.
name	string اسم التصنيف هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء تصنيف جديد. يجب أن يتراوح طول هذه السلسلة بين 1 و80 حرفًا، بما في ذلك القيمتان.

LanguageConstant

لغة

الحقول
resource_name	string اسم مورد ثابت اللغة. تكون أسماء موارد ثوابت اللغة على النحو التالي: languageConstants/{criterion_id}
id	int64 رقم تعريف ثابت اللغة.
code	string رمز اللغة، مثلاً، "en_US" أو "en_AU" أو "es" أو "fr" أو غير ذلك
name	string الاسم الكامل للغة بالإنجليزية، مثلاً "الإنجليزية (الولايات المتحدة)" أو "الإسبانية" وما إلى ذلك
targetable	bool تُستخدَم لتحديد ما إذا كانت اللغة قابلة للاستهداف.

ListingGroupFilterDimension

سمات البيانات لفلتر مجموعة البيانات في مجموعة مواد العرض

الحقول
حقل الربط dimension تتوفّر دائمًا سمة من أحد الأنواع أدناه. يمكن أن يكون التعليق dimension إحدى القيم التالية فقط:
product_bidding_category	ProductBiddingCategory تمثّل هذه السمة فئة عروض الأسعار الخاصة بعرض منتج.
product_brand	ProductBrand تمثّل هذه السمة العلامة التجارية لعرض المنتج.
product_channel	ProductChannel تمثّل هذه السمة المنطقة الجغرافية التي يتوفّر فيها عرض المنتج.
product_condition	ProductCondition تمثّل هذه السمة حالة عرض المنتج.
product_custom_attribute	ProductCustomAttribute تمثّل هذه السمة سمة مخصّصة لعرض منتج.
product_item_id	ProductItemId معرّف السلعة لعرض المنتج.
product_type	ProductType تمثّل هذه السمة نوع عرض المنتج.

ProductBiddingCategory

أحد عناصر فئة عروض الأسعار على مستوى معيّن تكون الفئات ذات المستوى الأعلى في المستوى 1، والفئات الفرعية في المستوى 2، وهكذا. يمكننا حاليًا عرض ما يصل إلى 5 مستويات. على المستخدم تحديد نوع سمة يشير إلى مستوى الفئة. يجب أن يكون لجميع حالات التقسيم الفرعي نفسه نوع البُعد نفسه (مستوى الفئة).

الحقول
level	ListingGroupFilterBiddingCategoryLevel تشير إلى مستوى الفئة في التصنيف.
id	int64 معرّف فئة عروض أسعار المنتجات هذا المعرّف يعادل معرّف google_product_category على النحو الموضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436

ProductBrand

تمثّل هذه السمة العلامة التجارية للمنتج.

الحقول
value	string قيمة السلسلة الخاصة بالعلامة التجارية للمنتج

ProductChannel

تمثّل هذه السمة المنطقة الجغرافية التي يتوفّر فيها عرض المنتج.

الحقول
channel	ListingGroupFilterProductChannel تمثّل هذه السمة قيمة المنطقة المحلية.

ProductCondition

تمثّل هذه السمة حالة عرض المنتج.

الحقول
condition	ListingGroupFilterProductCondition قيمة الحالة

ProductCustomAttribute

تمثّل هذه السمة سمة مخصّصة لعرض منتج.

الحقول
index	ListingGroupFilterCustomAttributeIndex تشير إلى فهرس السمة المخصّصة.
value	string قيمة السلسلة لسمة المنتج المخصّصة.

ProductItemId

معرّف السلعة لعرض المنتج.

الحقول
value	string قيمة المعرّف

ProductType

تمثّل هذه السمة نوع عرض المنتج.

الحقول
level	ListingGroupFilterProductTypeLevel مستوى النوع.
value	string قيمة النوع

ListingGroupFilterDimensionPath

المسار الذي يحدّد سمات تحدّد فلتر مجموعة بيانات.

الحقول
dimensions[]	ListingGroupFilterDimension المسار الكامل للسمات من خلال العرض الهرمي لفلتر مجموعة بيانات المؤسسة (باستثناء العقدة الجذرية) إلى فلتر مجموعة بيانات المؤسسة هذا.

LocationView

تُلخّص طريقة عرض الموقع الجغرافي أداء الحملات حسب معيار الموقع الجغرافي.

الحقول
resource_name	string اسم المورد الخاص بطريقة عرض الموقع الجغرافي. تكون أسماء موارد "عرض الموقع الجغرافي" على النحو التالي: customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

فئة عروض أسعار المنتجات

الحقول
resource_name	string اسم المرجع لفئة عروض أسعار المنتجات تتّخذ أسماء موارد فئات عروض أسعار المنتجات الشكل التالي: productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel مستوى فئة عروض أسعار المنتجات.
status	ProductBiddingCategoryStatus حالة فئة عروض أسعار المنتجات.
id	int64 معرّف فئة عروض أسعار المنتجات هذا المعرّف يعادل معرّف google_product_category على النحو الموضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436.
country_code	string رمز البلد المكوّن من حرفَين كبيرَين لفئة عروض أسعار المنتجات
product_bidding_category_constant_parent	string اسم المرجع لفئة عروض أسعار المنتج الرئيسي
language_code	string رمز اللغة لفئة عروض أسعار المنتجات
localized_name	string تعرِض هذه السمة قيمة فئة عروض أسعار المنتجات المترجمة حسب language_code.

ProductGroupView

طريقة عرض مجموعة المنتجات

الحقول
resource_name	string اسم المورد الخاص بطريقة عرض مجموعة المنتجات. تتّخذ أسماء موارد عرض مجموعات المنتجات الشكل التالي: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

حقل أو مرجع (عنصر) تستخدمه SearchAds360Service.

الحقول
resource_name	string اسم مصدر العنصر. تكون أسماء موارد العناصر الاصطناعية على النحو التالي: SearchAds360Fields/{name}
category	SearchAds360FieldCategory تمثّل هذه السمة فئة العنصر.
selectable_with[]	string أسماء جميع المراجع والأقسام والمقاييس التي يمكن اختيارها باستخدام العنصر الموصوف
attribute_resources[]	string أسماء جميع المراجع التي يمكن اختيارها باستخدام العنصر الموصوف لا تقسّم الحقول من هذه المراجع المقاييس عند تضمينها في طلبات البحث. يتم ضبط هذا الحقل فقط للعناصر التي تنتمي إلى الفئة RESOURCE.
metrics[]	string يسرد هذا الحقل أسماء جميع المقاييس التي يمكن تحديدها باستخدام العنصر الموصوف عند استخدامه في عبارة FROM. يتم ضبطها فقط للعناصر التي تكون فئتها RESOURCE.
segments[]	string يسرد هذا الحقل أسماء جميع العناصر، سواء كانت شريحة أو موردًا آخر، التي تقيس مقاييس الشريحة عند تضمينها في طلبات البحث وعند استخدام العنصر الموصوف في عبارة FROM. يتم ضبطها فقط للعناصر التي تكون فئتها RESOURCE.
enum_values[]	string القيم التي يمكن أن يفترضها العنصر إذا كان حقلاً من النوع ENUM يتم ضبط هذا الحقل فقط لعناصر الفئة SEGMENT أو ATTRIBUTE.
data_type	SearchAds360FieldDataType يحدّد هذا الحقل عوامل التشغيل التي يمكن استخدامها مع العنصر في عبارات WHERE.
name	string تمثّل هذه السمة اسم الأثر.
selectable	bool تُستخدَم لتحديد ما إذا كان يمكن استخدام العنصر في جملة SELECT في طلبات البحث.
filterable	bool تحديد ما إذا كان يمكن استخدام العنصر في عبارة WHERE في طلبات البحث
sortable	bool تحدّد هذه السمة ما إذا كان يمكن استخدام العنصر في عبارة ORDER BY في طلبات البحث.
type_url	string عنوان URL لملف proto الذي يصف نوع بيانات العنصر.
is_repeated	bool ما إذا كان عنصر الحقل متكرّرًا

ShoppingPerformanceView

عرض أداء التسوّق

تقدّم إحصاءات "حملات تسوّق" و"حملات الأداء الأفضل" مجمّعة على مستوى عدّة سمات للمنتجات. ستعرض قيم سمات المنتجات من Merchant Center، مثل العلامة التجارية والفئة والسمات المخصّصة وحالة المنتج ونوعه، حالة كل سمة في التاريخ والوقت اللذين تم فيهما تسجيل الحدث ذي الصلة.

قد يختلف عدد مرّات الظهور والنقرات التي تعرض shopping_performance_view إحصاءات لها عن تقارير الحملة. تعرض shopping_performance_view مرّات الظهور والنقرات على المنتجات التي تظهر في الإعلانات، بينما تعرض تقارير الحملات مرّات الظهور والنقرات على الإعلانات نفسها. استنادًا إلى الشكل، يمكن أن يعرض الإعلان عددًا من المنتجات يتراوح بين صفر وعدة منتجات، لذا قد لا تتطابق الأرقام.

في واجهة مستخدم "إعلانات شبكة البحث 360"، يمكنك طلب مرات الظهور والنقرات على المنتجات التي تظهر في الإعلانات من خلال اختيار عمود من "سمات المنتج" في "محرِّر التقارير". على سبيل المثال، اختيار عمود "العلامة التجارية" يعادل اختيار segments.product_brand.

الحقول
resource_name	string تمثّل هذه السمة اسم مورد طريقة عرض "أداء التسوّق". تتّخذ أسماء موارد طريقة عرض أداء التسويق الشكل التالي: customers/{customer_id}/shoppingPerformanceView

UserList

قائمة مستخدمين هذه قائمة بالمستخدمين الذين يمكن للعميل استهدافهم. يتألف المفتاح الفريد لقائمة مستخدمين من الحقول التالية: id. يُرجى العِلم أنّ name يجب أن يكون فريدًا أيضًا لقوائم المستخدِمين التي يملكها عميل معيّن، باستثناء بعض الحالات التي يتم فيها ضبط access_reason على SHARED. يؤدي انتهاك شرط الاسم الفريد إلى ظهور الخطأ: UserListError.INVALID_NAME.

الحقول
resource_name	string اسم المورد لقائمة المستخدِمين تتّخذ أسماء موارد قوائم المستخدِمين الشكل التالي: customers/{customer_id}/userLists/{user_list_id}
type	UserListType تمثّل هذه السمة نوع القائمة. هذا الحقل مخصّص للقراءة فقط.
id	int64 معرّف قائمة المستخدمين.
name	string اسم قائمة المستخدمين هذه فريدة لكل قائمة مستخدمين، باستثناء بعض الحالات التي تكون فيها قائمة مستخدمين بالاسم نفسه مضبوطة على access_reason SHARED.

UserLocationView

طريقة عرض الموقع الجغرافي للمستخدم

يتضمّن "عرض الموقع الجغرافي للمستخدم" جميع المقاييس المجمّعة على مستوى البلد، مع صف واحد لكل بلد. يعرِض هذا التقرير المقاييس في الموقع الجغرافي الفعلي للمستخدم حسب الموقع الجغرافي المستهدَف أو غير المستهدَف. في حال استخدام حقول شرائح أخرى، قد تحصل على أكثر من صف واحد لكل بلد.

الحقول
resource_name	string اسم المورد الخاص بطريقة عرض المواقع الجغرافية للمستخدمين تتّخذ أسماء موارد طريقة العرض UserLocation الشكل التالي: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id	int64 رقم تعريف المعيار الخاص بالبلد.
targeting_location	bool توضّح هذه السمة ما إذا كان الموقع الجغرافي مستهدفًا أم لا.

زيارة

زيارة

الحقول
resource_name	string تمثّل هذه السمة اسم المورد الخاص بالزيارة. تتّخذ أسماء الموارد في عناوين URL الشكل التالي: customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 معرّف الزيارة.
criterion_id	int64 رقم تعريف الكلمة الرئيسية في "إعلانات شبكة البحث 360" تشير القيمة 0 إلى أنّ الكلمة الرئيسية غير محدّدة المصدر.
merchant_id	int64 رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360".
ad_id	int64 معرّف الإعلان تشير القيمة 0 إلى أنّ الإعلان غير محدّد المصدر.
click_id	string سلسلة فريدة لكل زيارة يتمّ تمريرها إلى الصفحة المقصودة كمَعلمة عنوان URL لمعرّف النقرة.
visit_date_time	string الطابع الزمني لحدث الزيارة يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
product_id	string معرّف المنتج الذي تم النقر عليه.
product_channel	ProductChannel قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو في المتجر المحلي
product_language_code	string اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center التي تحتوي على بيانات حول المنتج
product_store_id	string المتجر الذي تم النقر عليه في "إعلان للمنتجات داخل المتجر" يجب أن تتطابق هذه السمة مع معرّفات المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلية.
product_country_code	string تمثّل هذه السمة البلد (بتنسيق ISO-3166) المسجَّل لخلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه.
asset_id	int64 رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الزيارة
asset_field_type	AssetFieldType نوع حقل مادة العرض لحدث الزيارة.

WebpageView

مشاهدة صفحة ويب

الحقول
resource_name	string اسم المورد الخاص بمشاهدة صفحة الويب تتّخذ أسماء موارد مشاهدات صفحات الويب الشكل التالي: customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}