البيانات المنظَّمة - الإصدار 9 - المجموعة الإعلانية

راجِع النظرة العامة للحصول على شرح حول التنسيق.

الحقلمطلوبالنوعقابل للكتابةالوصف
معرِّف المجموعة الإعلانيةمطلوب فقط عند تعديل المجموعات الإعلانية الحاليةعدد صحيحلاقيمة رقم التعريف العددي للمجموعة الإعلانية. إذا تُرك هذا الحقل فارغًا، سيتم إنشاء معرّف جديد لمجموعة الإعلانات وسيتم تعيين معرّف فريد. اختياريًا، عند إنشاء مجموعات إعلانية جديدة، يمكنك استخدام معرّف مخصّص بغرض تعيين "إعلانات TrueView" للمجموعة الإعلانية الجديدة. تنسيق المعرّف المخصّص هو "ext[المعرّف المخصّص]"، مثل ext123. عند تحميل الملف ومعالجته، سيتم استبدال جميع المعرّفات المخصّصة بأرقام التعريف التي يحدّدها "مدير حملة DoubleClick"، وسيتم ربط العناصر (على سبيل المثال، الإعلان بالمجموعة الإعلانية) استنادًا إلى المعرّفات المخصّصة.
معرّف العنصرنعمعدد صحيحلاقيمة المعرّف الرقمي للعنصر الرئيسي. يمكنك تحديد معرّف مخصّص (على سبيل المثال، "ext[custom line item ID]") لسلعة في سطر تنشئها في الوقت نفسه الذي تنشئ فيه هذه المجموعة الإعلانية.
اسم العنصرلاسلسلةلااسم العنصر
الاسمنعمسلسلةنعماسم الإدخال.
الحالةنعمسلسلةنعمتمثّل هذه السمة حالة الإدخال.
  • نشِط
  • متوقف مؤقتًا
  • محذوف
شكل إعلان الفيديونعمسلسلةنعمشكل الإعلان للمجموعة الإعلانية.

اختَر إحدى القيم التالية:
  • ضمن البث المباشر
  • إعلان فيديو ضمن الخلاصة
  • إعلان ملصق صغير
  • غير قابلة للتخطي
  • المتجاوب
  • مدى الوصول الفعّال
  • الملف الصوتي على YouTube
  • الحملات لزيادة الطلب
تكلفة عرض السعرنعمعدد عائمنعمالقيمة التي تمثّل الحدّ الأقصى لعرض السعر المستهدف للمجموعة الإعلانية استنادًا إلى نوع عرض السعر الذي تمّ ضبطه في عمود "نوع استراتيجية عروض الأسعار في TrueView". على سبيل المثال، إذا كان "نوع استراتيجية عروض أسعار TrueView" هو "التكلفة القصوى لكل مشاهدة اليدوية"، يكون هذا هو الحدّ الأقصى للتكلفة لكل مشاهدة.

ملاحظة: إذا كان عمود "نوع استراتيجية عروض أسعار TrueView" هو "تحقيق الحد الأقصى من الإحالات الناجحة" أو "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" أو "تحقيق الحد الأقصى من النقرات"، يجب أن تكون قيمة هذا العمود 0 عند التحميل.
استهداف الكلمات الرئيسية - التضمينلاسلسلة أو قائمةنعم

قائمة بسلاسل الكلمات الرئيسية المطلوب تضمينها في الاستهداف.

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

استهداف الكلمات الرئيسية - الاستبعادلاسلسلة أو قائمةنعم

قائمة سلاسل الكلمات الرئيسية التي يجب استبعادها في الاستهداف.

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

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

قائمة بالفئات المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_CATEGORY.

تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

استهداف الفئات - الاستبعادلاسلسلة أو قائمةنعمقائمة الفئات المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_CATEGORY.

تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

استهداف مواضع الإعلان - قنوات YouTube - تضمينلاسلسلة أو قائمةنعمقائمة بقنوات YouTube التي سيتم تضمينها
استهداف مواضع الإعلان - قنوات YouTube - استبعادلاسلسلة أو قائمةنعمقائمة بقنوات YouTube التي سيتم استبعادها
استهداف مواضع الإعلان - فيديوهات YouTube - تضمينلاسلسلة أو قائمةنعمقائمة فيديوهات YouTube التي سيتم تضمينها
استهداف مواضع الإعلان - فيديوهات YouTube - استبعادلاسلسلة أو قائمةنعمقائمة بفيديوهات YouTube التي سيتم استبعادها
استهداف مواضع الإعلان - المحتوى الرائج - تضمينلاسلسلة أو قائمةنعمقائمة بالمحتوى الرائج على YouTube و"شركاء Google لإعلانات الفيديو" الذي تريد تضمينه اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • youtube_popular_content::001a1
  • gvp_popular_content::global_tier2
  • video_content::<ID>
استهداف مواضع الإعلان - عناوين URL - تضمينلاسلسلة أو قائمةنعمقائمة بعناوين URL المطلوب تضمينها
استهداف مواضع الإعلانات - عناوين URL - استبعادلاسلسلة أو قائمةنعمقائمة بعناوين URL المطلوب استبعادها
استهداف مواضع الإعلان - التطبيقات - تضمينلاسلسلة أو قائمةنعمقائمة بالتطبيقات المتوافقة مع الأجهزة الجوّالة التي سيتم تضمينها
استهداف مواضع الإعلان - التطبيقات - استبعادلاسلسلة أو قائمةنعمقائمة التطبيقات المتوافقة مع الأجهزة الجوّالة التي سيتم استبعادها
استهداف مواضع الإعلان - مجموعات التطبيقات - تضمينلاسلسلة أو قائمةنعمقائمة مجموعات التطبيقات التي سيتم تضمينها في الاستهداف تنسيق القائمة= رقم تعريف مجموعة التطبيقات؛ رقم تعريف مجموعة التطبيقات؛
استهداف مواضع الإعلان - مجموعات التطبيقات - استبعادلاسلسلة أو قائمةنعمقائمة مجموعات التطبيقات المطلوب استبعادها من الاستهداف. تنسيق القائمة= رقم تعريف مجموعة التطبيقات؛ رقم تعريف مجموعة التطبيقات؛
استهداف الفئة الديمغرافية حسب الجنسنعمسلسلة أو قائمةنعمقائمة الأجناس المطلوب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • أنثى
  • ذكر
  • غير معروف
استهداف الفئة الديمغرافية حسب العمرنعمسلسلة أو قائمةنعمقائمة بالأعمار المطلوب استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة.
  • 18-24
  • 34-25
  • 44-35
  • 45-54
  • 55-64
  • 65+
  • غير معروف
استهداف الفئات الديمغرافية حسب دخل الأسرةنعمسلسلة أو قائمةنعمقائمة بدخول الأسر التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة.
  • أعلى 10%
  • 11 -‏ 20‏%
  • 21‏ - 30‏%
  • 31‏ - 40‏%
  • 41 - 50‏%
  • أدنى 50%
  • غير معروف
استهداف الفئة الديمغرافية حسب الحالة الأبويةنعمسلسلة أو قائمةنعمقائمة بالحالات الأبوية التي تريد استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة.
  • أحد الوالدين
  • ليس أحد الوالدين
  • غير معروف
الاستهداف المحسّنلاسلسلةنعمفعِّل ميزة "الاستهداف المحسّن".
  • صواب
  • خطأ

لا يتوافق الاستهداف المحسّن مع جميع استراتيجيات عروض الأسعار. يجب أن تكون قيمة هذا العمود هي FALSE في الحالات التالية:
  • قيمة "نوع استراتيجية عروض الأسعار" هي "ثابتة"
  • "نوع استراتيجية عروض الأسعار" هو "التكلفة المحسّنة لكلّ ألف ظهور"
  • "نوع استراتيجية عروض الأسعار" هو "الحدّ الأقصى" و"وحدة استراتيجية عروض الأسعار" هي "CIVA" أو "IVO_TEN" أو "AV_VIEWED"
مستوى توسيع نطاق الجمهورلاعدد صحيحنعممستوى توسيع نطاق الجمهور يمكن ضبطها فقط على مجموعات إعلانية بالقيمة 0 أو 1 أو 2 أو 3.
تم استبعاد قائمة المحتوى الأساسي لميزة "توسيع نطاق الجمهور"لاسلسلةنعمتم استبعاد قائمة المحتوى الأساسي لميزة "توسيع نطاق الجمهور".
  • صواب
  • خطأ
استهداف الجمهور - تضمينلاسلسلة أو قائمةنعم

قائمة بقوائم المستخدمين المطلوب تضمينها

يستخدِم هذا العمود أرقام تعريف الموارد FirstPartyAndPartnerAudience في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

تنسيق القائمة = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

استهداف الجمهور - الاستبعادلاسلسلة أو قائمةنعم

قائمة بقوائم المستخدمين التي سيتم استبعادها

يستخدِم هذا العمود أرقام تعريف الموارد FirstPartyAndPartnerAudience في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

تنسيق القائمة = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

قائمة بشرائح الجمهور المشابهة المطلوب تضمينها في الاستهداف

تنسيق القائمة: رقم تعريف الجمهور المشابه؛ رقم تعريف الجمهور المشابه؛

لا تتوفّر إلا لمجموعات إعلانية في "حملات زيادة الطلب".
استهداف شرائح الجمهور المشابهة - الاستبعادلاسلسلة أو قائمةنعم

قائمة بشرائح الجمهور المشابهة التي سيتم استبعادها في الاستهداف

تنسيق القائمة: رقم تعريف الجمهور المشابه؛ رقم تعريف الجمهور المشابه؛

لا تتوفّر إلا لمجموعات إعلانية في "حملات زيادة الطلب".
استهداف الجمهور ذي الاهتمامات المشتركة والجمهور في السوق - تضمينلاسلسلة أو قائمةنعم

قائمة بقوائم الجمهور ذي الاهتمامات المشتركة و/أو قوائم الجمهور في السوق المطلوب تضمينها.

يمكن استرداد أرقام تعريف قوائم المستخدِمين من واجهة "مساحة العرض والفيديو 360".

تنسيق القائمة = (رقم تعريف الجمهور؛ رقم تعريف الجمهور؛ إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

استهداف الجمهور ذي الاهتمامات المشتركة والجمهور في السوق - الاستبعادلاسلسلة أو قائمةنعم

قائمة بشرائح الجمهور ذي الاهتمامات المشتركة و/أو شرائح الجمهور في السوق التي سيتم استبعادها

يمكن استرداد أرقام تعريف قوائم المستخدِمين من واجهة "مساحة العرض والفيديو 360".

تنسيق القائمة = (رقم تعريف الجمهور؛ رقم تعريف الجمهور؛ إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

قائمة القوائم المخصّصة التي سيتم استهدافها

يستخدِم هذا العمود أرقام تعريف الموارد CustomList في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

تنسيق القائمة = (CustomList.customListId; CustomList.customListId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

قائمة اللغات المطلوب تضمينها في الاستهداف

يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_LANGUAGE.

تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

قائمة بالمناطق الجغرافية المطلوب تضمينها في الاستهداف.

يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_GEO_REGION.

تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

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

يستخدِم هذا العمود أرقام تعريف المورد TargetingOption في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_GEO_REGION.

تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

لا تتوفّر إلا لمجموعات إعلانية في "حملات زيادة الطلب". يجب ضبط مستوى الاستهداف الجغرافي واستهداف اللغة على مستوى المجموعة الإعلانية على مستوى عنصر الحملة.
استراتيجية مصدر المساحة الإعلانية في "حملات زيادة الطلب"نعم لمجموعات الإعلانات في "حملات زيادة الطلب"سلسلةنعماستراتيجية مصادر المساحات الإعلانية في "حملات زيادة الطلب"
  • كل المساحات الإعلانية على Google
  • كل المساحات الإعلانية المتاحة على Google و"الشبكة الإعلانية"
  • المستودعات المحدّدة
مصادر المساحات الإعلانية المفعّلة في "حملات زيادة الطلب"لاسلسلة أو قائمةنعممصادر المساحات الإعلانية المفعّلة في "حملات زيادة الطلب" يتم استخدام هذا الخيار عندما لا يتم ضبط استراتيجية مصدر المستودع الإعلاني.
  • الإعلانات القابلة للتخطي على YouTube
  • الإعلانات ضمن الخلاصة على YouTube
  • الإعلانات على YouTube Shorts
  • Gmail
  • اكتشاف
  • شبكة Google الإعلانية