AssetGroup

مجموعة مواد عرض. يتم استخدام AssetGroupAsset لربط مادة عرض بمجموعة مواد العرض. يتم استخدام AssetGroupSignal لربط إشارة بمجموعة مواد عرض.

تمثيل JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "primaryStatus": enum (AssetGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AssetGroupPrimaryStatusReason)
  ],
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
الحقول
resourceName

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

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

campaign

string

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

name

string

مطلوبة. اسم مجموعة مواد العرض. مطلوبة. يجب أن يبلغ طولها 1 كحد أدنى و128 طولاً بحد أقصى. ويجب أن يكون فريدًا ضمن الحملة.

finalUrls[]

string

قائمة بعناوين URL النهائية بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهّلة لتوسيعها ما لم يتم إيقافها.

finalMobileUrls[]

string

قائمة بعناوين URL النهائية للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهّلة لتوسيعها ما لم يتم إيقافها.

status

enum (AssetGroupStatus)

حالة مجموعة مواد العرض

primaryStatus

enum (AssetGroupPrimaryStatus)

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

primaryStatusReasons[]

enum (AssetGroupPrimaryStatusReason)

النتائج فقط. يقدِّم أسبابًا لعدم ظهور مجموعة مواد عرض أو عدم عرض إعلاناتها على النحو الأمثل. وستكون مجموعة مواد العرض فارغة عندما يتم عرض مجموعة مواد العرض بدون مشاكل.

path1

string

الجزء الأول من النص الذي قد يظهر مرفقًا بعنوان URL المعروض في الإعلان

path2

string

الجزء الثاني من النص الذي قد يظهر ملحقًا بعنوان URL المعروض في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط المسار 1.

adStrength

enum (AdStrength)

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

AssetGroupStatus

الحالات المحتملة لمجموعة مواد عرض.

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

AssetGroupPrimaryStatus

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

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

AssetGroupPrimaryStatusReason

يشير عمود التعداد إلى الأسباب المحتملة للحالة الأساسية لمجموعة مواد العرض. يقدِّم أسبابًا لعدم ظهور مجموعة مواد عرض أو عدم عرض إعلاناتها على النحو الأمثل. وستكون مجموعة مواد العرض فارغة عندما يتم عرض مجموعة مواد العرض بدون مشاكل.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ASSET_GROUP_PAUSED إنّ حالة مجموعة مواد العرض التي يحدّدها المستخدِم متوقفة مؤقتًا.
ASSET_GROUP_REMOVED تتم إزالة حالة مجموعة مواد العرض التي يحدّدها المستخدِم.
CAMPAIGN_REMOVED وتتم إزالة حالة الحملة التي يحدّدها المستخدِم.
CAMPAIGN_PAUSED حالة الحملة التي حدّدها المستخدِم متوقفة مؤقتًا.
CAMPAIGN_PENDING الوقت الذي يحدّده المستخدم لبدء هذه الحملة هو في المستقبل.
CAMPAIGN_ENDED لقد انقضى الوقت الذي حدّده المستخدم لانتهاء هذه الحملة.
ASSET_GROUP_LIMITED تمت الموافقة على مجموعة مواد العرض، ولكنّها لا تعرض إعلاناتها إلا بقدر محدود بسبب السياسات.
ASSET_GROUP_DISAPPROVED تم وضع علامة على مجموعة مواد العرض على أنّها مرفوضة.
ASSET_GROUP_UNDER_REVIEW لم تكتمل مجموعة مواد العرض عملية التحقّق من الالتزام بالسياسات.