Package google.ads.searchads360.v0.resources

الفهرس

AccessibleBiddingStrategy

تمثّل عرضًا لـ "استراتيجيات عروض الأسعار" التي يملكها العميل ويشاركها معه.

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

الحقول
resource_name

string

اسم المورد لاستراتيجية عروض الأسعار التي يمكن الوصول إليها تكون أسماء موارد AccessibleServicesStrategy على النحو التالي:

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

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

الحقول
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

الإنفاق المستهدَف الذي يتمّ من خلاله زيادة النقرات إلى أقصى حدّ سيحاول مقدّم عروض أسعار TargetSpend إنفاق القيمة الأصغر من هذه القيمة أو مبلغ الإنفاق الطبيعي الذي تمّ تقييده. في حال عدم تحديدها، يتم استخدام الميزانية كمستهدف الإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه. اطّلِع على 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 النهائية المحتمَلة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان
type

AdType

نوع الإعلان.
id

int64

رقم تعريف الإعلان.
display_url

string

عنوان URL الذي يظهر في وصف الإعلان لبعض أشكال الإعلانات.
name

string

اسم الإعلان. لا يُستخدَم هذا الإجراء إلّا للتعرّف على الإعلان. ولا يلزم أن يكون فريدًا ولا يؤثّر في الإعلان المعروض. لا يتوفّر حقل الاسم حاليًا إلا لأنواع الإعلانات DisplayUploadAd وImageAd وShoppingComparisonListingAd وVideoAd.
حقل الاتحاد ad_data. التفاصيل ذات الصلة بنوع الإعلان. يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون ad_data واحدًا فقط مما يلي:
text_ad

SearchAds360TextAdInfo

تفاصيل تتعلّق بإعلان نصي
expanded_text_ad

SearchAds360ExpandedTextAdInfo

تفاصيل تتعلّق بإعلان نصي موسّع
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).
cpc_bid_micros

int64

عرض السعر الأقصى للنقرة.
engine_status

AdGroupEngineStatus

حالة المحرّك للمجموعة الإعلانية.

AdGroupAd

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

الحقول
resource_name

string

اسم مورد الإعلان. يكون لأسماء موارد الإعلانات للمجموعات الإعلانية الشكل التالي:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status

AdGroupAdStatus

حالة الإعلان.
ad

Ad

الإعلان.
creation_time

string

الطابع الزمني لوقت إنشاء ad_group_ad هذا. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
labels[]

string

أسماء موارد التصنيفات المرفقة بإعلان المجموعة الإعلانية هذا.
effective_labels[]

string

أسماء موارد التصنيفات الفعّالة المرفقة بهذا الإعلان. التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذا الإعلان.
engine_id

string

رقم تعريف الإعلان في حساب محرّك البحث الخارجي هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى الكيانات الأخرى في "إعلانات شبكة البحث 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/{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/{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. يتراوح النطاق بين 1.0 و6.0 لعنصر PreferredContent. استخدِم القيمة 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 "تمت الإزالة"، بما أنه لم تتم إضافة معيار إيجابي.
quality_info

QualityInfo

معلومات حول جودة المعيار
type

CriterionType

تمثّل هذه السمة نوع المعيار.
labels[]

string

أسماء موارد التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا.
effective_labels[]

string

أسماء الموارد للتسميات الفعّالة المرتبطة بمعيار المجموعة الإعلانية هذا. التصنيف الفعّال هو تصنيف مكتسب أو تم تعيينه مباشرةً لمعيار المجموعة الإعلانية هذا.
position_estimates

PositionEstimates

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

string

قائمة عناوين URL النهائية المحتمَلة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان
engine_id

string

رقم تعريف معيار المجموعة الإعلانية في حساب المحرّك الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات 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

الموقع الجغرافي.

تقديرات_المواقع

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

الحقول
top_of_page_cpc_micros

int64

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

QualityInfo

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

الحقول
quality_score

int32

نقاط الجودة

قد لا تتم تعبئة هذا الحقل إذا لم تتوفر لدى Google معلومات كافية لتحديد قيمة.

AdGroupCriterionEffectiveLabel

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

الحقول
resource_name

string

اسم المورد للتصنيف الفعال لمعيار المجموعة الإعلانية. تكون أسماء موارد التصنيفات الفعّالة لمعيار المجموعة الإعلانية على النحو التالي: customers/{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/{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/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group

string

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

string

التصنيف الفعال المعيّن للمجموعة الإعلانية.
owner_customer_id

int64

رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupLabel

علاقة بين مجموعة إعلانية وتصنيف.

الحقول
resource_name

string

اسم المورد لتصنيف المجموعة الإعلانية. يكون شكل أسماء موارد تصنيفات المجموعات الإعلانية على النحو التالي: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group

string

المجموعة الإعلانية التي تم إرفاق التصنيف بها.
label

string

التصنيف الذي تمّ تعيينه للمجموعة الإعلانية.
owner_customer_id

int64

رقم تعريف العميل الذي يملك التصنيف.

AgeRangeView

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

الحقول
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 النهائية المحتمَلة بعد جميع عمليات إعادة التوجيه عبر النطاقات
status

AssetStatus

حالة مادة العرض
creation_time

string

الطابع الزمني لوقت إنشاء مادة العرض هذه يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
last_modified_time

string

التاريخ والوقت اللذان تمّ فيهما تعديل مادة العرض هذه آخر مرة يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
id

int64

رقم تعريف مادة العرض
name

string

اسم اختياري لمادة العرض
tracking_url_template

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

مطلوب. اسم مجموعة مواد العرض. مطلوب. يجب ألا يقل طولها عن 1 حرف وألا يزيد عن 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

اسم المورد لعرض أفضل تركيبة لمجموعة مواد العرض. ويكون أسماء موارد عرض النسخة الأفضل في AssetGroup على النحو التالي: `"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).

بالنسبة إلى استراتيجيات عروض الأسعار في العملاء الإداريين، تكون هذه هي العملة التي يحدّدها المعلِن عند إنشاء الاستراتيجية. بالنسبة إلى العملاء، يكون هذا الرمز هو currency_code للعميل.

يتم تسجيل مقاييس استراتيجية عروض الأسعار بهذه العملة.

هذا الحقل للقراءة فقط.
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. فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة تتوفّر سمات الاستراتيجيات غير المحظورة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويمكن الاطّلاع عليها في مرجع AccessibleBudgetStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا لمالك الاستراتيجية ومدراءه. لا يمكن قراءة السمات المحظورة إلا من مورد 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".
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. عند الإنشاء، يكون الإعداد التلقائي هو ‎30-12-2037، ما يعني أنّ الحملة ستستمر إلى أجل غير مسمى. لضبط حملة حالية على عرض الإعلانات إلى أجل غير مسمى، اضبط هذا الحقل على ‎30-12-2037.
final_url_suffix

string

اللاحقة المستخدَمة لإلحاق مَعلمات طلبات البحث بالصفحات المقصودة التي يتم عرضها باستخدام التتبّع الموازي
url_expansion_opt_out

bool

يمثّل ذلك إيقاف توسيع عنوان URL ليشمل عناوين URL أكثر استهدافًا. في حال إيقاف هذه الميزة (صحيح)، يتم استهداف عناوين URL النهائية فقط في مجموعة مواد العرض أو عناوين URL المحدّدة في خلاصات Google Merchant Center أو خلاصات بيانات النشاط الإعلاني للمعلِن. في حال تفعيل الميزة (خطأ)، سيتم استهداف النطاق بأكمله. لا يمكن ضبط هذا الحقل إلّا في "حملات الأداء الأفضل"، حيث تكون القيمة التلقائية هي false.

حقل الربط campaign_bidding_strategy استراتيجية عروض الأسعار للحملة.

يجب أن تكون إما محفظة (تم إنشاؤها من خلال خدمة "استراتيجية عروض الأسعار") أو محفظة عادية مضمّنة في الحملة. يمكن أن يكون 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

مطلوب. رمز اللغة الذي يحدّد لغة النطاق، على سبيل المثال، "en".
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 أم لا. لا يتوفّر هذا الخيار إلا لبعض حسابات شركاء Google المحدّدة.

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

تصنيف الخلاصة للمنتجات المطلوب تضمينها في الحملة لا يمكن ضبط سوى حقل واحد من حقلَي feed_label أو sales_country. إذا تمّ استخدامه بدلاً من sales_country، سيقبل الحقل feed_label رموز البلدان بالتنسيق نفسه، مثل "XX". ويمكن أيضًا أن يكون أي سلسلة مستخدَمة لتصنيف الخلاصة في Google Merchant Center.
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

الفترة التي يتم خلالها إنفاق الميزانية. إعداد القيمة التلقائية على "يومي" إذا لم يتم تحديده.
amount_micros

int64

مبلغ الميزانية بالعملة المحلية للحساب. يتم تحديد المبلغ بالوحدات الميكرو، حيث يعادل مليون وحدة واحدة من العملة. ويبلغ الحد الأقصى للإنفاق الشهري 30.4 ضِعف هذا المبلغ.

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/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

الحملة التي تم إرفاق التصنيف الفعّال بها.
label

string

التصنيف الفعّال الذي تمّ تعيينه للحملة.
owner_customer_id

int64

رقم تعريف العميل الذي يملك التصنيف الفعّال.

CampaignLabel

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

الحقول
resource_name

string

اسم المورد تكون أسماء مصادر تصنيفات الحملات على النحو التالي: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign

string

الحملة التي تم إرفاق التصنيف بها.
label

string

التصنيف الذي تمّ تعيينه للحملة.
owner_customer_id

int64

معرّف العميل الذي يملك التصنيف.

CartDataSalesView

عرض مبيعات بيانات سلة التسوّق

الحقول
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" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، يكون هذا العمود مساويًا لعمود id أو عمود 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 qty. يتحمّل المعلِن مسؤولية تعبئة المَعلمة ديناميكيًا (مثل عدد السلع المُباعة في الإحالة الناجحة)، وإلا سيتم ضبطها تلقائيًا على 1.
conversion_revenue_micros

int64

الأرباح المعدَّلة بالميكرو لحدث الإحالة الناجحة. وسيكون دائمًا بعملة حساب عرض الإعلانات.
floodlight_original_revenue

int64

الأرباح الأصلية غير المتغيّرة المرتبطة بحدث Floodlight (بالعملة المحدّدة في التقرير الحالي)، قبل إجراء تعديلات على إعدادات عملة Floodlight
floodlight_order_id

string

رقم تعريف طلب Floodlight الذي يقدّمه المعلِن للإحالة الناجحة
status

ConversionStatus

حالة الإحالة الناجحة، إما "مُفعّلة" أو "تمت الإزالة".
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 للإجراء الإحالة الناجحة غير صحيح، لا يمكن تقديم عروض أسعار للإجراء الإحالة الناجحة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. ومع ذلك، لا تراعي أهداف الإحالات الناجحة المخصّصة السمة primary_for_goal، لذا إذا كانت الحملة تتضمّن هدف إحالة ناجحة مخصّصًا تم ضبطه باستخدام إجراء إحالة ناجحة primary_for_goal = false، سيظلّ بإمكانك تقديم عروض أسعار لهذا الإجراء. ستكون primary_for_goal صحيحة تلقائيًا في حال عدم ضبطها. في الإصدار V9، لا يمكن ضبط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" متبوعًا برقم أقل من ormequal إلى 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".
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

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

الحقول
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_view حالة العرض الفعّالة، بدلاً من المعايير التي تمت إضافتها. تظهر المجموعة الإعلانية التي لا تتضمّن معايير الجنس تلقائيًا لجميع الأجناس، وبالتالي تظهر جميع الأجناس فيgender_view مع إحصاءات.

الحقول
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/{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

أسماء جميع الموارد التي يمكن اختيارها باستخدام العنصر الموضّح لا تؤدي الحقول من هذه الموارد إلى تقسيم المقاييس عند تضمينها في طلبات البحث.

يتم ضبط هذا الحقل فقط للعناصر التي تكون فئتها هي "المورد".
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

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

الحقول
resource_name

string

اسم المورد لعرض أداء Shopping تكون أسماء المراجع لعرض أداء التسوّق على النحو التالي: customers/{customer_id}/shoppingPerformanceView

UserList

قائمة مستخدمين هذه قائمة بالمستخدمين الذين يمكن أن يستهدفهم العميل.

الحقول
resource_name

string

اسم المورد لقائمة المستخدمين يكون لأسماء موارد قائمة المستخدمين الشكل التالي:

customers/{customer_id}/userLists/{user_list_id}
type

UserListType

نوع هذه القائمة

هذا الحقل للقراءة فقط.
id

int64

رقم تعريف قائمة المستخدمين
name

string

اسم قائمة المستخدمين هذه. استنادًا إلى access_reason، قد لا يكون اسم قائمة المستخدمين فريدًا (على سبيل المثال، إذا كان 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

اسم المورد للزيارة. تكون أسماء مراجع الانتقال على النحو التالي:

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}