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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى قوائم جمهور الطرف الأول، يتم إدراج كل جمهور كزوج من FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId وإعدادات مدى الحداثة. الزوج هو (1‏؛ 1d‏؛)، حيث إنّ 1d هو نموذج لمدى الحداثة يمثّل مدى حداثة ليوم واحد. لا يتوفّر مدى الحداثة لجمهور الطرف الثالث، لذا يكون تنسيق القائمة (3‏؛)‏؛(4‏؛)‏؛. لدمج مجموعات الجمهور باستخدام "و" و"أو"، اتّبِع هذا المثال: لدمج الأزواج التي تتضمّن مدى الحداثة وتلك التي لا تتضمّنه: '((1‏؛1d‏؛)‏؛(2‏؛365d‏؛)‏؛)((3‏؛)‏؛(4‏؛5m‏؛)‏؛(5‏؛all‏؛)‏؛'. يعني ذلك (القائمة 1 مع مدى حداثة ليوم واحد أو القائمة 2 مع مدى حداثة لـ 365 يومًا) و (القائمة 3 بدون مدى حداثة محدّد أو القائمة 4 مع مدى حداثة لـ 5 دقائق أو القائمة 5 مع جميع المستخدمين).

في ما يلي قيم مدى الحداثة الصالحة:

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

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

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

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

تنسيق القائمة = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId‏؛ مدى الحداثة اختياري‏؛)‏؛ (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId‏؛ مدى الحداثة اختياري‏؛)‏؛)
مثال: "(1‏؛1d‏؛)‏؛(2‏؛)‏؛".

في ما يلي قيم مدى الحداثة الصالحة:

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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