تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على مقدمة عن REST للحصول على التفاصيل.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

AdGroup

تمثيل JSON
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- تمثيل JSON

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

تمثيل JSON

تمثيل JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

الحقول
`resourceName`	`string` غير قابل للتغيير. اسم مورد المجموعة الإعلانية. وتكون أسماء موارد المجموعة الإعلانية على النحو التالي: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` حالة المجموعة الإعلانية.
`type`	`enum (AdGroupType)` غير قابل للتغيير. نوع المجموعة الإعلانية.
`adRotationMode`	`enum (AdGroupAdRotationMode)` وضع عرض الإعلانات بالتناوب للمجموعة الإعلانية.
`urlCustomParameters[]`	`object (CustomParameter)` قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصَّصة في `trackingUrlTemplate` أو `finalUrls` أو `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` صحيح في حال تفعيل ميزة "الاستهداف المحسّن". سيحلّ "الاستهداف المحسّن" محلّ ميزة "توسيع نطاق الجمهور".
`displayCustomBidDimension`	`enum (TargetingDimension)` تسمح للمعلِنين بتحديد مكوّن استهداف يمكن وضع عروض الأسعار المطلقة عليه. ولا ينطبق هذا إلا على الحملات التي تستهدف الشبكة الإعلانية فقط وليس شبكة البحث.
`targetingSetting`	`object (TargetingSetting)` إعداد لاستهداف الميزات ذات الصلة.
`audienceSetting`	`object (AudienceSetting)` غير قابل للتغيير. إعداد للميزات ذات الصلة بالجمهور.
`effectiveTargetCpaSource`	`enum (BiddingSource)` النتائج فقط. مصدر التكلفة المستهدفة الفعالة للإجراء. هذا الحقل للقراءة فقط.
`effectiveTargetRoasSource`	`enum (BiddingSource)` النتائج فقط. مصدر عائد النفقات الإعلانية المستهدف الفعال. هذا الحقل للقراءة فقط.
`labels[]`	`string` النتائج فقط. أسماء موارد التصنيفات المرفقة بهذه المجموعة الإعلانية.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` أنواع حقول مواد العرض التي يجب استبعادها من هذه المجموعة الإعلانية. لن تعمل هذه المجموعة الإعلانية على اكتساب روابط مواد العرض التي تتضمّن أنواع الحقول هذه من المستويات العليا.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` أنواع مجموعات مواد العرض التي يجب استبعادها من هذه المجموعة الإعلانية. ولن تكتسب هذه المجموعة الإعلانية روابط مجموعة مواد العرض من المستويات الأعلى. أنواع مجموعات المواقع الجغرافية (نشاطي التجاري على Google Cloud_DYNAMIC_LOCATION_GROUP وCHAIN_DYNAMIC_LOCATION_GROUP وStatIC_LOCATION_GROUP) هي أنواع فرعية من LOCATION_SYNC. وبالتالي، في حال ضبط LOCATION_SYNC لهذا الحقل، لا يُسمح بربط كل مجموعات مواد عرض مجموعة المواقع الجغرافية بهذه المجموعة الإعلانية، ولن يتم عرض كل إضافات المواقع الجغرافية وإضافات مواقع المعلِنين الجغرافية ضمن هذه المجموعة الإعلانية. لا يتوفّر في الوقت الحالي سوى LOCATION_SYNC.
`id`	`string (int64 format)` النتائج فقط. رقم تعريف المجموعة الإعلانية.
`name`	`string` اسم المجموعة هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء مجموعات إعلانية جديدة. ويجب أن يحتوي على أقل من 255 حرفًا بالعرض الكامل بترميز UTF-8. يجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 0xA) أو حروف رجوع إلى أول السطر (الرمز 0xD).
`baseAdGroup`	`string` النتائج فقط. بالنسبة إلى المجموعات الإعلانية الاختبارية أو التجريبية، يمثل هذا الحقل اسم مورد المجموعة الإعلانية الأساسية التي تم إنشاء هذه المجموعة الإعلانية منها. إذا لم تكن هناك مجموعة إعلانية مسودة أو مجموعة إعلانية تجريبية تحتوي على مجموعة إعلانية أساسية، يكون هذا الحقل خاليًا. بالنسبة إلى المجموعات الإعلانية الأساسية، يساوي هذا الحقل اسم مورد المجموعة الإعلانية. هذا الحقل للقراءة فقط.
`trackingUrlTemplate`	`string` نموذج عنوان URL لإنشاء عنوان URL للتتبّع.
`campaign`	`string` غير قابل للتغيير. الحملة التي تنتمي إليها المجموعة الإعلانية.
`cpcBidMicros`	`string (int64 format)` عرض السعر الأقصى للنقرة.
`effectiveCpcBidMicros`	`string (int64 format)` النتائج فقط. ستكون القيمة مماثلة لقيمة عرض سعر النقرة عندما تكون استراتيجية عروض الأسعار إحدى تكلفة النقرة اليدوية أو تكلفة النقرة المحسّنة أو حصة المرتبة الأعلى المستهدفة في الصفحة الأولى أو حصة المرتبة الأعلى المستهدفة، وإلا ستكون القيمة فارغة.
`cpmBidMicros`	`string (int64 format)` عرض السعر الأقصى لكل ألف ظهور.
`targetCpaMicros`	`string (int64 format)` التكلفة المستهدفة للإجراء. وإذا كانت استراتيجية عروض أسعار الحملة للمجموعة الإعلانية هي التكلفة المستهدفة للإجراء أو تحقيق الحد الأقصى من الإحالات الناجحة (مع ضبط حقل التكلفة المستهدفة للإجراء)، فعندئذٍ يلغي هذا الحقل التكلفة المستهدفة للإجراء المحدّدة في استراتيجية عروض أسعار الحملة. وبخلاف ذلك، يتم تجاهل هذه القيمة.
`cpvBidMicros`	`string (int64 format)` عرض سعر المشاهدة.
`targetCpmMicros`	`string (int64 format)` متوسّط المبلغ بالمايكرو الذي يرغب المعلِن في دفعه مقابل كل ألف مرّة ظهور للإعلان.
`targetRoas`	`number` إلغاء عائد الإنفاق الإعلاني المستهدف (ROAS). إذا كانت استراتيجية عروض أسعار الحملة ضمن المجموعة الإعلانية هي TargetRoas أو الحد الأقصى من الإحالات الناجحة (مع ضبط حقل targetRoas) الخاص بها، فإن هذا الحقل يلغي عائد الإنفاق الإعلاني المستهدف المحدّد في استراتيجية عروض أسعار الحملة. وبخلاف ذلك، يتم تجاهل هذه القيمة.
`percentCpcBidMicros`	`string (int64 format)` النسبة المئوية لمبلغ عرض سعر النقرة، معبرًا عنه كجزء من السعر المُعلن عنه لبعض السلع أو الخدمات. النطاق الصالح للكسر هو [0,1) والقيمة المخزنة هنا هي 1,000,000 * [كسر].
`finalUrlSuffix`	`string` نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي.
`effectiveTargetCpaMicros`	`string (int64 format)` النتائج فقط. التكلفة المستهدفة الفعالة للإجراء. هذا الحقل للقراءة فقط.
`effectiveTargetRoas`	`number` النتائج فقط. عائد الإنفاق الإعلاني المستهدف الفعلي. هذا الحقل للقراءة فقط.

AdGroupStatus

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

عمليات التعداد
`UNSPECIFIED`	لم يتم تحديد الحالة.
`UNKNOWN`	القيمة التي تم استلامها غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط.
`ENABLED`	المجموعة الإعلانية مفعّلة.
`PAUSED`	المجموعة الإعلانية متوقفة مؤقتًا.
`REMOVED`	تمت إزالة المجموعة الإعلانية.

AdGroupType

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

عمليات التعداد
`UNSPECIFIED`	لم يتم تحديد النوع.
`UNKNOWN`	القيمة التي تم استلامها غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط.
`SEARCH_STANDARD`	نوع المجموعة الإعلانية التلقائي للحملات على شبكة البحث.
`DISPLAY_STANDARD`	نوع المجموعة الإعلانية التلقائي للحملات على الشبكة الإعلانية.
`SHOPPING_PRODUCT_ADS`	نوع المجموعة الإعلانية لحملات التسوّق التي تعرض إعلانات المنتجات العادية.
`HOTEL_ADS`	النوع التلقائي للمجموعة الإعلانية لحملات الفنادق.
`SHOPPING_SMART_ADS`	نوع المجموعات الإعلانية في حملات Shopping الذكية.
`VIDEO_BUMPER`	إعلانات قصيرة غير قابلة للتخطي أثناء عرض الفيديو.
`VIDEO_TRUE_VIEW_IN_STREAM`	إعلانات فيديو TrueView (القابلة للتخطي) أثناء عرض الفيديو.
`VIDEO_TRUE_VIEW_IN_DISPLAY`	إعلانات فيديو TrueView ضمن العرض
`VIDEO_NON_SKIPPABLE_IN_STREAM`	الإعلانات غير القابلة للتخطي أثناء عرض الفيديو
`VIDEO_OUTSTREAM`	إعلانات خارج بث الفيديو
`SEARCH_DYNAMIC_ADS`	نوع المجموعة الإعلانية للمجموعات الإعلانية للإعلانات الديناميكية على شبكة البحث.
`SHOPPING_COMPARISON_LISTING_ADS`	نوع المجموعات الإعلانية في حملات بيانات المقارنة في Shopping.
`PROMOTED_HOTEL_ADS`	نوع المجموعة الإعلانية للمجموعات الإعلانية للفنادق التي يتم الترويج لها.
`VIDEO_RESPONSIVE`	المجموعات الإعلانية المتجاوبة للفيديو.
`VIDEO_EFFICIENT_REACH`	المجموعات الإعلانية لإعلانات الفيديو التي تركز على الوصول الفعّال
`SMART_CAMPAIGN_ADS`	نوع المجموعة الإعلانية للحملات الذكية.
`TRAVEL_ADS`	نوع المجموعة الإعلانية "لحملات السفر".

AdGroupAdRotationMode

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

عمليات التعداد
`UNSPECIFIED`	لم يتم تحديد وضع عرض الإعلانات بالتناوب.
`UNKNOWN`	القيمة التي تم استلامها غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط.
`OPTIMIZE`	تحسين إعلانات المجموعة الإعلانية استنادًا إلى النقرات أو الإحالات الناجحة.
`ROTATE_FOREVER`	عرض الإعلانات بالتناوب بشكل متساوٍ.

AudienceSetting

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

تمثيل JSON
{ "useAudienceGrouped": boolean }

الحقول

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

useAudienceGrouped

boolean

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