راجِع النظرة العامة للحصول على شرح حول التنسيق.
| الحقل | مطلوب | النوع | قابل للكتابة | الوصف |
|---|---|---|---|---|
| معرِّف المنتج | لا | عدد صحيح | لا | القيمة الرقمية لمعرّف المنتج الإعلامي |
| معرّف الخطة | لا | عدد صحيح | لا | القيمة الرقمية لمعرّف العرض الإعلامي |
| رقم تعريف الحملة | لا | عدد صحيح | لا | |
| الاسم | نعم | سلسلة | نعم | اسم الإدخال |
| النوع | لا | سلسلة | لا | نوع المنتج الإعلامي
|
| تاريخ البدء | لا | سلسلة | لا | تاريخ بدء المنتج الإعلامي بالتنسيق 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.targetingOptionId؛ TargetingOption.targetingOptionId؛ إلخ) يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف اللغة - التضمين | لا | سلسلة، قائمة | نعم | قائمة باللغات المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API تنسيق القائمة = (TargetingOption.targetingOptionId؛ TargetingOption.targetingOptionId؛ إلخ) يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف اللغة - الاستبعاد | لا | سلسلة، قائمة | نعم | قائمة باللغات المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API تنسيق القائمة = (TargetingOption.targetingOptionId؛ TargetingOption.targetingOptionId؛ إلخ) يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف القنوات - التضمين | لا | سلسلة، قائمة | نعم | قائمة بالقنوات المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API تنسيق القائمة = (Channel.channelId؛ Channel.channelId؛ إلخ) |
| استهداف القنوات - الاستبعاد | لا | سلسلة، قائمة | نعم | قائمة بالقنوات المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API تنسيق القائمة = (Channel.channelId؛ Channel.channelId؛ إلخ) |
| استهداف الفئات - التضمين | لا | سلسلة، قائمة | نعم | قائمة بالفئات المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API تنسيق القائمة = (TargetingOption.targetingOptionId؛ TargetingOption.targetingOptionId؛ إلخ) يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف الفئات - الاستبعاد | لا | سلسلة، قائمة | نعم | قائمة بالفئات المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API TargetingOption لنوع الاستهداف TARGETING_TYPE_CATEGORY. تنسيق القائمة = (TargetingOption.targetingOptionId؛ TargetingOption.targetingOptionId؛ إلخ) يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف الجمهور - التضمين | لا | سلسلة، قائمة بقوائم الأزواج | نعم | قائمة بقوائم الجمهور المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API بالنسبة إلى قوائم جمهور الطرف الأول، يتم إدراج كل جمهور كزوج من FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId وإعدادات مدى الحداثة. الزوج هو (1؛ 1d؛)، حيث إنّ 1d هو نموذج لمدى الحداثة يمثّل مدى حداثة ليوم واحد. لا يتوفّر مدى الحداثة لجمهور الطرف الثالث، لذا يكون تنسيق القائمة (3؛)؛(4؛)؛. لدمج مجموعات الجمهور باستخدام "و" و"أو"، اتّبِع هذا المثال: لدمج الأزواج التي تتضمّن مدى الحداثة وتلك التي لا تتضمّنه: '((1؛1d؛)؛(2؛365d؛)؛)((3؛)؛(4؛5m؛)؛(5؛all؛)؛'. يعني ذلك (القائمة 1 مع مدى حداثة ليوم واحد أو القائمة 2 مع مدى حداثة لـ 365 يومًا) و (القائمة 3 بدون مدى حداثة محدّد أو القائمة 4 مع مدى حداثة لـ 5 دقائق أو القائمة 5 مع جميع المستخدمين). في ما يلي قيم مدى الحداثة الصالحة:
|
| استهداف الجمهور - الاستبعاد | لا | سلسلة، قائمة بقوائم الأزواج | نعم | قائمة بقوائم الجمهور المطلوب استبعادها من الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API يتم إدراج كل قائمة مستخدمين كزوج من FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId وإعدادات مدى الحداثة، إذا كانت قائمة المستخدمين هي قائمة مستخدمين الطرف الأول. الزوج هو (1؛ 1d؛)، حيث إنّ 1d هو نموذج لمدى الحداثة يمثّل مدى حداثة ليوم واحد. ومع ذلك، لا يتوفّر مدى الحداثة لجمهور الطرف الثالث، لذا يكون تنسيق القائمة (3؛)؛(4؛)؛. تنسيق القائمة = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId؛ مدى الحداثة اختياري؛)؛ (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId؛ مدى الحداثة اختياري؛)؛) في ما يلي قيم مدى الحداثة الصالحة:
|
| استهداف الجمهور ذي الاهتمامات المشتركة والجمهور في السوق - التضمين | لا | سلسلة، قائمة | نعم | |
| استهداف الجمهور ذي الاهتمامات المشتركة والجمهور في السوق - الاستبعاد | لا | سلسلة، قائمة | نعم | |
| استهداف الفئة الديمغرافية حسب الجنس | لا | سلسلة، قائمة | نعم | قائمة بالأجناس المطلوب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
|
| استهداف الفئة الديمغرافية حسب العمر | لا | سلسلة، قائمة | نعم | استهداف فئة عمرية للمستخدم حدِّد نطاقًا من/إلى من خلال اختيار عمر "من" واحد وعمر "إلى" واحد وما إذا كنت تريد تضمين الأعمار غير المعروفة (صحيح/خطأ). راجِع قائمة الأعمار المقبولة "من"/"إلى". مثال 1: لاستهداف الفئة العمرية 18-55 وتضمين الأعمار غير المعروفة، حدِّد التنسيق {From؛ To؛ Include unknown True/False} = 18؛55؛true؛ مثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الأعمار غير المعروفة، حدِّد ما يلي = 35؛+؛false؛. القيم المقبولة لـ "من":
القيم المقبولة لـ "إلى":
|
| استهداف الفئة الديمغرافية حسب الحالة الأبوية | نعم | سلسلة، قائمة | نعم | قائمة بالحالات الأبوية المطلوب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة.
|
| استهداف الأجهزة - التضمين | لا | سلسلة، قائمة | نعم | قائمة بالأجهزة المطلوب تضمينها في الاستهداف يستخدِم هذا العمود أرقام تعريف موارد Display & Video 360 API
تنسيق القائمة = (TargetingOption.targetingOptionId؛ TargetingOption.targetingOptionId؛ إلخ) يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف حجم مشغّل الفيديو | لا | سلسلة، قائمة | نعم | قائمة بأحجام مشغّل إعلانات الفيديو المطلوب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
|
| خاص - اسم البائع | لا | سلسلة | لا | اسم الناشر في صفقة لا ينطبق هذا الحقل إلا على المنتجات الإعلامية الخاصة. |
| خاص - رقم تعريف الطلب | لا | سلسلة | لا | رقم تعريف طلب صفقة مضمونة لا ينطبق هذا الحقل إلا على المنتجات الإعلامية الخاصة. |
| خاص - رقم تعريف مصدر المساحات الإعلانية | لا | سلسلة | لا | رقم تعريف مصدر المساحات الإعلانية في DBM لا ينطبق هذا الحقل إلا على المنتجات الإعلامية الخاصة. |