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

يمكنك الاطّلاع على النظرة العامة للحصول على شرح حول التنسيق.

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

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

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

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

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

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

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

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

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

قائمة بالفئات المطلوب تضمينها في الاستهداف. يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ TargetingOption لنوع الاستهداف TARGETING_TYPE_CATEGORY.

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

استهداف الفئات - استبعادلاسلسلة، قائمةنعمقائمة بالفئات المطلوب استبعادها من الاستهداف. يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ TargetingOption لنوع الاستهداف TARGETING_TYPE_CATEGORY.

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

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

قائمة بقنوات YouTube المطلوب تضمينها.

تنسيق القائمة = (معرّف قناة YouTube‏؛ معرّف قناة YouTube‏؛ إلخ).

استهداف مواضع الإعلان - قنوات YouTube - استبعادلاسلسلة، قائمةنعم

قائمة بقنوات YouTube المطلوب استبعادها.

تنسيق القائمة = (معرّف قناة YouTube‏؛ معرّف قناة YouTube‏؛ إلخ).

استهداف مواضع الإعلان - فيديوهات 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.

تنسيق القائمة = (someurl.com‏؛ someurltwo.com‏؛ إلخ).

استهداف مواضع الإعلان - عناوين URL - استبعادلاسلسلة، قائمةنعم

قائمة بعناوين URL المطلوب استبعادها من الاستهداف. تتألّف القائمة من سلاسل عناوين URL.

تنسيق القائمة = (someurl.com‏؛ someurltwo.com‏؛ إلخ).

استهداف مواضع الإعلان - التطبيقات - تضمينلاسلسلة، قائمةنعم

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

تقدّم المنصة ذات الصلة رقم التعريف، مثل معرّف حزمة من "متجر Play" على Android (مثلاً: com.google.android.gm) أو معرّف تطبيق من App Store على Apple (مثلاً: 422689480).

تنسيق القائمة = (com.google.android.gm‏؛ 422689480‏؛ إلخ).

استهداف مواضع الإعلان - التطبيقات - استبعادلاسلسلة، قائمةنعم

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

تقدّم المنصة ذات الصلة رقم التعريف، مثل معرّف حزمة من "متجر Play" على Android (مثلاً: com.google.android.gm) أو معرّف تطبيق من App Store على Apple (مثلاً: 422689480).

تنسيق القائمة = (com.google.android.gm‏؛ 422689480‏؛ إلخ).

استهداف مواضع الإعلان - مجموعات التطبيقات - تضمينلاسلسلة، قائمةنعمقائمة بـ مجموعات التطبيقات المطلوب تضمينها في الاستهداف. تنسيق القائمة= معرّف مجموعة التطبيقات‏؛ معرّف مجموعة التطبيقات‏؛
استهداف مواضع الإعلان - مجموعات التطبيقات - استبعادلاسلسلة، قائمةنعمقائمة بمجموعات التطبيقات المطلوب استبعادها من الاستهداف. تنسيق القائمة= معرّف مجموعة التطبيقات‏؛ معرّف مجموعة التطبيقات‏؛
استهداف الفئة الديمغرافية حسب الجنسنعمسلسلة، قائمةنعمقائمة بالأجناس المطلوب استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • أنثى
  • ذكر
  • غير معروف
استهداف الفئة الديمغرافية حسب العمرنعمسلسلة، قائمةنعم

قائمة بالأعمار المطلوب استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة.

  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
  • غير معروف
استهداف الفئة الديمغرافية حسب دخل الأسرةنعمسلسلة، قائمةنعم

قائمة بدخول الأسر المطلوب استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة.

  • أعلى 10%
  • 11 -‏ 20‏%
  • 21‏ - 30‏%
  • 31‏ - 40‏%
  • 41 - 50‏%
  • أدنى 50%
  • غير معروف
استهداف الفئة الديمغرافية حسب الحالة الأبويةنعمسلسلة، قائمةنعم

قائمة بالحالات الأبوية المطلوب استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة.

  • أحد الوالدين
  • ليس أحد الوالدين
  • غير معروف
الاستهداف المحسّنلاسلسلةنعمتفعيل ميزة "الاستهداف المحسّن".
  • صواب
  • خطأ

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

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

مستوى توسيع نطاق الجمهورلاعدد صحيحنعممستوى توسيع نطاق الجمهور. لا يمكن ضبطه إلا على المجموعات الإعلانية التي تتضمّن القيم 0 و1 و2 و3.
تم استبعاد قائمة المحتوى الأساسي لميزة "توسيع نطاق الجمهور"لاسلسلةنعمتفعيل ميزة "تم استبعاد قائمة العملاء الأساسية لميزة "توسيع نطاق الجمهور"".
  • صواب
  • خطأ
استهداف الجمهور - تضمينلاسلسلة، قائمةنعم

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

يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ FirstPartyAndPartnerAudience.

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

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

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

يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ FirstPartyAndPartnerAudience.

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

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

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

تنسيق القائمة = (معرّف الجمهور المشابه‏؛ معرّف الجمهور المشابه‏؛ إلخ)

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

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

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

تنسيق القائمة = (معرّف الجمهور المشابه‏؛ معرّف الجمهور المشابه‏؛ إلخ)

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

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

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

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

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

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

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

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

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

استهداف القوائم المخصّصةلاسلسلة، قائمةنعم

قائمة بالقوائم المخصّصة المطلوب استهدافها.

يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ CustomList.

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

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

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

يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ TargetingOption لنوع الاستهداف TARGETING_TYPE_LANGUAGE.

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

لا تتوفّر هذه الميزة إلا في حال استيفاء الشروط التالية:

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

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

يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ TargetingOption لنوع الاستهداف TARGETING_TYPE_GEO_REGION.

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

لا تتوفّر هذه الميزة إلا في حال استيفاء الشروط التالية:

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

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

يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API‏ TargetingOption لنوع الاستهداف TARGETING_TYPE_GEO_REGION.

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

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