اطّلِع على نظرة عامة للحصول على شرح للتنسيق.
| الحقل | مطلوب | النوع | قابل للكتابة | الوصف |
|---|---|---|---|---|
| معرِّف المنتج | لا | عدد صحيح | لا | قيمة المعرّف الرقمي لمنتج الوسائط |
| معرّف الخطة | لا | عدد صحيح | لا | القيمة الرقمية للمعرّف الخاص باقتراح الوسائط |
| رقم تعريف الحملة | لا | عدد صحيح | لا | |
| الاسم | نعم | سلسلة | نعم | اسم الإدخال |
| النوع | لا | سلسلة | لا | نوع منتج الوسائط
|
| Start Date | لا | سلسلة | لا | تاريخ بدء منتج الوسائط بالتنسيق MM/DD/YYYY HH:mm |
| تاريخ الانتهاء | لا | سلسلة | لا | تاريخ انتهاء منتج الوسائط بالتنسيق MM/DD/YYYY HH:mm |
| الميزانية | لا | عدد عائم | لا | مبلغ ميزانية موجب لمنتج الوسائط يكون دائمًا عددًا عشريًا لمبلغ العملة لأنّه سيكون دائمًا ميزانية نقدية. سيتم عرض العملات بعملة المعلِن وبوحدات عادية (وليس بجزء من مليون وحدة عملة) |
| تم تفعيل معدّل التكرار | نعم | سلسلة | نعم | |
| مرّات الظهور حسب معدّل التكرار | مطلوبة عندما تكون قيمة "عدد مرّات الظهور مفعّل" هي "صحيح" | عدد صحيح | نعم | عدد صحيح موجب لعدد مرّات الظهور في عدد مرّات ظهور معيّن، أي x في "عرض x مرّات ظهور خلال فترة y". |
| فترة عدد مرّات الظهور | مطلوبة عندما تكون قيمة "عدد مرّات الظهور مفعّل" هي "صحيح" | سلسلة | نعم |
|
| عدد مرّات الظهور | مطلوبة عندما تكون قيمة "عدد مرّات الظهور مفعّل" هي "صحيح" | عدد صحيح | نعم | |
| الاستهداف الجغرافي - تضمين | لا | سلسلة، قائمة | نعم | قائمة المواقع الجغرافية المطلوب تضمينها في الاستهداف يستخدم هذا العمود أرقام تعريف الموارد تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف اللغة - تضمين | لا | سلسلة، قائمة | نعم | قائمة اللغات المطلوب تضمينها في الاستهداف يستخدم هذا العمود أرقام تعريف الموارد تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف اللغة - استبعاد | لا | سلسلة، قائمة | نعم | قائمة اللغات المطلوب استبعادها في الاستهداف يستخدم هذا العمود أرقام تعريف الموارد تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف القنوات - تضمين | لا | سلسلة، قائمة | نعم | قائمة القنوات المطلوب تضمينها في الاستهداف يستخدم هذا العمود أرقام تعريف موارد واجهة برمجة التطبيقات تنسيق القائمة = (Channel.channelId; Channel.channelId; إلخ). |
| استهداف القنوات - الاستبعاد | لا | سلسلة، قائمة | نعم | قائمة القنوات المطلوب استبعادها في الاستهداف يستخدم هذا العمود أرقام تعريف موارد واجهة برمجة التطبيقات تنسيق القائمة = (Channel.channelId; Channel.channelId; إلخ). |
| استهداف الفئات - تضمين | لا | سلسلة، قائمة | نعم | قائمة بالفئات المطلوب تضمينها في الاستهداف يستخدم هذا العمود أرقام تعريف الموارد تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف الفئات - استبعاد | لا | سلسلة، قائمة | نعم | قائمة الفئات المطلوب استبعادها في الاستهداف يستخدم هذا العمود أرقام تعريف الموارد TargetingOption في Display & Video 360 API لنوع الاستهداف TARGETING_TYPE_CATEGORY. تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف الجمهور - تضمين | لا | سلسلة، قائمة بقائمة الأزواج | نعم | قائمة قوائم المستخدمين المطلوب تضمينها في الاستهداف يستخدم هذا العمود أرقام تعريف موارد واجهة برمجة التطبيقات بالنسبة إلى قوائم جمهور الطرف الأول، يتم إدراج كل شريحة جمهور كزوج من FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId وإعداد "الحداثة". الزوج هو (1؛1d؛)، حيث يشير 1d إلى عيّنة حديثة تمثّل حداثة يوم واحد. لا تتوفّر سمة "الحداثة" للجماهير التابعة لجهات خارجية، لذا يكون تنسيق القائمة على النحو التالي: (3;);(4;);. لاستخدام "و" و "أو" مع مجموعات شرائح الجمهور، اتّبِع هذا المثال: لدمج الأزواج مع أو بدون حداثة: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. وهذا يعني (القائمة 1 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال يوم واحد أو القائمة 2 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال 365 يومًا) و (القائمة 3 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال فترة غير محدّدة أو القائمة 4 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال 5 دقائق أو القائمة 5 التي تتضمّن بيانات جميع المستخدمين). في ما يلي القيم الصالحة لحداثة المحتوى:
|
| استهداف الجمهور - الاستبعاد | لا | سلسلة، قائمة بقائمة الأزواج | نعم | قائمة قوائم المستخدمين المطلوب استبعادها في الاستهداف يستخدم هذا العمود أرقام تعريف موارد واجهة برمجة التطبيقات يتم إدراج كل شريحة جمهور كزوج من FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId وإعداد الحداثة، إذا كانت قائمة الجمهور هي قائمة جمهور من الطرف الأول. يتمثل الزوج في (1؛1d؛)، حيث يشير 1d إلى عيّنة من معدّل تكرار الظهور خلال يوم واحد. ومع ذلك، لا تتوفّر ميزة "الحداثة" لشرائح جمهور الجهات الخارجية، لذا يكون تنسيق القائمة على النحو التالي: (3;);(4;);. تنسيق القائمة = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;);) في ما يلي القيم الصالحة لحداثة المحتوى:
|
| استهداف الجمهور ذي الاهتمامات المشتركة والجمهور في السوق - تضمين | لا | سلسلة، قائمة | نعم | |
| استهداف الجمهور ذو الاهتمامات المشتركة والجمهور في السوق - الاستبعاد | لا | سلسلة، قائمة | نعم | |
| استهداف الفئة الديمغرافية حسب الجنس | لا | سلسلة، قائمة | نعم | قائمة بالأجناس المراد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
|
| الفئة العمرية المستهدَفة | لا | سلسلة، قائمة | نعم | استهدِف فئة عمرية معيّنة من المستخدِمين. حدِّد نطاقًا من/إلى من خلال اختيار عمر واحد من وعمر واحد إلى وما إذا كان سيتم تضمين الأعمار غير المعروفة (صواب/خطأ). اطّلِع على قائمة القيم المقبولة للفئة العمرية من/إلى. المثال 1: لاستهداف المستخدمين الذين تتراوح أعمارهم بين 18 و55 عامًا وتضمين الفئات العمرية غير المعروفة، حدِّد التنسيق {من؛ إلى ؛ تضمين غير معروف صحيح/خطأ} = 18؛55؛صحيح. المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الفئات العمرية غير المعروفة، حدِّد ما يلي = 35؛+؛خطأ. القيم المقبولة للفئة العمرية من:
القيم المقبولة لسمة "إلى":
|
| استهداف الفئات الديمغرافية حسب الحالة الأبوية | نعم | سلسلة، قائمة | نعم | قائمة بالحالات الأبوية التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة.
|
| استهداف الأجهزة - تضمين | لا | سلسلة، قائمة | نعم | قائمة بالأجهزة المطلوب تضمينها في الاستهداف يستخدم هذا العمود أرقام تعريف موارد
تنسيق القائمة = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي. |
| استهداف حجم مشغّل الفيديو | لا | سلسلة، قائمة | نعم | قائمة بحجم مشغّل إعلان الفيديو المطلوب استهدافه اختَر قيمة واحدة أو أكثر من القيم المقبولة:
|
| خاص - اسم البائع | لا | سلسلة | لا | اسم الناشر في الصفقة لا ينطبق هذا الحقل إلا على منتجات الوسائط الخاصة. |
| خاص - معرّف الطلب | لا | سلسلة | لا | معرّف طلب صفقة مضمونة. لا ينطبق هذا الحقل إلا على منتجات الوسائط الخاصة. |
| خاص - رقم تعريف مصدر المساحة الإعلانية | لا | سلسلة | لا | رقم تعريف مصدر المستودع في DBM لا ينطبق هذا الحقل إلا على منتجات الوسائط الخاصة. |