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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى قوائم مستخدِمي الطرف الأول، يتم إدراج كلّ شريحة جمهور كزوج من إعدادَي FirstAndrdParty Audience.firstAndPartyGroupId وإعداد مدى الحداثة. ويتم استخدام معاملين (1;1d)، حيث يشير 1d إلى حداثة العيّنة التي تمثّل حداثة يوم واحد. مدى الحداثة غير متاحة لشرائح الجمهور التابعة لجهات خارجية، لذا فإن تنسيق القائمة هو (3;);(4;);. في مجموعات الجماهير "و" و "أو"، اتبع هذا المثال: لدمج أزواج مع الحداثة وبدونها: '((1;1d;);(2;365d;);(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 يومًا
  • 120 يومًا
  • 180 يومًا
  • 270 يومًا
  • 365 يومًا
استهداف الجمهور - استبعادلاسلسلة، قائمة بالأزواجنعم

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

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

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

تنسيق القائمة = ((FirstAndFirstPartyGroup.firstAndPartyGroupId; recencyoptional;); (FirstAndParty AudienceId; recencyمخالفة; );)
مثال: "(1;1d;);(2;);".

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

  • الكل
  • دقيقة واحدة
  • ‫5 دقائق
  • ‫10 دقائق
  • 15 متر
  • 30 دقيقة
  • 1 س
  • ساعتان
  • 3 س
  • 6 ساعات
  • 12 ساعة
  • يوم
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • 10 أيام
  • 14 يومًا
  • 15 يومًا
  • 21 يومًا
  • 28 يومًا
  • 30 يومًا
  • 45 يومًا
  • 60 يومًا
  • 90 يومًا
  • 120 يومًا
  • 180 يومًا
  • 270 يومًا
  • 365 يومًا
الجمهور ذو الاهتمامات المشتركة والاستهداف في السوق - تضمينلاسلسلة، قائمةنعم
التقارب والاستهداف في السوق - استبعادلاسلسلة، قائمةنعم
الجنس المستهدف في الفئة الديمغرافيةلاسلسلة، قائمةنعمقائمة الأجناس المطلوب استهدافها. اختَر قيمة أو أكثر من القيم المقبولة:
  • أنثى
  • ذكر
  • غير معروف
العمر في استهداف الفئة الديمغرافيةلاسلسلة، قائمةنعماستهدف فئة عمرية للمستخدم. يمكنك تحديد نطاق من/إلى عن طريق اختيار عمر واحد من عمر وعمر واحد إلى وما إذا كان سيتم تضمين أعمار غير معروفة (صواب/خطأ). اطّلِع على قائمة الفئات العمرية المقبولة من/إلى.
المثال 1: لاستهداف الفئة العمرية من 18 إلى 55 عامًا وتضمين أعمار غير معروفة، حدِّد التنسيق التالي: {From; To ; includeUnknown 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

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

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