Package google.ads.searchads360.v0.resources

الفهرس

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

مادة عرض موحّدة لوسائل الشرح
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_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

معرّف العميل. للقراءة فقط.

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}