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

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

الحقلمطلوبالنوعقابل للكتابةالوصف
معرِّف المجموعة الإعلانيةمطلوب فقط عند تعديل المجموعات الإعلانية الحاليةعدد صحيحلاقيمة المعرّف الرقمي للمجموعة الإعلانية. إذا تُرك هذا الحقل فارغًا، سيتم إنشاء معرّف جديد للمجموعة الإعلانية وسيتم تخصيص معرّف فريد. يمكنك اختياريًا استخدام معرّف مخصّص عند إنشاء مجموعات إعلانية جديدة بغرض تخصيص "إعلانات TrueView" للمجموعة الإعلانية الجديدة. تنسيق المعرّف المخصّص هو "ext[المعرّف المخصّص]"، مثلاً ext123. عند تحميل الملف ومعالجته، سيتم استبدال جميع المعرّفات المخصّصة بالمعرّفات التي خصّصتها "مساحة العرض والفيديو 360"، وسيتم ربط العناصر (مثلاً، الإعلان بالمجموعة الإعلانية) استنادًا إلى المعرّفات المخصّصة.
معرّف السلعةنعمعدد صحيحلاقيمة المعرّف الرقمي للبند الإعلاني الرئيسي. يمكنك تحديد معرّف مخصّص (مثلاً، "ext[معرّف البند الإعلاني المخصّص]") لبند إعلاني تنشئه في الوقت نفسه مع هذه المجموعة الإعلانية.
اسم البند الإعلانيلاسلسلةلااسم البند الإعلاني
الاسمنعمسلسلةنعماسم الإدخال.
الحالةنعمسلسلةنعمإعداد الحالة للإدخال.
  • نشطة
  • متوقف مؤقتًا
  • محذوفة
شكل إعلان الفيديونعمسلسلةنعمشكل إعلان الفيديو للمجموعة الإعلانية.
  • أثناء عرض الفيديو
  • إعلان فيديو ضمن الخلاصة
  • إعلان ملصق صغير
  • غير قابلة للتخطي
  • متجاوب
  • مدى الوصول الفعّال
  • الملف الصوتي على YouTube
تكلفة عرض السعرنعمfloatنعمالقيمة التي تمثّل الحد الأقصى لتكلفة عرض السعر المستهدَف للمجموعة الإعلانية استنادًا إلى نوع عرض السعر الذي تم ضبطه في عمود "نوع استراتيجية عروض أسعار 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 - التضمينلاسلسلة، قائمةنعم

قائمة بفيديوهات 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%
  • غير معروف
استهداف الفئة الديمغرافية حسب الحالة الأبويةنعمسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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