البيانات المنظَّمة - الإصدار 8 - منتج الوسائط

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

الحقلمطلوبالنوعقابل للكتابةالوصف
معرِّف المنتجلاعدد صحيحلاالقيمة الرقمية للمعرّف لمنتج الوسائط.
معرّف الخطةلاعدد صحيحلاالقيمة الرقمية لاقتراح الوسائط.
رقم تعريف الحملةلاعدد صحيحلا
الاسمنعمسلسلةنعماسم الإدخال
النوعلاسلسلةلانوع منتج الوسائط
  • شبكة مزاد مفتوح
  • إعلانات المزاد المفتوح
  • فيديو المزاد المفتوح
  • حملة مشاهدة فيديو
  • مدى الوصول الفعّال
  • إعلان قابل للتخطي أثناء عرض الفيديو على YouTube
  • إعلانات TrueView أثناء التصفّح على YouTube
  • إعلانات الملصقات الصغيرة على YouTube
  • مدى الوصول إلى الجمهور في إعلانات TrueView على YouTube
  • المحتوى الصوتي على YouTube
  • إعلان الملصقات الصغيرة القابل للتخطي حسب عدد مرّات الظهور المستهدَف
  • عدد مرّات الظهور المستهدَف غير القابلة للتخطّي
  • عدد مرّات الظهور المستهدَف القابلة للتخطّي
  • ملصق صغير لمرات الظهور المستهدفة
  • إعلانات الملصقات الصغيرة من Google Preferred
  • فيديو Shorts من Google Preferred
  • Google Preferred Long
  • إعلان غير قابل للتخطي أثناء عرض الفيديو مدته 30 ثانية في Google Preferred
  • حجز عادي
  • حجز عادي طويل
  • غير قابل للتخطي ضمن البث
  • خاص (الناشر)
  • خاص (مصدر المستودع)
  • خاص (تفاوض)
Start Dateلاسلسلةلاتاريخ بدء منتج الوسائط بالتنسيق MM/DD/YYYY HH:mm
تاريخ الانتهاءلاسلسلةلاتاريخ انتهاء منتج الوسائط بالتنسيق MM/DD/YYYY HH:mm
الميزانيةلاعدد عائملامبلغ ميزانية إيجابية لمنتج الوسائط. وهو دائمًا عدد عشري لمبلغ العملة حيث إنه سيكون دائمًا ميزانية نقدية. سيتم عرض العملات بعملة المعلِن وبوحدات عادية (وليس بجزء من مليون من وحدة العملة).
تم تفعيل الترددنعمسلسلةنعم
عدد مرّات الظهورمطلوب عند تفعيل "التكرار" هو "TRUE"عدد صحيحنعمعدد صحيح موجب لعدد مرات الظهور في مبلغ معيّن لمعدل التكرار، أي س في "إظهار س عدد مرات الظهور على مدار فترة ص".
فترة التكرارمطلوب عند تفعيل "التكرار" هو "TRUE"سلسلةنعم
  • الدقائق
  • ساعات
  • الأيام
  • أسابيع
  • الأشهر
  • الفترة منذ الإنشاء
مقدار التكرارمطلوب عند تفعيل "التكرار" هو "TRUE"عدد صحيحنعم
الاستهداف الجغرافي - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

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

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

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

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

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API Channel

تنسيق القائمة = (Channel.channelId; Channel.channelId; etc.).

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

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API Channel

تنسيق القائمة = (Channel.channelId; Channel.channelId; إلخ).

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

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

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

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

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

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

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API FirstAndThirdPartyAudience

بالنسبة إلى قوائم مستخدمي الطرف الأول، يتم إدراج كل شريحة جمهور كزوج من إعدادات FirstAndPartyAudiences.firstAndThirdParty AudienceId وإعداد مدى الحداثة. الزوج هو (1;1d؛)، حيث يشير 1d إلى مدى حداثة النموذج ويمثل حداثة يوم واحد. لا تتوفّر ميزة "الحداثة" لشرائح الجمهور من الجهات الخارجية، وبالتالي يكون تنسيق القائمة هو (3؛)؛(4؛). إلى "و" و"OR" يُرجى اتباع المثال التالي: لدمج أزواج من القيم حسب مدى الحداثة: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;)); يعني ذلك (القائمة 1 مع مدى الحداثة لمدة يوم واحد أو القائمة 2 مع مدى الحداثة لمدة 365 يومًا) و (القائمة 3 بدون مدى حداثة محدَّد أو القائمة 4 مع مدى حداثة مدة كل 5 دقائق أو القائمة 5 مع جميع المستخدمين).

قيم الحداثة الصالحة هي:

  • الكل
  • دقيقة واحدة
  • ‫5 دقائق
  • ‫10 دقائق
  • 15 متر
  • 30 دقيقة
  • 1 س
  • ساعتان
  • 3 س
  • 6 ساعات
  • 12 ساعة
  • يوم واحد
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • 10 أيام
  • 14 يومًا
  • 15 يومًا
  • 21 يومًا
  • 28 يومًا
  • 30 يومًا
  • 45 يومًا
  • 60 يومًا
  • 90 يومًا
  • 120d
  • 180 يومًا
  • 270 يومًا
  • 365 يومًا
استهداف الجمهور - استبعادلاسلسلة، قائمة الأزواجنعم

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API FirstAndThirdPartyAudience

يتم إدراج كل شريحة جمهور كزوج من FirstAndThirdPartyAudiences.firstAndThirdPartyCustomerId وإعداد مدى الحداثة، إذا كانت قائمة المستخدمين هي قائمة مستخدمين للطرف الأول. الزوج هو (1؛1d؛)، حيث يشير 1d إلى عيّنة من معدّل تكرار الظهور التي تمثّل معدّل تكرار الظهور خلال يوم واحد. ومع ذلك، بالنسبة إلى شرائح الجمهور التابعة لطرف ثالث، لا تتوفّر مدى الحداثة، وبالتالي يكون تنسيق القائمة هو (3؛)؛(4؛).

تنسيق القائمة = ((FirstAndThirdParty Audience.firstAndThirdPartyResourceId; recency متخصّص;)؛ (FirstAndThirdPartyAudiences.firstAndPartyPartyId; recency متخصّص;);)
مثال: "(1;1d;);(2;)

قيم الحداثة الصالحة هي:

  • الكل
  • دقيقة واحدة
  • ‫5 دقائق
  • ‫10 دقائق
  • 15 متر
  • 30 دقيقة
  • 1 س
  • ساعتان
  • 3 س
  • 6 ساعات
  • 12 ساعة
  • يوم واحد
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • 10 أيام
  • 14 يومًا
  • 15 يومًا
  • 21 يومًا
  • 28 يومًا
  • 30 يومًا
  • 45 يومًا
  • 60 يومًا
  • 90 يومًا
  • 120d
  • 180 يومًا
  • 270 يومًا
  • 365 يومًا
الاهتمامات المشتركة استهداف السوق - تضمينلاسلسلة، قائمةنعم
الاهتمامات المشتركة استهداف السوق - استبعادلاسلسلة، قائمةنعم
استهداف الفئات الديمغرافية حسب الجنسلاسلسلة، قائمةنعمقائمة الأجناس المطلوب استهدافها. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • أنثى
  • ذكر
  • غير معروف
العمر عند استهداف الفئة الديمغرافيةلاسلسلة، قائمةنعماستهدِف فئة عمرية معيّنة من المستخدِمين. حدِّد نطاقًا من/إلى من خلال اختيار عمر واحد من وعمر واحد إلى وما إذا كان سيتم تضمين الأعمار غير المعروفة (صواب/خطأ). اطّلِع على قائمة الفئات العمرية المقبولة من/إلى.
المثال 1: لاستهداف الفئة العمرية من 18 إلى 55 عامًا مع تضمين أعمار غير معروفة، حدِّد التنسيق {From; إلى ؛ تضمين True/False غير معروف} = 18;55;true;
المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الأعمار غير المعروفة، حدِّد ما يلي = 35;+;false;.
القيم المقبولة للحقل "من":
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

القيم المقبولة للحقل "إلى":
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
الحالة الأبوية لاستهداف الفئة الديمغرافيةنعمسلسلة، قائمةنعمقائمة بالحالات الأبوية التي تريد استهدافها حدد قيمة واحدة أو أكثر من القيم المقبولة.
  • أحد الوالدين
  • ليس أحد الوالدين
  • غير معروف
استهداف الأجهزة - تضمينلاسلسلة، قائمةنعم

قائمة الأجهزة التي سيتم تضمينها في الاستهداف.

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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