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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى قوائم جمهور الطرف الأول، يتم إدراج كل جمهور كزوج من FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId وإعداد مدى الحداثة. الزوج هو (1;1d;‎)، حيث يمثّل 1d مدى الحداثة لعيّنة تبلغ يومًا واحدًا. لا تتوفّر بيانات مدى الحداثة لشرائح الجمهور التابعة لجهات خارجية، لذا يكون تنسيق القائمة هو (3;);(4;);. لدمج مجموعات من شرائح الجمهور باستخدام "AND" و "OR"، اتّبِع المثال التالي: لدمج أزواج مع مدى الحداثة وبدونه: '((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 ساعة
  • يوم واحد
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • ‫10 أيام
  • 14 يومًا
  • ‫15 يومًا
  • ‫21 يومًا
  • 28 يومًا
  • 30 يومًا
  • 45 يومًا
  • ‫60 يومًا
  • 90 يومًا
  • ‫120d
  • ‫180 يومًا
  • ‫270 يومًا
  • 365 يومًا
استهداف الجمهور - الاستبعادلاسلسلة، قائمة بقوائم أزواجنعم

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

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

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

تنسيق القائمة = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)
مثال: "(1;1d;);(2;);".

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

  • الكل
  • 1 د
  • ‫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 عامًا وتضمين الأعمار غير المعروفة، حدِّد التنسيق {من؛ إلى؛ تضمين الأعمار غير المعروفة صحيح/خطأ} = 18؛55؛صحيح؛
المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الأعمار غير المعروفة، حدِّد ما يلي = 35؛+؛خطأ؛.
القيم المقبولة في الحقل "من":
  • 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; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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