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

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

الحقلمطلوبةالنوعقابل للكتابةالوصف
معرّف Ioمطلوبة فقط عند تعديل طلبات إدراج حاليةعدد صحيحلاالقيمة الرقمية لطلب الإدراج في حال ترك هذا الحقل فارغًا، سيتم إنشاء معرّف طلب إدراج جديد وتعيين معرّف فريد. عند إنشاء "طلب إدراج" جديد، يمكنك استخدام معرّف مخصّص بغرض تعيين العناصر لطلب الإدراج الجديد. تنسيق المعرّف المخصّص هو "ext[معرّف مخصّص]"، مثل ext123. عند تحميل الملف ومعالجته، سيتم استبدال جميع المعرّفات المخصّصة بأرقام التعريف المخصّصة لبرنامج DBM، وسيتم ربط العناصر (على سبيل المثال، العناصر في طلب الإدراج) استنادًا إلى المعرّفات المخصّصة.
رقم تعريف الحملةلاعدد صحيحلاالقيمة الرقمية لرقم التعريف للحملة ويمكنك تحديد معرّف مخصّص (مثل "ext[معرّف حملة مخصّص]") لحملة تُنشئها في الوقت نفسه مع طلب الإدراج هذا.
الاسمنعمسلسلةنعمتمثّل هذه السمة اسم الإدخال.
الطابع الزمنيمطلوب عند تعديل الإدخالات الحاليةعدد صحيحلاالطابع الزمني للإدخال، ويستخدمه النظام للتحقّق من أنّ الإدخال لم يتغير بين التنزيل والتحميل.
الحالةنعمسلسلةنعمإعداد حالة الإدخال
  • نشِط
  • متوقف مؤقتًا
  • مسودة
  • محتوى من الأرشيف
نوع Ioنعمسلسلةنعمنوع طلب الإدراج قابل للإعداد عند الإنشاء فقط.
  • القيمة العادية
النوع الفرعي Ioنعمسلسلةنعميجب ملء هذا الحقل لكي تتمكّن طلبات الإدراج من التمييز بين التنسيقات المختلفة. إذا تُرك الحقل فارغًا، فسيتم استخدام قيمة 'default''
  • تلقائي
  • عرض عادي على الجزء العلوي
هدف Ioلاسلسلةنعمالهدف من "طلب الإدراج":

هذا الحقل في مرحلة تجريبية وهو متاح حاليًا للعملاء المشاركين فقط. وسيكون هذا العمود فارغًا دائمًا للعملاء غير المشاركين في الإصدار التجريبي.
  • الوعي بالعلامة التجارية
  • (يُرجى النقر.)
  • الإحالة الناجحة
  • قرض مخصص
  • ما مِن هدف
الرسوملاسلسلة، قائمة من القوائمنعمجميع رسوم هذه الدخول تنسيق القائمة = (فئة الرسوم؛ مبلغ الرسوم؛ نوع الرسوم؛ تم إصدار فاتورة).
  • فئة الرسوم
    • التكلفة لكل ألف ظهور (CPM)
    • الوسائط
  • مبلغ الرسوم
    • عدد عائم
    • Pct كقيمة عائمة
  • نوع الرسوم
    • (سلسلة، الاطّلاع على الجدول في الرسوم)
  • تم إرسال الفاتورة
    • صحيح
    • خطأ
    • فارغ

مثال: "(التكلفة لكل ألف ظهور؛ 2؛ رسوم مساحة العرض والفيديو 360؛ خطأ)؛ (الوسائط؛ 13؛ تلقائي؛ صحيح)؛
تتوفّر القيم المقبولة في الجدول التالي:

فئة الرسومنوع الرسمخيار مع الفواتير
التكلفة لكل ألف ظهور/وسائطتلقائيغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطخادم إعلانات خارجيغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطDoubleVerifyمسموح به (صواب/خطأ)
التكلفة لكل ألف ظهور/وسائطAdsafeغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطAdxposeغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطVizuغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطإجمالي المعرفةغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطTeracentغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطEvidonغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطرسوم مكتب التداول للوكالةغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور/وسائطAdlooxمسموح به (صواب/خطأ)
التكلفة لكل ألف ظهور (CPM)ShopLocalمطلوب (صواب)
التكلفة لكل ألف ظهور (CPM)TrustMetricsغير مسموح به (اترك الحقل فارغًا)
التكلفة لكل ألف ظهور (CPM)فيديو من Integral Ad Scienceمسموح به (صواب/خطأ)
التكلفة لكل ألف ظهور (CPM)MOAT Videoغير مسموح به (اترك الحقل فارغًا)
الوسائطرسوم "مساحة العرض والفيديو 360"مطلوب (صواب)
الوسائطبيانات تكلفة جميع الوسائلغير مسموح به (اترك الحقل فارغًا)
الوسائطرسوم Scibidsمطلوب (صواب)
رمز الدمجلاسلسلةنعمرمز اختياري لأغراض التتبع.
التفاصيللاسلسلةنعمتفاصيل الإدخال بتنسيق سلسلة
مستوى التقدمنعمسلسلةنعمالفترة الزمنية المستخدمة للإنفاق حتى مبلغ مستوى السرعة.
  • يوميًا
  • شهريًا
  • مدّة عرض الإعلانات
معدّل السرعةنعمسلسلةنعممعدل السرعة لهذا الإدخال.
  • في أقرب وقت ممكن
  • بالتساوي
  • قبالة
مقدار الخطواتنعمfloatنعمالمبلغ المطلوب إنفاقه لكل فترة زمنية يحددها نوع مستوى السرعة.
تم تفعيل التكرارنعمسلسلةنعميفعِّل/يوقف تحديد عدد مرات الظهور المستند إلى مرات الظهور في طلب الإدراج.
  • TRUE
  • FALSE
عدد مرّات الظهورمطلوب عندما تكون قيمة "تفعيل التكرار" هي "صحيح"عدد صحيحنعمعدد صحيح موجب لعدد مرات الظهور في مبلغ معيّن لمعدل التكرار، أي س في "إظهار س عدد مرات الظهور على مدار فترة ص".
فترة التكرارمطلوب عندما تكون قيمة "تفعيل التكرار" هي "صحيح"سلسلةنعمتحدد وحدة الفترة الزمنية لتحديد عدد مرات الظهور.
  • الدقائق
  • ساعات العمل
  • الأيام
  • أسابيع
  • الأشهر
  • الفترة منذ الإنشاء
مقدار التكرارمطلوب عندما تكون قيمة "تفعيل التكرار" هي "صحيح"عدد صحيحنعمعدد صحيح موجب لطول الفترة الزمنية لنوع "فترة التكرار"، أي y في "إظهار س عدد مرات الظهور على مدار ص".
نوع مؤشر الأداء الرئيسينعمسلسلةنعموحدة مؤشر الأداء الرئيسي لطلب الإدراج
  • التكلفة لكل ألف ظهور (CPM)
  • تكلفة الإجراء
  • تكلفة النقرة
  • تكلفة المشاهدة
  • تكلفة مرة الظهور المسموعة والقابلة للعرض عند الاكتمال
  • نسبة النقر إلى الظهور
  • النسبة المئوية لإمكانية العرض
  • تكلفة المشاركة (CPE)
  • معدل الإحالات الناجحة لكل نقرة
  • معدل الإحالات الناجحة لكل مرة ظهور
  • VCPM
  • نسبة المشاهدات المكتملة
  • معدل الاستماع إلى الملف الصوتي بالكامل
  • معدّل مشاهدة الفيديو بالكامل
  • تكلفة الاستماع المكتمل
  • تكلفة المشاهدة المكتملة
  • TOS10
  • زيادة السرعة إلى أقصى حد
  • تكلفة/قيمة مرات الظهور المخصصة
  • لا ينطبق
  • غير ذلك
قيمة مؤشر الأداء الرئيسينعمسلسلةنعمقيمة مؤشر الأداء الرئيسي بالعملة (التكلفة لكل ألف ظهور، وتكلفة الإجراء، وتكلفة النقرة، وتكلفة المشاهدة، والتكلفة لكل ألف ظهور قابل للعرض، وتكلفة المشاركة، والتكلفة لكل ألف ظهور قابل للعرض) وإذا كان نوع مؤشر الأداء الرئيسي المقدَّم هو "زيادة وتيرة السرعة إلى أقصى حد" أو "بدون"، سيتم تجاهل هذا العمود.
معرّف خوارزمية Kpiمطلوبة عندما يكون "نوع مؤشر الأداء الرئيسي" هو "قيمة ظهور الإعلان المخصّصة / التكلفة"عدد صحيحنعمرقم تعريف خوارزمية عروض الأسعار المخصّصة المرتبط بمؤشر الأداء الرئيسي إذا كان نوع مؤشر الأداء الرئيسي CUSTOM_BIDDING_VALUE_COST. وبخلاف ذلك، يتم تجاهل هذا العمود.
قياس معدّل DARنعمسلسلةنعمتفعيل/إيقاف قياس الجمهور باستخدام تقييمات الإعلانات الرقمية من Nielsen
  • TRUE
  • FALSE
قياس قناة DARمطلوبة عندما تكون قيمة "قياس DAR" هي "صحيح"عدد صحيحنعم

القناة التي يتم قياسها باستخدام "تقييمات الإعلانات الرقمية من Nielsen".

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

التنسيق = Channel.channelId

نوع الميزانيةنعمسلسلةنعمتحدد نوع الميزانية من حيث مبلغ "الإيرادات" المطلوب إنفاقه (المبلغ) أو عدد مرات الظهور (مرات الظهور) المطلوب شراؤها.
  • المبلغ
  • مرات الظهور
شرائح الميزانيةنعمسلسلة، قائمة من القوائمنعمتُحدِّد شرائح الميزانية المحدّدة. تنسيق القائمة = (الميزانية، وتاريخ البدء، وتاريخ الانتهاء، ورقم تعريف ميزانية الحملة، والوصف). الميزانية بتنسيق عائم للعملات تكون التواريخ بالتنسيق MM/DD/YYYY. يكون رقم تعريف ميزانية الحملة فارغًا إذا لم يتم تحديده. لا يمكن أن يكون الوصف فارغًا لأي شرائح من شرائح الميزانية. إذا كان أحد شرائح الميزانية الحالية يحتوي على وصف فارغ، يجب تقديم وصف للصف المطلوب تحميله. مثال: "(100.50;01/01/2016;03/31/2016;12345;Budget شريحة 1;);(200.00;04/01/2016;06/30/2016;;updatedBudget شريحة 1;);"
توزيع الميزانية تلقائيًانعمسلسلةنعمتفعيل/إيقاف التخصيص التلقائي للميزانية
  • TRUE
  • FALSE
الاستهداف الجغرافي - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

الاستهداف القريبلاسلسلة، قائمة من القوائمنعمقائمة الاستهدافات القريبة بالتنسيق "(خط العرض؛ خط الطول؛ نصف القطر؛ الوحدة؛ العنوان الكامل؛)؛". يتراوح خط العرض بين -90 و90 درجة (شامل)، وخط الطول بين -180 و180 درجة (ضمنًا)، ونطاق النطاق هو مسافة بين 1 و500 (شامل) في الوحدة. ويمكن أن تكون الوحدة "ميل" أو "كم"، كما أن عنوان FullAddress اختياري. على سبيل المثال: "(38.907192؛ -77.03687؛ 1.0؛ ميل؛ واشنطن العاصمة، واشنطن العاصمة، الولايات المتّحدة (40.712775؛ -74.005972؛ 20.5؛ كم؛ 40.712775، -74.005972؛)؛ (20.000234؛ -56.675423؛ 5.0؛ ميل؛ ؛).
استهداف قائمة المواقع الجغرافية القريبةلاسلسلة، قائمة من القوائمنعمقائمة الأهداف القريبة لطلبات الإدراج أو البنود بخلاف TrueView، وتكون كل منها بالتنسيق "(ProximityListId; Radius; Unit; );". ProximityListId هو رقم تعريف قائمة مواقع ضمن موارد المعلِن. النطاق الجغرافي هو مسافة تتراوح بين 1 و500 (شامل) في الوحدة، ويمكن أن تكون قيمة الوحدة "ميل" أو "كلم". وهناك حد أقصى لاستهداف قائمتين من المواقع الجغرافية لكل كيان إلى جانب قوائم المواقع الجغرافية الإقليمية. على سبيل المثال: "(10041691678; 20.0; mi;); (10038858567; 20.5; km;);".
استهداف اللغة - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

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

يستخدِم هذا العمود أرقام تعريف موارد TargetingOption API في "مساحة العرض والفيديو 360" لأنواع الاستهداف التالية:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

يستخدِم هذا العمود أرقام تعريف موارد TargetingOption API في "مساحة العرض والفيديو 360" لأنواع الاستهداف التالية:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

قائمة المتصفّحات التي يمكن تضمينها في الاستهداف

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

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

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

قائمة المتصفّحات المطلوب استبعادها في الاستهداف

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

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

تصنيفات المحتوى الرقمي - استبعادلاسلسلة، قائمةنعمقائمة بتصنيفات المحتوى الرقمي المطلوب استبعادها. تنسيق القائمة = (G;PG; etc.).
  • G
  • PG
  • T
  • المغرب
  • ?
إعداد حساسية أمان العلامة التجاريةلاسلسلةنعميمكنك اختيار إعداد الحساسية لحظر المستودع بناءً على موضوع المحتوى المحيط به.
  • عدم الحظر
  • استخدام إثبات الملكية في "مدير الحملة 360"
  • استخدام خيار التخصيص
الإعدادات المخصّصة لأمان العلامة التجاريةمطلوب عندما يتم ضبط "الإعداد المخصّص لأمان العلامة التجارية" على "استخدام مخصّص"سلسلة، قائمةنعمإذا تم ضبط إعداد "حساسية أمان العلامة التجارية" على "استخدام مخصّص"، حدِّد قائمة مصنِّفات المحتوى العادية. على سبيل المثال، (محتوى جنسي أو كحول أو تبغ أو غير ذلك).
  • محتوى جنسي
  • محتوى ازدرائي
  • عمليات التنزيل والمشاركة
  • الأسلحة
  • المقامرة
  • عنف
  • محتوى موحي جنسيًا
  • اللغة النابية
  • الكحول
  • مخدرات
  • التبغ
  • السياسة
  • الديانة
  • التراجيديا
  • حوادث وسائل النقل
  • القضايا الاجتماعية الحسّاسة
  • محتوى صادم
خدمات التحقُّق التابعة لجهات خارجيةلاسلسلةنعممقدِّم خدمات إثبات الملكية من جهة خارجية.
  • لا ينطبق
  • Integral Ad Science
  • DoubleVerify
  • Adloox
تصنيفات التحقّق من جهات خارجيةلاسلسلة، قائمةنعمإذا لم يتم ضبط "خدمات التحقّق من جهة خارجية" على القيمة "غير محدّد"، حدِّد قائمة التصنيفات التي يتيحها مقدّم الخدمة المحدّد.
استهداف القنوات - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

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

تنسيق القائمة = (someurl.com; someurltwo.com؛ وما إلى ذلك). تم إنشاء هذه القائمة بترتيب أبجدي تصاعدي.

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

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

تنسيق القائمة = (someurl.com; someurltwo.com؛ وما إلى ذلك). تم إنشاء هذه القائمة بترتيب أبجدي تصاعدي.

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

قائمة التطبيقات التي يمكن تضمينها في الاستهداف. القائمة عبارة عن سلاسل تسلسلية للنظام الأساسي للتطبيق ومعرّف النظام الأساسي للتطبيق.

يتم استخدام القيم التالية لتحديد النظام الأساسي للتطبيق:

  • APP (يشمل ذلك كلاً من نظامَي "متجر Android Play" وApple App Store)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
يتم تقديم المعرّف من خلال النظام الأساسي ذي الصلة، مثل معرّف الحزمة من متجر Play لنظام التشغيل Android (مثال: com.google.android.gm) أو رقم تعريف التطبيق من متجر تطبيقات Apple (مثال: 422689480).

السلسلة المسلسلة للنظام الأساسي للتطبيق ورقم التعريف مفصولان بنقطتين، على سبيل المثال: APP:com.google.android.gm.

تنسيق القائمة = (APP:com.google.android.gm، وAPP:422689480، وغير ذلك). تم إنشاء هذه القائمة بترتيب أبجدي تصاعدي.

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

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

يتم استخدام القيم التالية لتحديد النظام الأساسي للتطبيق:

  • APP (يشمل ذلك كلاً من نظامَي "متجر Android Play" وApple App Store)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
يتم تقديم المعرّف من خلال النظام الأساسي ذي الصلة، مثل معرّف الحزمة من متجر Play لنظام التشغيل Android (مثال: com.google.android.gm) أو رقم تعريف التطبيق من متجر تطبيقات Apple (مثال: 422689480).

السلسلة المسلسلة للنظام الأساسي للتطبيق ورقم التعريف مفصولان بنقطتين، على سبيل المثال: APP:com.google.android.gm.

تنسيق القائمة = (APP:com.google.android.gm، وAPP:422689480، وغير ذلك). تم إنشاء هذه القائمة بترتيب أبجدي تصاعدي.

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

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

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

تنسيق القائمة = (TargetOption.targetingOptionId;targetingOption.targetingOptionId; إلخ.).

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

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

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

تنسيق القائمة = (TargetOption.targetingOptionId;targetingOption.targetingOptionId; إلخ.).

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

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

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

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

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

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

قائمة أنواع المحتوى التي يمكن تضمينها في الاستهداف.

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

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

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

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

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

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

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

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

تم إنشاء هذه القائمة بترتيب أبجدي تصاعدي.

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

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

تم إنشاء هذه القائمة بترتيب أبجدي تصاعدي.

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

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

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

تنسيق القائمة = (NonKeywordList. negativeKeywordListId; negativeKeywordList. مطابقKeywordListId; وما إلى ذلك). تم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

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

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

بالنسبة إلى قوائم مستخدمي الطرف الأول، يتم إدراج كل شريحة جمهور كزوج من إعدادات FirstAndThirdParty Audience.firstAndThirdParty AudienceId وإعدادات مدى الحداثة. الزوج هو (1;1d؛)، حيث يشير 1d إلى مدى حداثة النموذج ويمثل حداثة يوم واحد. لا تتوفّر ميزة الحداثة لشرائح الجمهور من الجهات الخارجية، وبالتالي يكون تنسيق القائمة هو (3؛)؛(4؛). بالنسبة إلى المجموعتَين "و" و "أو" من الجماهير، اتّبع هذا المثال: للجمع بين أزواج من الجماهير سواء مع حداثة أو بدون حداثة: '((1;1d;);(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.

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

تنسيق القائمة = ((FirstAndThirdParty Audience.firstAndThirdPartyResourceId; recency متخصّص;)؛ (FirstAndThirdPartyAudiences.firstAndPartyPartyId; 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 يومًا
الجمهور ذو الاهتمامات المشتركة واستهداف الجمهور في السوق - تضمينلاسلسلة، قائمةنعم

قائمة قوائم الجمهور ذي الاهتمامات المشتركة و/أو الجمهور في السوق المطلوب تضمينها.

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

تنسيق القائمة = (رقم تعريف الجمهور، رقم تعريف الجمهور، إلخ.). تم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

الجمهور ذو الاهتمامات المشتركة واستهداف الجمهور في السوق - استبعادلاسلسلة، قائمةنعم

قائمة قوائم الجمهور ذي الاهتمامات المشتركة و/أو قوائم المستخدمين في السوق المطلوب استبعادها.

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

تنسيق القائمة = (رقم تعريف الجمهور، رقم تعريف الجمهور، إلخ.). تم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

استهداف القوائم المخصّصةلاسلسلة، قائمةنعم

قائمة بالقوائم المخصّصة المطلوب استهدافها

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

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

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

قائمة بمصادر المستودعات الإعلانية والتبادلات والتبادلات الفرعية المُراد تضمينها في الاستهداف

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

تنسيق القائمة = (InventorySource.inventorySourceId; exchangeId; TargetOption.targetingOptionId; وما إلى ذلك)

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

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

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

تنسيق القائمة = (InventorySource.inventorySourceId; exchangeId; TargetOption.targetingOptionId; وما إلى ذلك)

استهداف مصادر المستودع - استهداف التبادلات الجديدةلاسلسلةنعمالإعداد لاستهداف التبادلات الجديدة.
  • صحيح
  • خطأ
استهداف فترات اليوملاسلسلة، قائمةنعم

قائمة بالمعرِّفات، حيث يتم إنشاء كل رقم تعريف جزء من اليوم بالتنسيق التالي:
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ start * 100
+ end

base_dayparting_id = 300000
days_since_monday: 0=days_since_monday: 0=days_since_monday: 0=Monday, 1=Monday.



"المحلي"). بالنسبة إلى الكيانات الحالية، لن يتم تغيير المنطقة الزمنية.

تم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

المنطقة الزمنية لاستهداف فترات اليوممطلوب عند تضمين "استهداف فترات اليوم".سلسلةنعمالمنطقة الزمنية المستخدمة لاستهداف فترات اليوم.
  • حملة محلية
  • المعلِن
استهداف البيئةلاسلسلة، قائمةنعمقائمة البيئات المُراد استهدافها. اختَر قيمة أو أكثر من القيم المقبولة. تجدر الإشارة إلى أنّه لا يمكن اختيار "الويب غير محسَّن" بدون اختيار "الويب".
  • الويب
  • غير محسَّن على الويب
  • تطبيق
تم تفعيل استهداف Omid لإمكانية العرضلاسلسلةنعملتفعيل استهداف مرات الظهور فقط القابلة للقياس من خلال معيار القياس المفتوح.
  • TRUE
  • FALSE
إمكانية العرض التي تستهدف العرض النشطلاسلسلةنعمالنسب المئوية المتوقعة لإمكانية العرض. يتم تمثيل النسب المئوية على شكل أعداد عشرية. أحد {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
استهداف المواضع - الإعلانات الصورية على الشاشةلاسلسلة، قائمةنعماستهداف مواضع الإعلانات الصورية على الشاشة. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف الموضع - فيديو على الشاشةلاسلسلة، قائمةنعماستهداف مواضع إعلانات الفيديو على الشاشة. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف المواضع - موضع العرض في المحتوىلاسلسلة، قائمةنعممواضع محتوى الإعلان الصوري المستهدفة. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • داخل المقالة
  • ضمن الخلاصة
  • داخل بانر
  • إعلان بيني
  • غير معروف
استهداف المواضع - موضع الفيديو في المحتوىلاسلسلة، قائمةنعممواضع محتوى إعلانات الفيديو المطلوب استهدافها. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • داخل المقالة
  • ضمن الخلاصة
  • داخل بانر
  • إعلان بيني
  • إعلان خارج البث غير معروف
  • إعلان ما قبل التشغيل
  • إعلان أثناء التشغيل
  • ما بعد التشغيل
  • غير معروف أثناء عرض الفيديو
استهداف المواضع - موضع الصوت في المحتوىلاسلسلة، قائمةنعممواضع محتوى الإعلانات الصوتية المطلوب استهدافها. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • إعلان ما قبل التشغيل
  • إعلان أثناء التشغيل
  • ما بعد التشغيل
  • غير معروف
استهداف حجم مشغّل الفيديولاسلسلة، قائمةنعمقائمة بحجم مشغّل إعلان الفيديو المطلوب استهدافه. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • غير معروف
  • صغير
  • كبير
  • الدقة العالية
استهداف مدة المحتوىلاسلسلة، قائمةنعمقائمة مُدد المحتوى المطلوب استهدافها. قيمة الوحدة هي دقائق. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • ‪60+
  • غير معروف
استهداف نوع بث المحتوىلاسلسلة، قائمةنعمقائمة بأنواع مجموعات بث المحتوى المطلوب استهدافها. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • بث مباشر
  • عند الطلب
استهداف نوع المحتوى الصوتيلاسلسلة، قائمةنعمقائمة بنوع المحتوى الصوتي المطلوب استهدافه. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • غير معروف
  • راديو على الإنترنت
  • الاستماع إلى الموسيقى
  • مقاطع البودكاست
استهداف الفئة الديمغرافية حسب الجنسلاسلسلة، قائمةنعمقائمة الأجناس المطلوب استهدافها. حدد قيمة واحدة أو أكثر من القيم المقبولة:
  • أنثى
  • ذكر
  • غير معروف
العمر عند استهداف الفئة الديمغرافيةلاسلسلة، قائمةنعماستهداف فئة عمرية للمستخدم: حدد نطاق من/إلى عن طريق تحديد عمر "من" واحد وعمر واحد إلى، وما إذا كان سيتم تضمين أعمار غير معروفة صواب/خطأ. اطّلِع على قائمة الفئات العمرية المقبولة من/إلى.
مثال 1: لاستهداف الفئة العمرية من 18 إلى 55 عامًا ولتضمين أعمار غير معروفة، حدِّد التنسيق {From; To ;includeUnknown True/False} = 18;55;true;
المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستثناء الأعمار غير المعروفة، حدِّد القيم التالية = 35؛+؛خطأ من:
.
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

القيم المقبولة للحقل "إلى":
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
دخل الأسرة الذي يستهدف الفئة الديمغرافيةلاسلسلة، قائمةنعماستهداف فئة لدخل الأسرة. حدد نطاق من/إلى عن طريق تحديد نطاق دخل واحد أعلى_of_Range ونطاق دخل واحد سفلي_من_نطاق_نطاق دخل واحد وما إذا كان سيتم تضمين الأسر ذات دخل غير معروف صواب/خطأ. يمكن الاطّلاع على قائمة قيم Top_of_Range/Bottom_of_Range The Bottom_Range/Bottom_of_Range [Top_Range/Bottom_of_Range [Top_Range/Bottom_of_Range لأنه يدرج في أعلى 10% إلى 50% من الأسر، ولتضمين الأسر ذات دخل غير معروف، يجب تحديد التنسيق {Top_of_Range; Bottom_of_Range;Include Bottom_of_Range;Include Unknown True/False} = Top 10%;41-50%;true.
المثال 2:

  • أعلى 10%
  • 11 -‏ 20‏%
  • 21‏ - 30‏%
  • 31‏ - 40‏%
  • 41 - 50‏%
  • أدنى 50%

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

قائمة مزوّدي خدمات الإنترنت أو مشغّلي شبكة الجوّال الذين تريد استهدافهم

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

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

استهداف شركات الجوّال - استبعادلاسلسلة، قائمةنعم

قائمة بمزوّدي خدمة الإنترنت أو مشغّلي شبكة الجوّال المطلوب استبعادها

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

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

تحسين طلب الإدراجنعمسلسلةنعمتفعيل/إيقاف تحسين طلب الإدراج
  • TRUE
  • FALSE
وحدة استراتيجية عروض الأسعارمطلوب عندما يتم ضبط الإعداد "تحسين طلب الإدراج" على "صحيح"سلسلةنعماختَر وحدة استراتيجية عروض الأسعار لتحسين عروض الأسعار:
  • تكلفة الإجراء
  • تكلفة النقرة
  • قيمة مرات الظهور المخصّصة/التكلفة
  • CIVA
  • IVO_TEN
  • AV_VIEWED
عدم تجاوز استراتيجية عروض الأسعارمطلوب عندما يتم ضبط الإعداد "تحسين طلب الإدراج" على "صحيح"floatنعماضبط قيمة التكلفة لكل ألف ظهور على "عدم تجاوز". إذا كانت القيمة 0، فإن خيار 'عدم التجاوز' غير مفعَّل.
تطبيق السعر الأدنى على العروضمطلوب عندما يتم ضبط الإعداد "تحسين طلب الإدراج" على "صحيح"سلسلةنعمتحديد ما إذا كان سيتم إعطاء الأولوية للصفقات على مستودع المزاد المفتوح
  • TRUE
  • FALSE
معرّف الخوارزميةتكون هذه السمة مطلوبة عند استخدام قيمة مرات الظهور المخصّصة/التكلفة في "وحدة استراتيجية عروض الأسعار".عدد صحيحنعميجب استخدام رقم تعريف الخوارزمية المقابل هذا عند ضبط وحدة استراتيجية عروض الأسعار على قيمة مرات الظهور المخصّصة/التكلفة.