Campaign

حملة

تمثيل JSON 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
الحقول
resourceName

string

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

customers/{customerId}/campaigns/{campaignId}
primaryStatus

enum (CampaignPrimaryStatus)

النتائج فقط. الحالة الأساسية للحملة.

يقدّم إحصاءات عن سبب عدم عرض الحملة أو عدم عرضها على النحو الأمثل. قد يستغرق التعديل على الحملة والكيانات المرتبطة بها بعض الوقت حتى ينعكس في هذه الحالة.
primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

النتائج فقط. أسباب الحالة الأساسية للحملة.

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

enum (CampaignStatus)

حالة الحملة.

عند إضافة حملة جديدة، يتم ضبط الحالة على "مفعَّل" بشكلٍ تلقائي.
servingStatus

enum (CampaignServingStatus)

النتائج فقط. حالة عرض الإعلانات للحملة
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

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

enum (AdServingOptimizationStatus)

حالة تحسين عرض الإعلانات للحملة
advertisingChannelType

enum (AdvertisingChannelType)

غير قابل للتغيير. استهداف العرض الأساسي للإعلانات داخل الحملة. يمكن تحسين خيارات الاستهداف في networkSettings.

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

لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

غير قابل للتغيير. تحسين اختياري لـ advertisingChannelType. يجب أن يكون نوعًا فرعيًا صالحًا من نوع القناة الرئيسية.

لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير هذا الحقل.
urlCustomParameters[]

object (CustomParameter)

قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصَّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls.
localServicesCampaignSettings

object (LocalServicesCampaignSettings)

الإعدادات ذات الصلة بـ "حملة الخدمات المحلّية".
travelCampaignSettings

object (TravelCampaignSettings)

إعدادات "حملة السفر"
discoveryCampaignSettings

object (DiscoveryCampaignSettings)

إعدادات "حملة أثناء التصفّح".
realTimeBiddingSetting

object (RealTimeBiddingSetting)

إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدف شبكة Ad Exchange.
networkSettings

object (NetworkSettings)

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

object (HotelSettingInfo)

غير قابل للتغيير. إعداد الفندق للحملة
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

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

object (ShoppingSetting)

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

object (TargetingSetting)

إعداد لاستهداف الميزات ذات الصلة.
geoTargetTypeSetting

object (GeoTargetTypeSetting)

إعداد الاستهداف الجغرافي للإعلانات.
localCampaignSetting

object (LocalCampaignSetting)

إعداد الحملة المحلّية.
appCampaignSetting

object (AppCampaignSetting)

الإعداد المرتبط بحملة التطبيقات.
labels[]

string

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

enum (CampaignExperimentType)

النتائج فقط. نوع الحملة: عادية أو حملة اختبارية أو تجريبية.
biddingStrategyType

enum (BiddingStrategyType)

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

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

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

string

النتائج فقط. اسم مورد Accessible BiddingStrategy"، وهو ملف شخصي للقراءة فقط على السمات غير المشروطة لاستراتيجية المحفظة لعروض الأسعار المرفقة التي تم تحديدها من خلال "عروض الأسعار" هذا الحقل فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة. تتوفّر سمات الاستراتيجية غير المحدودة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويمكن الاطّلاع عليها من مرجع Accessible BiddingStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا للعميل مالك الاستراتيجية ومدرائه. لا يمكن قراءة السمات المحظورة إلا من مورد BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

قائمة تحدّ من عدد مرات مشاهدة كل مستخدم لإعلانات هذه الحملة.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

النتائج فقط. إعداد أمان العلامة التجارية على مستوى الحملة الفردية. تتيح اختيار نوع المستودع لعرض إعلاناتك على المحتوى المناسب لعلامتك التجارية. يمكنك الاطّلاع على https://support.google.com/google-ads/answer/7515513.
vanityPharma

object (VanityPharma)

يصف كيفية عرض إعلانات المستحضرات الدوائية التي لا تتضمّن علامات تجارية.
selectiveOptimization

object (SelectiveOptimization)

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

object (OptimizationGoalSetting)

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

object (TrackingSetting)

النتائج فقط. إعدادات على مستوى الحملة لتتبُّع المعلومات.
paymentMode

enum (PaymentMode)

وضع الدفع للحملة
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

enum (AssetSetType)

أنواع مجموعات مواد العرض التي يجب استبعادها من هذه الحملة. لن تكتسب هذه الحملة روابط مجموعة مواد العرض بهذه الأنواع من المستوى الأعلى. أنواع مجموعات المواقع الجغرافية (GMB_DYNAMIC_LOCATION_GROUP وCHAIN_DYNAMIC_LOCATION_GROUP وStatIC_LOCATION_GROUP) هي أنواع فرعية من LOCATION_SYNC. وبالتالي، في حال ضبط LOCATION_SYNC لهذا الحقل، لا يُسمح بربط كل مجموعات مواد عرض مجموعة المواقع الجغرافية بهذه الحملة، ولن يتم عرض كل إضافات المواقع الجغرافية (LE) وإضافات مواقع المعلِنين الجغرافية (ALE) ضمن هذه الحملة. لا يتوفّر حاليًا سوى LOCATION_SYNC.
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

النتائج فقط. معلومات عن الحملات التي تتم ترقيتها إلى حملات "الأداء الأفضل".
id

string (int64 format)

النتائج فقط. رقم تعريف الحملة.
name

string

اسم الحملة.

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

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

string

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

object (AudienceSetting)

غير قابل للتغيير. إعداد للميزات المتعلّقة بالجمهور
baseCampaign

string

النتائج فقط. اسم مورد الحملة الأساسية في حملة اختبارية أو حملة تجريبية. بالنسبة إلى الحملات الأساسية، يساوي ذلك resourceName.

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

string

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

string

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

string

مجموعة الحملات التي تنتمي إليها هذه الحملة.
endDate

string

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

string

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

number

النتائج فقط. نتيجة تحسين الحملة.

نتيجة التحسين هي تقدير لمستوى الأداء المتوقّع للحملة. وتتراوح النسبة المئوية بين 0% (0.0) و100% (1.0)، حيث تشير نسبة 100% إلى أن الحملة تحقق أفضل أداء ممكن. هذا الحقل فارغ للحملات غير المصحوبة بدرجات.

اطّلِع على "لمحة عن نتيجة التحسين" على الرابط https://support.google.com/google-ads/answer/9061546.

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

boolean

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

string

غير قابل للتغيير. مجموعة مواقع الفنادق في "حملات الأداء الأفضل" المستندة إلى أهداف السفر.
listingType

enum (ListingType)

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

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

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

string

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

object (Commission)

العمولات هي استراتيجية عروض أسعار تلقائية يدفع المعلِن فيها جزءًا معيّنًا من قيمة الإحالة الناجحة.
manualCpa

object (ManualCpa)

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

object (ManualCpc)

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

object (ManualCpm)

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

object (ManualCpv)

استراتيجية عروض أسعار تدفع مبلغًا قابلاً للضبط لكل مشاهدة للفيديو.
maximizeConversions

object (MaximizeConversions)

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

object (MaximizeConversionValue)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

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

object (TargetCpm)

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

CampaignPrimaryStatus

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ELIGIBLE تكون الحملة مؤهَّلة لعرض الإعلانات.
PAUSED حالة الحملة التي يحدِّدها المستخدِم متوقفة مؤقتًا.
REMOVED تتمّ إزالة حالة الحملة التي حدّدها المستخدِم.
ENDED لقد انقضى الوقت الذي حدّده المستخدم لانتهاء هذه الحملة.
PENDING وقد تعرِض الحملة في المستقبل.
MISCONFIGURED تحتوي الحملة أو الكيانات المرتبطة بها على إعدادات غير صحيحة يحدّدها المستخدم.
LIMITED يتم فرض قيود على الحملة أو الكيانات المرتبطة بها وفقًا للإعدادات التي يحدّدها المستخدم.
LEARNING يعمل نظام عروض الأسعار المبرمَجة على تعديل التغييرات التي يحدِّدها المستخدِم على الحملة أو الكيانات المرتبطة بها.
NOT_ELIGIBLE الحملة غير مؤهَّلة لعرض الإعلانات.

CampaignPrimaryStatusReason

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
CAMPAIGN_REMOVED تتمّ إزالة حالة الحملة التي حدّدها المستخدِم.
CAMPAIGN_PAUSED حالة الحملة التي يحدِّدها المستخدِم متوقفة مؤقتًا.
CAMPAIGN_PENDING يقع الوقت الذي يحدِّده المستخدم لبدء هذه الحملة في المستقبل.
CAMPAIGN_ENDED لقد انقضى الوقت الذي حدّده المستخدم لانتهاء هذه الحملة.
CAMPAIGN_DRAFT الحملة عبارة عن مسودة.
BIDDING_STRATEGY_MISCONFIGURED تحتوي استراتيجية عروض الأسعار على إعدادات غير صحيحة محدّدة من جانب المستخدم.
BIDDING_STRATEGY_LIMITED تكون استراتيجية عروض الأسعار محدودة بالإعدادات التي يحدِّدها المستخدم، مثل نقص البيانات أو ما شابه ذلك.
BIDDING_STRATEGY_LEARNING يعمل نظام عروض الأسعار المبرمَجة على التكيف مع التغييرات التي يحدِّدها المستخدِم في استراتيجية عروض الأسعار.
BIDDING_STRATEGY_CONSTRAINED يمكن أن تحقّق الحملة قيمة أكبر للإحالة الناجحة عن طريق تعديل استهدافات تكلفة الإجراء/عائد الإنفاق الإعلاني.
BUDGET_CONSTRAINED تحدّ الميزانية من قدرة الحملة على عرض الإعلانات.
BUDGET_MISCONFIGURED تحتوي الميزانية على إعدادات غير صحيحة محدّدة من قِبل المستخدم.
SEARCH_VOLUME_LIMITED لا تستهدِف الحملة كل طلبات البحث ذات الصلة.
AD_GROUPS_PAUSED جميع حالات المجموعة الإعلانية التي يحدِّدها المستخدم متوقفة مؤقتًا.
NO_AD_GROUPS لا تتوفّر أي مجموعات إعلانية مؤهَّلة في هذه الحملة.
KEYWORDS_PAUSED جميع حالات الكلمات الرئيسية التي يحدِّدها المستخدِم متوقفة مؤقتًا.
NO_KEYWORDS لا توجد كلمات رئيسية مؤهلة في هذه الحملة.
AD_GROUP_ADS_PAUSED جميع حالات إعلانات المجموعة الإعلانية التي حدّدها المستخدم متوقفة مؤقتًا.
NO_AD_GROUP_ADS لا توجد إعلانات مؤهلة للمجموعة الإعلانية في هذه الحملة.
HAS_ADS_LIMITED_BY_POLICY إعلان واحد على الأقل في هذه الحملة مقيَّد بالسياسة.
HAS_ADS_DISAPPROVED تم رفض إعلان واحد على الأقل في هذه الحملة.
MOST_ADS_UNDER_REVIEW معظم الإعلانات في هذه الحملة في انتظار المراجعة.
MISSING_LEAD_FORM_EXTENSION تحتوي الحملة على هدف نموذج عملاء محتملين، وإضافة نموذج العملاء المحتملين غير متوفّرة.
MISSING_CALL_EXTENSION تحتوي الحملة على هدف مكالمة، ولا تتوفّر إضافة المكالمة.
LEAD_FORM_EXTENSION_UNDER_REVIEW إضافة نموذج العملاء المحتملين قيد المراجعة.
LEAD_FORM_EXTENSION_DISAPPROVED تم رفض إضافة العملاء المحتملين.
CALL_EXTENSION_UNDER_REVIEW إضافة المكالمة قيد المراجعة.
CALL_EXTENSION_DISAPPROVED تم رفض إضافة المكالمة.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA لا توجد معايير مجموعة إعلانية مؤهلة لتطبيقات الأجهزة الجوّالة في هذه الحملة.
CAMPAIGN_GROUP_PAUSED حالة مجموعة الحملات التي حدّدها المستخدِم متوقفة مؤقتًا.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED انقضت الأوقات التي حدّدها المستخدم لجميع ميزانيات المجموعة المرتبطة بمجموعة الحملات الرئيسية.
APP_NOT_RELEASED لم يتم إصدار التطبيق المرتبط بحملة التطبيقات لجذب عمليات التثبيت هذه في البلدان المستهدَفة من الحملة.
APP_PARTIALLY_RELEASED تم إصدار التطبيق المرتبط بحملة التطبيقات لجذب عمليات التثبيت هذه جزئيًا في البلدان المستهدفة من الحملة.
HAS_ASSET_GROUPS_DISAPPROVED تم رفض مجموعة مواد عرض واحدة على الأقل في هذه الحملة.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY هناك مجموعة مواد عرض واحدة على الأقل في هذه الحملة مقيَّدة بالسياسة.
MOST_ASSET_GROUPS_UNDER_REVIEW معظم مجموعات مواد العرض في هذه الحملة في انتظار المراجعة.

CampaignStatus

الحالات المحتملة للحملة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ENABLED الحملة نشطة ويمكنها عرض إعلانات.
PAUSED أوقف المستخدم الحملة مؤقتًا.
REMOVED تمت إزالة الحملة.

CampaignServingStatus

حالات العرض المحتملة لإحدى الحملات

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
SERVING يتم عرضها
NONE بلا عُري
ENDED انتهى.
PENDING Pending.
SUSPENDED معلّقة.

BiddingStrategySystemStatus

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

عمليات التعداد
UNSPECIFIED إشارات حدوث خطأ غير متوقع، مثل عدم العثور على نوع استراتيجية عروض الأسعار، أو عدم العثور على معلومات عن الحالة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ENABLED إستراتيجية عروض الأسعار نشطة، ولم يتمكن AdWords من العثور على أي مشاكل محدّدة في الإستراتيجية.
LEARNING_NEW استراتيجية عروض الأسعار في مرحلة التعلّم لأنه تم إنشاؤها مؤخرًا أو تمت إعادة تفعيلها مؤخرًا.
LEARNING_SETTING_CHANGE استراتيجية عروض الأسعار في حالة التعلم بسبب تغيير حديث في الإعداد.
LEARNING_BUDGET_CHANGE استراتيجية عروض الأسعار في حالة التعلم بسبب تغيير حديث في الميزانية.
LEARNING_COMPOSITION_CHANGE استراتيجية عروض الأسعار في حالة التعلم بسبب التغيير الأخير في عدد الحملات أو المجموعات الإعلانية أو الكلمات الرئيسية المرفقة بها.
LEARNING_CONVERSION_TYPE_CHANGE تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، وعدّل العميل مؤخرًا أنواع الإحالات الناجحة التي كانت ذات صلة باستراتيجية عروض الأسعار.
LEARNING_CONVERSION_SETTING_CHANGE تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، وغيّر العميل إعدادات الإحالة الناجحة مؤخرًا.
LIMITED_BY_CPC_BID_CEILING استراتيجية عروض الأسعار محدودة بالحد الأقصى لعروض الأسعار.
LIMITED_BY_CPC_BID_FLOOR استراتيجية عروض الأسعار محدودة بالحد الأدنى لعرض السعر.
LIMITED_BY_DATA استراتيجية عروض الأسعار محدودة بسبب عدم توفّر عدد كافٍ من الزيارات للإحالات الناجحة خلال الأسابيع الماضية.
LIMITED_BY_BUDGET هناك جزء كبير من الكلمات الرئيسية في استراتيجية عروض الأسعار هذه أدنى من حدود الميزانية المطلوبة.
LIMITED_BY_LOW_PRIORITY_SPEND لا يمكن لاستراتيجية عروض الأسعار الوصول إلى حد الإنفاق المستهدف بسبب عدم منح الأولوية للإنفاق.
LIMITED_BY_LOW_QUALITY تتسم نسبة كبيرة من الكلمات الرئيسية في استراتيجية عروض الأسعار هذه بنقاط جودة منخفضة.
LIMITED_BY_INVENTORY لا يمكن لاستراتيجية عروض الأسعار إنفاق ميزانيتها بالكامل بسبب ضيق الاستهداف.
MISCONFIGURED_ZERO_ELIGIBILITY تتبُّع الإحالات الناجحة غير متوفّر (لا تتوفّر إشعارات) و/أو قوائم تجديد النشاط التسويقي في حملة Shopping الذكية (SSC).
MISCONFIGURED_CONVERSION_TYPES تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، وينقص العميل أنواع الإحالات الناجحة التي يمكن تسجيلها وفقًا لهذه الاستراتيجية.
MISCONFIGURED_CONVERSION_SETTINGS تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة وتم ضبط إعدادات الإحالات الناجحة للعميل بشكلٍ خاطئ.
MISCONFIGURED_SHARED_BUDGET هناك حملات خارج استراتيجية عروض الأسعار تشترك في الميزانيات مع الحملات المضمّنة في الاستراتيجية.
MISCONFIGURED_STRATEGY_TYPE نوع استراتيجية الحملة غير صالح ولا يتم عرضه.
PAUSED استراتيجية عروض الأسعار غير نشطة. إما أنه لا توجد حملات أو مجموعات إعلانية أو كلمات رئيسية نشطة مرفقة باستراتيجية عروض الأسعار. أو إذا لم تكن هناك ميزانيات نشطة مرتبطة باستراتيجية عروض الأسعار.
UNAVAILABLE لا تتيح استراتيجية عروض الأسعار هذه إعداد تقارير الحالة حاليًا.
MULTIPLE_LEARNING كانت هناك حالات نظام LEARNING_* متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.
MULTIPLE_LIMITED كانت هناك حالات نظام LIMITED_* متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.
MULTIPLE_MISCONFIGURED كانت هناك حالات نظام متعددة MISCONFIGURED_* لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.
MULTIPLE كانت هناك حالات متعددة للنظام لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.

AdServingOptimizationStatus

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
OPTIMIZE يتم تحسين عرض الإعلانات استنادًا إلى نسبة النقر إلى الظهور للحملة.
CONVERSION_OPTIMIZE يتم تحسين عرض الإعلانات استنادًا إلى نسبة النقر إلى الظهور * الإحالة الناجحة للحملة. إذا لم تكن الحملة ضمن استراتيجية عروض أسعار محسِّن الإحالات الناجحة، سيتم ضبطها تلقائيًا على "التحسين".
ROTATE يتم عرض الإعلانات بالتناوب بشكل متساوٍ لمدة 90 يومًا، ثم يتم تحسينها للحصول على نقرات.
ROTATE_INDEFINITELY عرض الإعلانات الأقل أداءً بشكل متساوٍ مع الإعلانات الأعلى أداءً، وعدم التحسين.
UNAVAILABLE حالة تحسين عرض الإعلانات غير متاحة.

LocalServicesCampaignSettings

إعدادات المرجع الفرعي لـ LocalServicesCampaign.

تمثيل JSON 
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
الحقول
categoryBids[]

object (CategoryBid)

عروض الأسعار على المستوى الفئوي المرتبطة باستراتيجية عروض الأسعار MANUAL_CPA.

CategoryBid

عروض أسعار الفئات في LocalServicesReportingCampaignSettings

تمثيل JSON 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
الحقول
categoryId

string

الفئة التي سيقترن بها عرض السعر. على سبيل المثال، xcat:service_area_business_ رأيك.
manualCpaBidMicros

string (int64 format)

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

TravelCampaignSettings

إعدادات "حملة السفر"

تمثيل JSON 
{
  "travelAccountId": string
}
الحقول
travelAccountId

string (int64 format)

غير قابل للتغيير. رقم تعريف حساب السفر المرتبط بـ "حملة السفر".

DiscoveryCampaignSettings

إعدادات "حملة أثناء التصفّح".

تمثيل JSON 
{
  "upgradedTargeting": boolean
}
الحقول
upgradedTargeting

boolean

غير قابل للتغيير. لتحديد ما إذا كانت هذه الحملة تستخدم خيارات استهداف تمت ترقيتها أم لا. عند ضبط هذا الحقل على true، يمكنك استخدام الاستهداف حسب الموقع الجغرافي واستهداف اللغة على مستوى المجموعة الإعلانية بدلاً من الاستهداف العادي على مستوى الحملة. يتم ضبط هذا الحقل تلقائيًا على false، ولا يمكن ضبطه إلا عند إنشاء حملة.

RealTimeBiddingSetting

إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدف شبكة Ad Exchange.

تمثيل JSON 
{
  "optIn": boolean
}
الحقول
optIn

boolean

ما إذا كانت عروض الأسعار في الوقت الفعلي مفعَّلة في الحملة

NetworkSettings

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

تمثيل JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
الحقول
targetSearchNetwork

boolean

ما إذا كان سيتم عرض الإعلانات على مواقع الشركاء في شبكة بحث Google (يتطلب ذلك targetGoogleSearch أن تكون أيضًا true).
targetContentNetwork

boolean

ما إذا كان سيتم عرض الإعلانات في مواضع محدّدة على شبكة Google الإعلانية. ويتم تحديد مواضع الإعلانات باستخدام معيار موضع الإعلان.
targetPartnerSearchNetwork

boolean

ما إذا كان سيتم عرض الإعلانات على شبكة شركاء Google أم لا. ولا تتوفّر هذه الميزة إلا لبعض حسابات شركاء Google المختارة.

HotelSettingInfo

إعدادات إعلانات الفنادق على مستوى الحملة

تمثيل JSON 
{
  "hotelCenterId": string
}
الحقول
hotelCenterId

string (int64 format)

غير قابل للتغيير. حساب Hotel Center المرتبط

DynamicSearchAdsSetting

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

تمثيل JSON 
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
الحقول
domainName

string

مطلوبة. اسم نطاق الإنترنت الذي يمثله هذا الإعداد، على سبيل المثال، "google.com" أو "www.google.com".
languageCode

string

مطلوبة. رمز اللغة الذي يحدّد لغة النطاق، على سبيل المثال، "en".
feeds[]

string

قائمة خلاصات الصفحات المرتبطة بالحملة.
useSuppliedUrlsOnly

boolean

ما إذا كانت الحملة تستخدم عناوين URL المقدّمة من المعلن حصريًا.

ShoppingSetting

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

تمثيل JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
الحقول
feedLabel

string

تصنيف خلاصة المنتجات المطلوب تضمينها في الحملة يمكن ضبط قيمة واحدة فقط من FeedLabel أو salesCountry. في حال استخدامه بدلاً من salesCountry، يقبل حقل feedLabel رموز البلدان بالتنسيق نفسه، على سبيل المثال: "XX". ويمكن أيضًا أن يكون أيّ سلسلة مستخدَمة لتصنيف الخلاصة في Google Merchant Center.
useVehicleInventory

boolean

غير قابل للتغيير. لتحديد ما إذا كنت تريد استهداف مستودع بيانات المركبات لا يتوفّر هذا الحقل إلا في "حملات Shopping الذكية". لإعداد مستودع بيانات المركبة في "حملات الأداء الأفضل"، استخدِم listingType بدلاً من ذلك.
advertisingPartnerIds[]

string (int64 format)

غير قابل للتغيير. أرقام تعريف حسابات "إعلانات Google" الخاصة بشركاء الإعلانات المتعاونين ضمن الحملة.
merchantId

string (int64 format)

غير قابل للتغيير. رقم تعريف حساب Merchant Center. هذا الحقل مطلوب لإنشاء عمليات. هذا الحقل غير قابل للتغيير في "حملات Shopping".
salesCountry

string

بلد مبيعات المنتجات المطلوب تضمينها في الحملة يمكن ضبط قيمة واحدة فقط من FeedLabel أو salesCountry. الحقل غير قابل للتغيير. بعد محو هذا الحقل، عليك استخدام FeedLabel إذا كنت تريد ضبط بلد المبيعات.
campaignPriority

integer

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

boolean

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

AudienceSetting

إعدادات استهداف الجمهور.

تمثيل JSON 
{
  "useAudienceGrouped": boolean
}
الحقول
useAudienceGrouped

boolean

غير قابل للتغيير. إذا كانت هذه المعلومات صحيحة، تستخدم هذه الحملة موردًا للجمهور لاستهداف الجمهور. وفي حال اختيار "خطأ"، قد تستخدِم هذه الحملة معايير شريحة الجمهور بدلاً من ذلك.

GeoTargetTypeSetting

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

تمثيل JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
الحقول
positiveGeoTargetType

enum (PositiveGeoTargetType)

الإعداد المستخدَم للاستهداف الجغرافي الإيجابي في هذه الحملة تحديدًا.
negativeGeoTargetType

enum (NegativeGeoTargetType)

الإعداد المستخدَم للاستهداف الجغرافي السلبي في هذه الحملة بالتحديد.

PositiveGeoTargetType

أنواع الاستهدافات الجغرافية الإيجابية المحتملة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
PRESENCE_OR_INTEREST تحدِّد هذه السياسة إمكانية عرض الإعلان إذا كان المستخدم في المواقع الجغرافية المستهدَفة للمعلِن أو يبدي اهتمامًا بها.
SEARCH_INTEREST تحدّد هذه السمة أنّه يتم عرض إعلان إذا بحث المستخدم عن المواقع الجغرافية المستهدَفة للمعلِن. ويمكن استخدام هذه الميزة مع "الحملات على شبكة البحث" و"حملات Shopping العادية" فقط.
PRESENCE تحدِّد هذه السمة أنّه يتم عرض إعلان إذا كان المستخدم مقيمًا في المواقع الجغرافية المستهدَفة للمعلِن أو يزورها بانتظام.

NegativeGeoTargetType

أنواع الاستهدافات الجغرافية السلبية المحتملة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
PRESENCE_OR_INTEREST تحدِّد هذه السياسة أنّه يتم استبعاد المستخدم من مشاهدة الإعلان إذا كان في المواقع الجغرافية المستبعَدة للمعلن أو يبدي اهتمامًا بها.
PRESENCE تحدِّد هذه السياسة أنّه يتم استبعاد المستخدم من مشاهدة الإعلان إذا كان في مواقع جغرافية مستبعدة من المعلِن.

LocalCampaignSetting

إعداد الحملة للحملات المحلية.

تمثيل JSON 
{
  "locationSourceType": enum (LocationSourceType)
}
الحقول
locationSourceType

enum (LocationSourceType)

نوع مصدر الموقع الجغرافي لهذه الحملة المحلية.

LocationSourceType

الأنواع الممكنة لمصدر الموقع الجغرافي.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
GOOGLE_MY_BUSINESS المواقع الجغرافية المرتبطة بالملف التجاري المرتبط بحساب العميل
AFFILIATE المواقع الجغرافية لمتاجر الشركاء التابعين (السلسلة) مثل، المواقع الجغرافية لمتاجر Best Buy.

AppCampaignSetting

الإعدادات على مستوى الحملة لحملات التطبيقات.

تمثيل JSON 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
الحقول
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

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

enum (AppCampaignAppStore)

غير قابل للتغيير. متجر التطبيقات الذي يوزّع هذا التطبيق المحدّد.
appId

string

غير قابل للتغيير. سلسلة تعرِّف تطبيقًا متوافقًا مع الأجهزة الجوّالة بشكلٍ فريد.

AppCampaignBiddingStrategyGoalType

نوع هدف استراتيجية عروض الأسعار في "حملة التطبيقات"

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST ساهِم في زيادة عدد عمليات تثبيت التطبيق إلى أقصى حد. عرض سعر الإجراء هو التكلفة المستهدفة لكل تثبيت.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST اسعَ إلى زيادة عدد الإحالات الناجحة المختارة داخل التطبيق من عمليات تثبيت التطبيق على المدى الطويل. عرض سعر الإجراء هو التكلفة المستهدفة لكل تثبيت.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST اسعَ إلى زيادة عدد الإحالات الناجحة المختارة داخل التطبيق من عمليات تثبيت التطبيق على المدى الطويل. عرض سعر الإجراء هو التكلفة المستهدفة لكل إحالة ناجحة داخل التطبيق. تجدر الإشارة إلى أنّ التكلفة الفعلية للإجراء قد تبدو أعلى من التكلفة المستهدَفة للإجراء في البداية، لأنّ الإحالات الناجحة على المدى الطويل لم تحدث بعد.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND اسعَ إلى تحقيق الحد الأقصى من قيمة كل الإحالات الناجحة، مثل تثبيت الإحالات الناجحة + الإحالات الناجحة المحدَّدة داخل التطبيق مع تحقيق عائد الإنفاق الإعلاني المستهدَف أو تجاوزه.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME احرِص على زيادة التسجيل المُسبَق للتطبيق إلى أقصى حد.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST احرِص على زيادة عمليات تثبيت التطبيق إلى أقصى حد بدون تكلفة مستهدَفة لكل تثبيت.

AppCampaignAppStore

رقم يصف متجر التطبيقات لحملة التطبيقات.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
APPLE_APP_STORE متجر تطبيقات Apple.
GOOGLE_APP_STORE Google Play

CampaignExperimentType

يشير إلى ما إذا كانت هذه الحملة حملة عادية أو حملة اختبارية أو حملة تجريبية.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
BASE هذه حملة عادية.
DRAFT هذه نسخة اختبارية من الحملة. تحتوي الحملة على بعض التعديلات من حملة أساسية، ولكنّها لا تعرض مقاييس أو لا تحقّقها.
EXPERIMENT هذه نسخة تجريبية من الحملة. تحتوي الحملة على بعض التعديلات من حملة أساسية، ويتم تحويل نسبة مئوية من الزيارات من حملة BASE إلى هذه الحملة التجريبية.

FrequencyCapEntry

يشير ذلك المصطلح إلى قاعدة تحدِّد الحدّ الأقصى لعدد مرات عرض إعلان (أو مجموعة معيّنة من الإعلانات) على المستخدِم خلال فترة زمنية معيّنة.

تمثيل JSON 
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
الحقول
key

object (FrequencyCapKey)

مفتاح تحديد عدد مرات ظهور معيّن. لا يجوز أن يكون هناك أكثر من تحديد واحد لعدد مرات الظهور باستخدام المفتاح نفسه.
cap

integer

الحد الأقصى لعدد الأحداث المسموح بها خلال النطاق الزمني حسب هذا الحد الأقصى.

FrequencyCapKey

مجموعة من الحقول تُستخدم كمفاتيح لتحديد عدد مرات الظهور. لا يمكن تحديد أكثر من مرة ظهور واحدة باستخدام المفتاح نفسه.

تمثيل JSON 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
الحقول
level

enum (FrequencyCapLevel)

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

enum (FrequencyCapEventType)

نوع الحدث الذي ينطبق عليه الحد الأقصى (على سبيل المثال، مرّات الظهور).
timeUnit

enum (FrequencyCapTimeUnit)

الوحدة الزمنية التي تم تحديد الحدّ الأقصى لها (مثلاً، يوم أو أسبوع).
timeLength

integer

يشير ذلك إلى عدد الوحدات الزمنية التي يستمر خلالها الحد الأقصى.

FrequencyCapLevel

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
AD_GROUP_AD ويتم تطبيق الحد الأقصى على مستوى إعلان المجموعة الإعلانية.
AD_GROUP ويتم تطبيق الحد الأقصى على مستوى المجموعة الإعلانية.
CAMPAIGN ويتم تطبيق هذا الحدّ على مستوى الحملة.

FrequencyCapEventType

نوع الحدث الذي ينطبق عليه الحد الأقصى (على سبيل المثال، مرّات الظهور).

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
IMPRESSION وينطبق هذا الحد الأقصى على مرات ظهور الإعلان.
VIDEO_VIEW وينطبق هذا الحد الأقصى على مشاهدات إعلانات الفيديو.

BrandSafetySuitability

عناصر التحكّم في مدى ملاءمة أمان العلامة التجارية من ثلاثة مستويات

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
EXPANDED_INVENTORY يتيح لك هذا الخيار عرض الإعلانات على مستوى المستودع الإعلاني بالكامل على YouTube وشركاء إعلانات الفيديو التي تستوفي معايير تحقيق الربح. وقد يكون هذا الخيار مناسبًا للعلامات التجارية التي تريد الوصول إلى النطاق الكامل من الفيديوهات المؤهَّلة للإعلانات، بما في ذلك على سبيل المثال لا الحصر، الفيديوهات التي تحتوي على ألفاظ نابية قوية في سياق الكوميديا أو الفيديوهات الوثائقية أو العنف المفرط كما يظهر في ألعاب الفيديو.
STANDARD_INVENTORY يتيح لك هذا الخيار عرض الإعلانات على مجموعة واسعة من المحتوى المناسب لمعظم العلامات التجارية، مثل الفيديوهات الموسيقية الرائجة والأفلام الوثائقية والمقاطع الدعائية للأفلام. يستند المحتوى الذي يمكنك عرض الإعلانات عليه إلى إرشادات المحتوى المناسب للمعلنين على YouTube والتي تأخذ في الاعتبار، على سبيل المثال، مدى قوة اللغة النابية أو تكرارها أو مدى ملاءمة الموضوع محل البحث، مثل الأحداث الحسّاسة. ولن تظهر الإعلانات مثلاً على المحتوى الذي تتكرّر فيه الألفاظ النابية أو المحتوى الجنسي القوي أو المحتوى الذي يتضمّن مشاهد عنف قاسية.
LIMITED_INVENTORY يتيح لك هذا الخيار إمكانية عرض الإعلانات على نطاق محدود من المحتوى المناسب للعلامات التجارية التي تتّبع إرشادات صارمة بشأن اللغة غير اللائقة والإيحاءات الجنسية. وتتجاوز هذه الإرشادات ما تتناوله إرشادات المحتوى المناسب للمعلنين على YouTube. وتستوفي الفيديوهات التي يمكن الوصول إليها ضمن هذه الفئة الحساسة متطلبات عالية، لا سيما اللغة غير اللائقة والإيحاءات الجنسية. على سبيل المثال، سيتم استبعاد عرض إعلاناتك على بعض الفيديوهات الموسيقية الأكثر رواجًا في YouTube وغيرها من محتوى الثقافة الشعبية على منصة YouTube وشركاء Google لإعلانات الفيديو.

VanityPharma

يصف كيفية عرض إعلانات المستحضرات الدوائية التي لا تتضمّن علامات تجارية.

تمثيل JSON 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
الحقول
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

وضع عرض عناوين URL للمستحضرات الصيدلانية المخصصة.
vanityPharmaText

enum (VanityPharmaText)

النص الذي سيتم عرضه في عنوان URL المعروض للإعلان النصي عندما يكون وصف الموقع الإلكتروني هو وضع العرض المحدّد لعناوين URL للمستحضرات الصيدلانية المخصصة.

VanityPharmaDisplayUrlMode

يشير هذا المقياس إلى قيم التعداد التي تصف أوضاع العرض المحتمَلة لعناوين URL الخاصة بالمستحضرات الصيدلانية المخصصة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
MANUFACTURER_WEBSITE_URL استبدِل عنوان URL للمستحضرات الصيدلانية المخصّصة بعنوان URL للموقع الإلكتروني الخاص بالشركة المصنّعة.
WEBSITE_DESCRIPTION استبدل عنوان URL للمستحضرات الصيدلانية المخصص بوصف الموقع الإلكتروني.

VanityPharmaText

يشير قيم التعداد إلى نص محتمَل.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
PRESCRIPTION_TREATMENT_WEBSITE_EN موقع إلكتروني للعلاجات التي تستلزم وصفة طبية مع محتوى موقع إلكتروني باللغة الإنجليزية
PRESCRIPTION_TREATMENT_WEBSITE_ES موقع إلكتروني للعلاجات التي تستلزم وصفة طبية ويتضمّن محتوىً للموقع الإلكتروني باللغة الإسبانية (Sitio de tratamientos con receta)
PRESCRIPTION_DEVICE_WEBSITE_EN موقع إلكتروني للأجهزة التي تستلزم وصفة طبية مع محتوى موقع إلكتروني باللغة الإنجليزية
PRESCRIPTION_DEVICE_WEBSITE_ES موقع إلكتروني خاص بالأجهزة التي تستلزم وصفة طبية ويحتوي على محتوى موقع إلكتروني باللغة الإسبانية (Sitio de dispositivos con receta)
MEDICAL_DEVICE_WEBSITE_EN موقع إلكتروني خاص بالأجهزة الطبية ويتضمّن محتوى موقع إلكتروني باللغة الإنجليزية
MEDICAL_DEVICE_WEBSITE_ES موقع إلكتروني خاص بالأجهزة الطبية يتضمّن محتوى على موقع إلكتروني باللغة الإسبانية (Sitio de dispositivos médicos)
PREVENTATIVE_TREATMENT_WEBSITE_EN موقع إلكتروني للعلاجات الوقائية يتضمّن محتوًى باللغة الإنجليزية
PREVENTATIVE_TREATMENT_WEBSITE_ES موقع إلكتروني خاص بالعلاجات الوقائية يتضمّن محتوًى باللغة الإسبانية (Sitio de tratamientos preventivos)
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN موقع إلكتروني لوسائل منع الحمل التي تستلزم وصفة طبية مع محتوى موقع إلكتروني باللغة الإنجليزية
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES موقع إلكتروني لوسائل منع الحمل التي تستلزم وصفة طبية ومحتوى موقع إلكتروني باللغة الإسبانية (Sitio de anticonceptivos con receta)
PRESCRIPTION_VACCINE_WEBSITE_EN موقع إلكتروني للّقاحات التي تستلزم وصفة طبية ويتضمّن محتوى موقعًا إلكترونيًا باللغة الإنجليزية
PRESCRIPTION_VACCINE_WEBSITE_ES موقع إلكتروني للّقاحات التي تستلزم وصفة طبية ويتضمّن محتوىً للموقع الإلكتروني باللغة الإسبانية (Sitio de vacunas con receta)

SelectiveOptimization

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

تمثيل JSON 
{
  "conversionActions": [
    string
  ]
}
الحقول
conversionActions[]

string

المجموعة المختارة من إجراءات الإحالات الناجحة لتحسين هذه الحملة.

OptimizationGoalSetting

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

تمثيل JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
الحقول
optimizationGoalTypes[]

enum (OptimizationGoalType)

قائمة أنواع أهداف التحسين

OptimizationGoalType

نوع هدف التحسين

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN ويتم استخدامها كقيمة معروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
CALL_CLICKS التحسين لزيادة النقرات على زرّ الاتصال الإحالات الناجحة الناتجة عن النقر للاتصال هي المرات التي اختار فيها الأشخاص "الاتصال" للتواصل مع متجر بعد عرض إعلان.
DRIVING_DIRECTIONS تحسين اتجاهات القيادة الإحالات الناجحة لاتجاهات القيادة هي المرات التي اختار فيها الأشخاص "الحصول على الاتجاهات" للانتقال إلى متجر بعد مشاهدة إعلان.
APP_PRE_REGISTRATION تحسين التسجيل المُسبَق الإحالات الناجحة للتسجيل المُسبَق هي عدد اشتراكات التسجيل المُسبَق التي تتلقّى إشعارًا عند إصدار التطبيق.

TrackingSetting

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

تمثيل JSON 
{
  "trackingUrl": string
}
الحقول
trackingUrl

string

النتائج فقط. عنوان URL المستخدَم للتتبّع الديناميكي.

PaymentMode

يصف التعداد طُرق الدفع المحتملة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
CLICKS الدفع لكل تفاعل.
CONVERSION_VALUE الدفع حسب قيمة الإحالة الناجحة. لا يتوافق هذا الوضع إلا مع الحملات التي تحتوي على AdvertisingChannelType.الكشف عن استراتيجية عروض الأسعار الاستراتيجيةServiceType.COMMIIION وBudgetType.STANDARD.
CONVERSIONS الدفع لكل إحالة ناجحة. لا يتوافق هذا الوضع إلا مع الحملات التي تحتوي على AdvertisingChannelType.DISPLAY (باستثناء AdvertisingChannelSubType.DISPLAY_ لِلْحمولات الإعلانية) و BiddingStrategyType.TARGET_CPA وBudgetType.FIXED_CPA. ويجب أن يكون العميل مؤهَّلاً أيضًا لاستخدام هذا الوضع. يُرجى الاطّلاع على Customer.eligibility_failure_reasons للحصول على التفاصيل.
GUEST_STAY ويتمّ الدفع مقابل قيمة إقامة النزيل. لا يتوافق هذا الوضع إلا مع الحملات التي تحتوي على AdvertisingChannelType.الكشف عن استراتيجية عروض الأسعار الاستراتيجيةServiceType.COMMIIION وBudgetType.STANDARD.

PerformanceMaxUpgrade

معلومات عن حملة تتم ترقيتها إلى حملة "الأداء الأفضل".

تمثيل JSON 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
الحقول
performanceMaxCampaign

string

النتائج فقط. يشير إلى "حملة الأداء الأفضل" التي تمّت ترقية الحملة إليها.
preUpgradeCampaign

string

النتائج فقط. يشير إلى الحملة القديمة التي تمت ترقيتها إلى حملة "الأداء الأفضل".
status

enum (PerformanceMaxUpgradeStatus)

النتائج فقط. حالة ترقية الحملة المطلوب ترقيتها إلى "حملة الأداء الأفضل".

PerformanceMaxUpgradeStatus

تعداد حالة ترقية "حملة الأداء الأفضل" للحملة

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
UPGRADE_ELIBIGLE تكون الحملة مؤهَّلة للترقية إلى "حملة الأداء الأفضل".
UPGRADE_IN_PROGRESS جارٍ الترقية إلى "حملة الأداء الأفضل".
UPGRADE_COMPLETE اكتملت عملية الترقية إلى "حملة الأداء الأفضل".
UPGRADE_FAILED تعذّرت الترقية إلى "حملة الأداء الأفضل". سيستمر عرض الحملة على النحو الذي كانت عليه قبل محاولة الترقية.

ListingType

أنواع البيانات المحتملة:

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
VEHICLES تعرِض هذه الحملة إعلانات المركبات.

العمولة

العمولات هي استراتيجية عروض أسعار تلقائية يدفع المعلِن فيها جزءًا معيّنًا من قيمة الإحالة الناجحة.

تمثيل JSON 
{
  "commissionRateMicros": string
}
الحقول
commissionRateMicros

string (int64 format)

يحدِّد معدّل العمولة جزء قيمة الإحالة الناجحة الذي سيتم تحصيل رسومه من المعلِن. يجب إدخال معدل عمولة بقيمة x في هذا الحقل على النحو التالي (x * 1,000,000). على سبيل المثال، يمثّل الرقم 106,000 معدّل عمولة يبلغ 0.106 (%10.6).

ManualCpa

لا يشتمل هذا النوع على أي حقول.

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

ManualCpc

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

تمثيل JSON 
{
  "enhancedCpcEnabled": boolean
}
الحقول
enhancedCpcEnabled

boolean

ما إذا كان سيتم تحسين عروض الأسعار استنادًا إلى بيانات محسِّن الإحالات الناجحة

ManualCpm

لا يشتمل هذا النوع على أي حقول.

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

ManualCpv

لا يشتمل هذا النوع على أي حقول.

الاطّلاع على عروض الأسعار المستندة إلى والتي يدفع فيها المستخدم مقابل كل مشاهدة للفيديو

PercentCpc

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

تمثيل JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
الحقول
cpcBidCeilingMicros

string (int64 format)

الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. هذا حقل اختياري يدخله المعلِن ويتم تحديده بوحدات المايكرو المحلية. ملاحظة: يتم تفسير القيمة صفر بالطريقة نفسها التي يتم بها تفسير سمة Bid_ اثنين غير محددة.
enhancedCpcEnabled

boolean

يُعدّل عرض السعر لكل مزاد برفعه أو خفضه، استنادًا إلى احتمالية تحقيق إحالة ناجحة. قد تتجاوز عروض الأسعار الفردية cpcBidCeilingMicros، ولكن يجب ألا يحدث متوسط مبلغ عرض السعر للحملة.

TargetCpm

التكلفة المستهدَفة لكلّ ألف ظهور هي استراتيجية عروض أسعار مبرمَجة تضبط عروض الأسعار لتحسين الأداء في ضوء التكلفة المستهدَفة لكلّ ألف ظهور التي تحدّدها.

تمثيل JSON 
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
الحقول
حقل الاتحاد goal معلومات إضافية ذات صلة بهدف عروض الأسعار يمكن أن يكون الحقل "goal" واحدًا فقط مما يلي:
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

تفاصيل هدف عروض أسعار عدد مرّات الظهور المستهدَف

TargetCpmTargetFrequencyGoal

تفاصيل هدف عروض أسعار عدد مرّات الظهور المستهدَف

تمثيل JSON 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
الحقول
targetCount

string (int64 format)

يمثّل عدد "عدد مرّات الظهور المستهدَف" عدد المرّات التي تريد الوصول فيها إلى مستخدِم واحد.
timeUnit

enum (TargetFrequencyTimeUnit)

فترة زمنية تعبّر عن الفترة التي تريد الوصول خلالها إلى targetCount المحدَّدة.

TargetFrequencyTimeUnit

يشير التعداد إلى الفترة الزمنية التي نريد الوصول من خلالها إلى عدد مرّات الظهور المستهدَف.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
WEEKLY حسِّن عروض الأسعار للوصول إلى عدد مرّات الظهور المستهدَف في أسبوع.