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

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

الحقلمطلوبالنوعقابل للكتابةالوصف
معرِّف المجموعة الإعلانيةمطلوب فقط عند تعديل المجموعات الإعلانية الحاليةعدد صحيحلاقيمة رقم التعريف العددي للمجموعة الإعلانية. إذا تُرك هذا الحقل فارغًا، سيتم إنشاء معرّف جديد لمجموعة الإعلانات وسيتم تعيين معرّف فريد. اختياريًا، عند إنشاء مجموعات إعلانية جديدة، يمكنك استخدام معرّف مخصّص بغرض تعيين "إعلانات 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; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.