Package google.ads.searchads360.v0.resources

الفهرس

AccessibleBiddingStrategy

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

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

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

segmentation_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

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

MaximizeConversions

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

الحقول
target_cpa

int64

خيار التكلفة المستهدفة للإجراء (CPA). هذا هو متوسط المبلغ الذي تريد إنفاقه لكل اكتساب.
target_cpa_micros

int64

خيار التكلفة المستهدفة للإجراء (CPA). هذا هو متوسط المبلغ الذي تريد إنفاقه لكل اكتساب.

TargetCpa

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

الحقول
target_cpa_micros

int64

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

TargetImpressionShare

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

الحقول
location

TargetImpressionShareLocation

الموقع الجغرافي المستهدَف على صفحة نتائج البحث.
location_fraction_micros

int64

الجزء المختار من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدف بوحدات المايكرو. على سبيل المثال، 1% تساوي 10000.
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 النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان.
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

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

string

رقم تعريف المجموعة الإعلانية في حساب محرّك البحث الخارجي. هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "ad_group.id" بدلاً من ذلك.
start_date

string

التاريخ الذي تبدأ فيه هذه المجموعة الإعلانية في عرض الإعلانات. بشكلٍ تلقائي، تبدأ المجموعة الإعلانية الآن أو تاريخ بدء المجموعة الإعلانية، أيهما أبعد. إذا تم ضبط هذا الحقل، تبدأ المجموعة الإعلانية من بداية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook.

التنسيق: YYYY-MM-DD مثال: 14-03-2019
end_date

string

تاريخ انتهاء المجموعة الإعلانية عن عرض الإعلانات. بشكل تلقائي، تنتهي المجموعة الإعلانية في تاريخ انتهاء المجموعة الإعلانية. وفي حال ضبط هذا الحقل، تنتهي المجموعة الإعلانية في نهاية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook.

التنسيق: YYYY-MM-DD مثال: 14-03-2019
language_code

string

لغة الإعلانات والكلمات الرئيسية في المجموعة الإعلانية. هذا الحقل متاح فقط لحسابات Microsoft Advertising. مزيد من التفاصيل: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على هذه المجموعة الإعلانية. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .
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 التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .
labels[]

string

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

string

رقم تعريف الإعلان في حساب محرّك البحث الخارجي. هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى الكيانات الأخرى في "إعلانات شبكة البحث 360"، استخدِم "ad_group_ad.ad.id" بدلاً من ذلك.
engine_status

AdGroupAdEngineStatus

الحالة الإضافية للإعلان في حساب محرّك البحث الخارجي. تشمل الحالات المحتملة (استنادًا إلى نوع الحساب الخارجي) حالة نشطة، أو مؤهَّلة، أو في انتظار المراجعة، أو غير ذلك.
last_modified_time

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على إعلان المجموعة الإعلانية. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

AdGroupAdLabel

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

الحقول
resource_name

string

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

string

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

string

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

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 وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث، المجمّعة على مستوى الجمهور.

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

حالة المعيار.

هذه هي حالة كيان معيار المجموعة الإعلانية التي ضبطها العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهَّلاً للتشغيل. في بعض الحالات، قد يستمر عرض معيار تمت إزالته في واجهة برمجة التطبيقات على أنّه مفعّل في واجهة المستخدم. على سبيل المثال، تظهر الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادها. ستظهَر واجهة المستخدِم على أنّها "مفعَّلة" لكلّ فئة عمرية، لأنّهم مؤهَّلون لرؤية الإعلانات. لكن AdGroupCategory.status ستعرض "تمت الإزالة" بسبب عدم إضافة معيار موجب.
quality_info

QualityInfo

تمثّل هذه السمة معلومات حول جودة المعيار.
type

CriterionType

تمثّل هذه السمة نوع المعيار.
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

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على معيار المجموعة الإعلانية هذا. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .
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 معلومات كافية لتحديد قيمة.

AdGroupCriterionLabel

يشير ذلك المصطلح إلى علاقة بين معيار مجموعة إعلانية وتصنيف.

الحقول
resource_name

string

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

string

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

string

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

AdGroupLabel

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

الحقول
resource_name

string

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

string

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

string

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

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

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على مادة العرض هذه التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .
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

إعداد التحكّم في الإعلانات الديناميكية على شبكة البحث (DSA).
shopping_setting

ShoppingSetting

إعداد التحكّم في حملات Shopping.
geo_target_type_setting

GeoTargetTypeSetting

إعداد الاستهداف الجغرافي للإعلانات.
labels[]

string

أسماء موارد التصنيفات المرفقة بهذه الحملة.
bidding_strategy_type

BiddingStrategyType

نوع استراتيجية عروض الأسعار.

يمكن إنشاء استراتيجية عروض أسعار من خلال ضبط نظام عروض الأسعار لإنشاء استراتيجية عروض أسعار عادية أو الحقل bidding_strategy لإنشاء استراتيجية محفظة لعروض الأسعار.

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

string

اسم المورد لاستراتيجية الوصول إلى عروض الأسعار، وهو عرض للقراءة فقط للسمات غير المحظورة ضمن استراتيجية المحفظة لعروض الأسعار المرفقة التي تم تحديدها من خلال "Bid_strategy". فارغة، إذا كانت الحملة لا تستخدم استراتيجية محفظة. تتوفّر سمات الاستراتيجيات غير المحظورة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويمكن الاطّلاع عليها من خلال مرجع Accessible 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 وBidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "campaign.id" بدلاً من ذلك.
excluded_parent_asset_field_types[]

AssetFieldType

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

string

الطابع الزمني لوقت إنشاء هذه الحملة. يظهر الطابع الزمني في المنطقة الزمنية للعميل بالتنسيق "yyyy-MM-dd HH:mm:ss" . سيتم إيقاف create_time نهائيًا في الإصدار 1. يُرجى استخدام create_time بدلاً من ذلك.
creation_time

string

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

string

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

string

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

bool

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

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

إعداد التحكّم في الإعلانات الديناميكية على شبكة البحث (DSA).

الحقول
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. هذا الحقل مطلوب لعمليات الإنشاء. هذا الحقل غير قابل للتغيير لحملات التسوّق.
sales_country

string

بلد مبيعات المنتجات المطلوب تضمينها في الحملة
campaign_priority

int32

أولوية الحملة. وتحظى الحملات ذات الأولوية الأعلى عدديًا بالأولوية على الحملات ذات الأولوية الأقل. هذا الحقل مطلوب لحملات التسوّق، ذات القيم بين 0 و2، بشكل شامل. هذا الحقل اختياري لحملات التسوّق الذكية، ولكن يجب أن يساوي 3 في حال ضبطه.
enable_local

bool

تحديد ما إذا كان سيتم تضمين المنتجات المحلية.

TrackingSetting

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

الحقول
tracking_url

string

عنوان URL المستخدَم للتتبّع الديناميكي.

CampaignAsset

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

الحقول
resource_name

string

اسم المورد لمادة عرض الحملة وتكون أسماء موارد مواد العرض الخاصة بالحملة على النحو التالي:

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، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث، المجمّعة حسب معيار الحملة والجمهور. لا تتضمّن طريقة العرض هذه سوى شرائح الجمهور المرفقة على مستوى الحملة.

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

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على معيار هذه الحملة. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .
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

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

CampaignLabel

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

الحقول
resource_name

string

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

string

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

string

التصنيف المعيَّن للحملة.

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" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، تساوي هذه القيمة عمود رقم التعريف أو عمود 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

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

رقم تعريف تتبُّع الإحالات الناجحة لمدير العميل. ويتم ضبط هذا الإعداد عندما يكون العميل مفعَّلاً في ميزة تتبُّع الإحالات الناجحة، ويتم إلغاء هذا الإجراء. لا يمكن إدارة هذا الحقل إلا من خلال واجهة مستخدم "إعلانات Google". هذا الحقل للقراءة فقط.
cross_account_conversion_tracking_id

int64

رقم تعريف تتبُّع الإحالات الناجحة لمدير العميل. ويتم ضبط هذا الإعداد عندما يكون العميل قد فعّل ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ويتم إلغاء هذه الميزة عند تفعيل ميزة تتبُّع الإحالات الناجحة.

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.impression"}.

العميل

عميل.

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

التاريخ والوقت الذي تم فيه إجراء آخر تعديل لهذا العميل. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .
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

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

الحقول
resource_name

string

اسم المورد للعميل العميل. تكون أسماء موارد العميل على النحو التالي: 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

تمثيل سلسلة مستودع بيانات اللغة المشتركة (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

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

الحقول
level

ListingGroupFilterBiddingCategoryLevel

ويشير إلى مستوى الفئة في التصنيف.
id

int64

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

يعادل هذا المعرّف معرّف فئة المنتجات من Google كما هو موضّح في هذه المقالة: 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. ويتم ضبطه فقط للعناصر التي تكون فئتها هي "مورد".
segments[]

string

يسرد هذا الحقل أسماء جميع العناصر، سواء كانت شريحة أو موردًا آخر، هي مقاييس الشريحة عند تضمينها في طلبات البحث وعند استخدام العنصر الموصوف في عبارة FROM. ويتم ضبطه فقط للعناصر التي تكون فئتها هي "المورد".
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 الخاص بالنموذج الأولي الذي يصف نوع بيانات العنصر.
is_repeated

bool

ما إذا كان العنصر قد تم تكراره في الحقل

ShoppingPerformanceView

عرض أداء التسوّق. توفّر إحصاءات حملات 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=SHARED).

زيارة

زيارة.

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