Package google.ads.searchads360.v0.resources

الفهرس

AccessibleBiddingStrategy

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

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

الحقول
resource_name

string

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

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

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

int64

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

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

التفاصيل المتعلّقة بإعلان ديناميكي موسَّع على شبكة البحث

AdGroup

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

الحقول
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 أو Baidu أو غير ذلك. وبالنسبة إلى كيان "إعلانات 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

تاريخ آخر تعديل لهذه المجموعة الإعلانية. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss".
id

int64

رقم تعريف المجموعة الإعلانية.
name

string

اسم المجموعة

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

ويجب أن يحتوي على أقل من 255 حرفًا بالعرض الكامل لترميز UTF-8.

ويجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 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:ssssss".
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:ssssss".

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

اسم المورد لمادة عرض المجموعة الإعلانية. تكون أسماء موارد المجموعة الإعلانية بالصيغة التالية:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group

string

مطلوبة. المجموعة الإعلانية التي ترتبط بها مادة العرض.
asset

string

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

AssetLinkStatus

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

AdGroupAssetSet

GroupAssetSet هي الرابط بين مجموعة إعلانية ومجموعة مواد عرض. عند إنشاء مجموعة مواد عرض مجموعة إعلانية، يتم ربط مجموعة مواد عرض بمجموعة إعلانية.

الحقول
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 معيار معدِّل عروض أسعار المجموعة الإعلانية هذا.

مطلوب في عمليات الإنشاء التي تبدأ بـ V5. يمكن أن يكون الحقل "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

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

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

التاريخ والوقت لآخر تعديل لمعيار المجموعة الإعلانية هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss".
criterion_id

int64

رقم تعريف المعيار.
ad_group

string

المجموعة الإعلانية التي ينتمي إليها المعيار.
negative

bool

تحديد ما إذا كان سيتم استهداف (false) أو استبعاد (true) المعيار.

هذا الحقل غير قابل للتغيير. لتبديل معيار من موجب إلى سالب، عليك إزالته ثم إعادة إضافته.
bid_modifier

double

معدِّل عرض السعر عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات.
cpc_bid_micros

int64

عرض سعر النقرة.
effective_cpc_bid_micros

int64

عرض سعر النقرة الفعّال.
engine_status

AdGroupCriterionEngineStatus

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

string

نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي
tracking_url_template

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع.

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

يجب ضبط واحد بالضبط. يمكن أن يكون الحقل "criterion" واحدًا فقط مما يلي:
keyword

KeywordInfo

الكلمة الرئيسية.
listing_group

ListingGroupInfo

مجموعة البيانات
age_range

AgeRangeInfo

الفئة العمرية.
gender

GenderInfo

الجنس.
user_list

UserListInfo

قائمة المستخدمين.
webpage

WebpageInfo

صفحة ويب
location

LocationInfo

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

PositionEstimates

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

الحقول
top_of_page_cpc_micros

int64

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

QualityInfo

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

الحقول
quality_score

int32

نقاط الجودة.

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

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

تمثّل هذه السمة تاريخ آخر تعديل لمادة العرض هذه. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm: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 المعروض في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط المسار 1.
ad_strength

AdStrength

إجمالي قوة الإعلان لمجموعة مواد العرض هذه.

AssetGroupAsset

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

الحقول
resource_name

string

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

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group

string

مجموعة مواد العرض التي تربطها مادة عرض مجموعة مواد العرض هذه.
asset

string

مادة العرض التي تربطها مادة عرض مجموعة مواد العرض هذه.
field_type

AssetFieldType

وصف موضع إعلان مادة العرض ضمن مجموعة مواد العرض. على سبيل المثال: HEADLINE وYOUTUBE_VIDEO وما إلى ذلك
status

AssetLinkStatus

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

AssetGroupAssetCombinationData

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

الحقول
asset_combination_served_assets[]

AssetUsage

مواد العرض المعروضة.

AssetGroupListingGroupFilter

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

الحقول
resource_name

string

اسم المصدر لفلتر مجموعة بيانات مجموعة مواد العرض يكون اسم مورد فلتر مجموعة بيانات مجموعة مواد العرض على النحو التالي:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group

string

مجموعة مواد العرض التي يشكّل فلتر مجموعة بيانات مجموعة مواد العرض هذا جزءًا منها.
id

int64

رقم تعريف ListingGroupFilter.
type

ListingGroupFilterType

نوع عقدة فلتر مجموعة البيانات.
vertical

ListingGroupFilterVertical

العمود الذي تمثله شجرة العُقد الحالية. يجب أن تنتمي جميع العُقد في نفس الشجرة إلى العمود نفسه.
case_value

ListingGroupFilterDimension

قيمة السمة التي تعمل بها مجموعة البيانات هذه على تحسين عنصرها الرئيسي. غير معرَّف للمجموعة الجذر.
parent_listing_group_filter

string

اسم المورد للقسم الفرعي لمجموعة البيانات الرئيسية. قيمة فارغة لعقدة فلتر مجموعة بيانات الجذر.
path

ListingGroupFilterDimensionPath

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

AssetGroupSignal

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

الحقول
resource_name

string

اسم المورد لإشارة مجموعة مواد العرض. يكون اسم مورد إشارة مجموعة مواد العرض على النحو التالي:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group

string

مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه.
حقل الاتحاد signal إشارة مجموعة مواد العرض. يمكن أن يكون الحقل "signal" واحدًا فقط مما يلي:
audience

AudienceInfo

إشارة الجمهور التي ستستخدِمها "حملة الأداء الأفضل"

AssetGroupTopCombinationView

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

الحقول
resource_name

string

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

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

إعداد التحكّم في حملات التسوّق.
geo_target_type_setting

GeoTargetTypeSetting

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

string

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

BiddingStrategyType

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

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

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

string

اسم مورّد Accessible BiddingStrategy (استراتيجية عروض الأسعار للوصول فقط)، وهو إعداد للقراءة فقط للسمات غير المشروطة لاستراتيجية المحفظة لعروض الأسعار المرفقة التي تم تحديدها من خلال " Bidding_strategy". هذا الحقل فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة. تتوفّر سمات الاستراتيجية غير المحدودة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويمكن الاطّلاع عليها من مرجع Accessible BiddingStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا للعميل مالك الاستراتيجية ومدرائه. لا يمكن قراءة السمات المحظورة إلا من مورد 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

string

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

string

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

int64

رقم تعريف الحملة.
name

string

اسم الحملة.

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

ويجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 0xA) أو أحرف الرجوع إلى أول السطر (رمز النقطة 0xD).
tracking_url_template

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع.
campaign_budget

string

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

string

تاريخ بدء الحملة في عرض المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD.
end_date

string

اليوم الأخير من الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD. وعند إنشاء الحملة، يتم ضبطها تلقائيًا على 2037-12-30، ما يعني أنّه سيتم عرض الحملة إلى أجل غير مسمى. لضبط حملة حالية من أجل عرضها إلى أجل غير مسمى، اضبط هذا الحقل على 2037-12-30.
final_url_suffix

string

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

bool

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

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

يجب أن تكون محفظة (تم إنشاؤها من خلال خدمة BiddingStrategy) أو محفظة عادية مضمّنة في الحملة. يمكن أن يكون الحقل "campaign_bidding_strategy" واحدًا فقط مما يلي:
bidding_strategy

string

استراتيجية المحفظة لعروض الأسعار التي تستخدمها الحملة.
manual_cpa

ManualCpa

الإستراتيجية القياسية لعروض أسعار الإجراء اليدوية. استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدِّده المعلِن. لا تتوفّر هذه الميزة إلا لحملات "الخدمات المحلّية".
manual_cpc

ManualCpc

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

ManualCpm

هي استراتيجية قياسية لعروض الأسعار اليدوية لكل ألف ظهور. عروض الأسعار اليدوية المستندة إلى مرات الظهور والتي يدفع فيها المستخدم مقابل كل ألف ظهور
maximize_conversions

MaximizeConversions

استراتيجية عروض أسعار "تحقيق الحد الأقصى من الإحالات الناجحة" العادية التي تعمل تلقائيًا على زيادة عدد الإحالات الناجحة إلى أقصى حد مع إنفاق ميزانيتك
maximize_conversion_value

MaximizeConversionValue

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

TargetCpa

هي الاستراتيجية العادية لعروض الأسعار المستهدفة للإجراء، والتي تحدِّد عروض الأسعار تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها.
target_impression_share

TargetImpressionShare

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

TargetRoas

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

TargetSpend

استراتيجية عروض أسعار "الإنفاق الهدف" العادية التي تُحدِّد عروض أسعارك تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.
percent_cpc

PercentCpc

استراتيجية عروض أسعار النسبة المئوية العادية لتكلفة النقرة حيث تكون عروض الأسعار جزءًا من السعر المُعلَن عنه لبعض السلع أو الخدمات.
target_cpm

TargetCpm

استراتيجية عروض أسعار تعمل على تحسين التكلفة لكل ألف ظهور تلقائيًا.

DynamicSearchAdsSetting

إعداد التحكّم في الإعلانات الديناميكية على شبكة البحث (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" الأخرى.

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

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

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

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

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

كمية السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده المَعلمة qty لعنوان 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

إذا كانت وحدة البت الأساسية_for_goal لإجراء الإحالة الناجحة غير صحيحة، لا يمكن تقديم عروض أسعار لإجراء الإحالة الناجحة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. وفي المقابل، لا تراعي أهداف الإحالات الناجحة المخصّصة Primary_for_goal، لذا إذا كانت إحدى الحملات تحتوي على هدف إحالة ناجحة مخصّص تمّ إعداده باستخدام إجراء إحالة ناجحة أساسي =primary_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

ValueSettings

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

الحقول
default_value

double

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

string

رمز العملة الذي سيتم استخدامه عند إرسال أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا برمز عملة غير صالح أو مفقود، أو عند إعداد إجراء الإحالة الناجحة هذا لاستخدام القيمة التلقائية دائمًا.
always_use_default_value

bool

تتحكّم هذه السياسة في ما إذا كان يتم استخدام القيمة التلقائية ورمز العملة التلقائي بدلاً من القيمة ورمز العملة المحدّدَين في أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا.

ConversionCustomVariable

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

الحقول
resource_name

string

اسم المورد للمتغيّر المخصّص للإحالة الناجحة تكون أسماء موارد المتغيّرات المخصّصة للإحالات الناجحة على النحو التالي:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id

int64

رقم تعريف المتغيّر المخصَّص للإحالة الناجحة.
name

string

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

string

مطلوبة. علامة المتغيّر المخصَّص للإحالة الناجحة يجب أن تكون العلامة فريدة وتتألف من حرف "u" متبوعًا مباشرةً برقم أقل من أو يساوي 100. على سبيل المثال: "u4".
status

ConversionCustomVariableStatus

حالة المتغيّر المخصَّص للإحالة الناجحة لتجميع حدث الإحالة الناجحة
owner_customer

string

اسم المورد للعميل الذي يملك المتغيّر المخصّص للإحالة الناجحة
family

ConversionCustomVariableFamily

عائلة المتغيّر المخصَّص للإحالة الناجحة
cardinality

ConversionCustomVariableCardinality

عدد القيم الفريدة للمتغيّر المخصّص للإحالة الناجحة
floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

int64

أرقام تعريف الأعمدة المخصّصة التي تستخدِم هذا المتغيّر المخصّص للإحالة الناجحة.

FloodlightConversionCustomVariableInfo

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

الحقول
floodlight_variable_type

FloodlightVariableType

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

FloodlightVariableDataType

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

ConversionTrackingSetting

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

الحقول
accepted_customer_data_terms

bool

ما إذا كان العميل قد وافق على بنود بيانات العملاء وفي حال استخدام تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_status

ConversionTrackingStatus

حالة تتبُّع الإحالات الناجحة. ويشير إلى ما إذا كان العميل يستخدم تتبُّع الإحالات الناجحة، وهو مالك تتبُّع الإحالات الناجحة لهذا العميل. إذا كان هذا العميل يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ستختلف القيمة المعروضة بناءً على login-customer-id للطلب.
enhanced_conversions_for_leads_enabled

bool

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

string

اسم المورد للعميل حيث يتم إنشاء الإحالات الناجحة وإدارتها. هذا الحقل للقراءة فقط.
conversion_tracking_id

int64

رقم تعريف تتبُّع الإحالات الناجحة المستخدَم لهذا الحساب. لا يشير هذا الرقم التعريفي إلى ما إذا كان العميل يستخدم تتبع الإحالة الناجحة (conversion_tracking_status). هذا الحقل للقراءة فقط.
google_ads_cross_account_conversion_tracking_id

int64

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

int64

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

CustomColumn

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

الحقول
resource_name

string

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

customers/{customer_id}/customColumns/{custom_column_id}
id

int64

رقم تعريف العمود المخصّص.
name

string

اسم العمود المخصّص الذي يحدّده المستخدم.
description

string

وصف من تحديد المستخدم للعمود المخصّص.
value_type

CustomColumnValueType

نوع قيمة النتيجة للعمود المخصّص.
references_attributes

bool

صحيح عندما يشير العمود المخصّص إلى سمة واحدة أو أكثر.
references_metrics

bool

صحيح عندما يشير العمود المخصّص إلى مقياس واحد أو أكثر.
queryable

bool

صحيح عندما يكون العمود المخصّص متاحًا للاستخدام في طلب بحث SearchAds360Service.Search وSearchAds360Service.SearchStream.
referenced_system_columns[]

string

قائمة أعمدة النظام المُشار إليها في هذا العمود المخصّص. على سبيل المثال، أشار عمود مخصّص "مجموع مرّات الظهور والنقرات" إلى أعمدة النظام {"metrics.clicks", "metrics.impression"}.

العميل

عميل.

الحقول
resource_name

string

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

customers/{customer_id}
conversion_tracking_setting

ConversionTrackingSetting

إعداد تتبُّع الإحالات الناجحة للعميل.
account_type

AccountType

نوع حساب محرّك البحث، مثل "إعلانات Google" أو Microsoft Advertising أو Yahoo Japan أو Baidu أو Facebook أو Engine Track أو غير ذلك
double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

إعداد DoubleClick Campaign Manager لعميل إداري.
account_status

AccountStatus

حالة الحساب، على سبيل المثال، مفعَّل أو متوقف مؤقتًا أو مُزالة وما إلى ذلك.
last_modified_time

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل لهذا العميل يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm: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

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

الحقول
resource_name

string

اسم المورد للعميل. تكون أسماء موارد CustomerClient على النحو التالي: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]

string

أسماء الموارد للتصنيفات التي يملكها العميل الذي قدّم الطلب والتي يتم تطبيقها على العميل. تكون أسماء موارد التصنيف على النحو التالي:

customers/{customer_id}/labels/{label_id}
status

CustomerStatus

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

string

اسم المورد للعميل - العميل المرتبط بالعميل المحدّد. للقراءة فقط
hidden

bool

تحدِّد هذه السياسة ما إذا كان هذا الحساب مخفيًا.

للقراءة فقط
level

int64

المسافة بين العميل المحدّد والعميل. بالنسبة إلى خيار الربط الذاتي، ستكون قيمة المستوى 0. للقراءة فقط
time_zone

string

تمثيل سلسلة بيانات لغة محلية مشتركة (CLDR) للمنطقة الزمنية للعميل، مثل America/Los_Angeles. للقراءة فقط
test_account

bool

تحدِّد ما إذا كان العميل حسابًا تجريبيًا. للقراءة فقط
manager

bool

يحدد ما إذا كان العميل مديرًا أم لا. للقراءة فقط
descriptive_name

string

تمثّل هذه السمة الاسم الوصفي للعميل. للقراءة فقط
currency_code

string

رمز العملة (على سبيل المثال، "USD" و"EUR") للعميل. للقراءة فقط
id

int64

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

DoubleClickCampaignManagerSetting

إعداد DoubleClick Campaign Manager لعميل إداري.

الحقول
advertiser_id

int64

رقم تعريف المعلِن في "مدير الحملة" المرتبط بهذا العميل.
network_id

int64

رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا العميل.
time_zone

string

المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بهذا العميل بتنسيق قاعدة بيانات المناطق الزمنية IANA، مثل أمريكا/نيو يورك.

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

عرض الجنس. يعكس مورد gender_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

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

يتم ضبط هذا الحقل فقط للعناصر التي تكون فئتها هي "Resource" (الموارد).
metrics[]

string

يسرد هذا الحقل أسماء جميع المقاييس القابلة للاختيار مع العنصر الموصوف عند استخدامه في عبارة FROM. ويتم تعيينه فقط للعناصر التي تكون فئتها هي "Resource" (الموارد).
segments[]

string

يسرد هذا الحقل أسماء جميع العناصر، سواء كانت قطعة أو موردًا آخر، والتي تقطع المقاييس عند تضمينها في طلبات البحث وعند استخدام العنصر الموصوف في عبارة FROM. ويتم تعيينه فقط للعناصر التي تكون فئتها هي "Resource" (الموارد).
enum_values[]

string

قيم يمكن أن يفترضها العنصر إذا كان حقلاً من النوع ENUM.

يتم تعيين هذا الحقل فقط للعناصر من الفئة SEGMENT أو ATTRIBUTE.
data_type

SearchAds360FieldDataType

يحدد هذا الحقل العوامل التي يمكن استخدامها مع العنصر في عبارات WHERE.
name

string

اسم العنصر.
selectable

bool

ما إذا كان يمكن استخدام العنصر في عبارة SELECT في طلبات البحث.
filterable

bool

ما إذا كان يمكن استخدام العنصر في عبارة WHERE في استعلامات البحث.
sortable

bool

ما إذا كان يمكن استخدام العنصر في عبارة ORDER BY في استعلامات البحث.
type_url

string

تمثّل هذه السمة عنوان URL للنموذج الأوّلي الذي يصف نوع بيانات العنصر.
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، (على سبيل المثال، إذا 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}