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

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

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

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

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

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

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

يستخدم هذا العمود العمود "عرض رقم تعريف مورد Video 360 API Channel.

التنسيق = Channel.channelId

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

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

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

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

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

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

يستخدم هذا العمود العرض & أرقام تعريف موارد Video 360 API TargetingOption لنوع الاستهداف 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؛ كم؛)؛.
استهداف اللغة - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

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

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

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

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

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

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

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API Channel

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

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

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API Channel

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

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

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

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

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

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

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

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

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

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

  • APP (يشمل ذلك منصّتَي "متجر Play" على Android و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 (يشمل ذلك منصّتَي "متجر Play" على Android و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; إلخ). تم إنشاء هذه القائمة بترتيب أبجدي تصاعدي.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يستخدم هذا العمود العرض & أرقام تعريف موارد Video 360 API TargetingOption لنوع الاستهداف TARGETING_TYPE_CONTENT_GENRE

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

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

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

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

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

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

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

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

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API NegativeKeywordList

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

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

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

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

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

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

يستخدم هذا العمود العرض & معرّفات مراجع Video 360 API FirstAndThirdPartyAudience

يتم إدراج كل شريحة جمهور كزوج من FirstAndThirdPartyAudiences.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; إلخ). تم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

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

يستخدم هذا العمود العرض & أرقام تعريف موارد Video 360 API InventorySource وأرقام تعريف تبادل الإعلانات المنشورة و"الشبكة الإعلانية" أرقام تعريف موارد Video 360 API TargetingOption لنوع الاستهداف TARGETING_TYPE_SUB_EXCHANGE

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

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

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

يستخدم هذا العمود العرض & أرقام تعريف موارد Video 360 API InventorySource وأرقام تعريف تبادل الإعلانات المنشورة و"الشبكة الإعلانية" أرقام تعريف موارد Video 360 API 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=Monday, 1=Tuesday, ..., 6=Sunday
start: 0..95 (00:00--23:45) عدد صحيح من 0 إلى 95 يمثّل خانات مدتها 15 دقيقة
end: 1..96 (00:15--24:00) عدد صحيح من 0 إلى 95 يمثّل خانات مدتها 15 دقيقة
start < end
بالنسبة إلى الكيانات الجديدة، سيتم ضبط الأوقات حسب المنطقة الزمنية للمستخدمين (أي "المحلي"). بالنسبة إلى الكيانات الحالية، لن يتم تغيير المنطقة الزمنية.

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

المنطقة الزمنية لاستهداف فترات اليوممطلوب عند تضمين "استهداف حسب الجزء من اليوم".سلسلةنعمالمنطقة الزمنية المستخدمة لاستهداف فترات اليوم.
  • بالتوقيت المحلي
  • المعلِن
استهداف البيئةلاسلسلة، قائمةنعمقائمة البيئات المُراد استهدافها. اختَر قيمة أو أكثر من القيم المقبولة. يُرجى العلم أنّه لا يمكن اختيار "الويب غير محسّن" بدون اختيار "الويب".
  • الويب
  • غير محسَّن على الويب
  • تطبيق
تم تفعيل استهداف Omid لإمكانية العرضلاسلسلةنعميتيح هذا الخيار استهداف مرّات الظهور القابلة للقياس فقط من خلال معيار القياس المفتوح.
  • صواب
  • خطأ
إمكانية العرض التي تستهدف العرض النشطلاسلسلةنعماستهدِف النسب المئوية المتوقّعة لإمكانية العرض. يتم تمثيل النسب المئوية كأرقام عائمة. أحد {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; إلى ؛ تضمين True/False غير معروف} = 18;55;true;
المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الأعمار غير المعروفة، حدِّد ما يلي = 35;+;false;.
القيم المقبولة للحقل "من":
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

القيم المقبولة للحقل "إلى":
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
استهداف الفئات الديمغرافية حسب دخل الأسرةلاسلسلة، قائمةنعماستهدِف نطاقًا لدخل الأسرة. حدد نطاق من/إلى عن طريق تحديد نطاق دخل واحد أعلى_of_Range ونطاق دخل واحد سفلي_من_نطاق_نطاق دخل واحد وما إذا كان سيتم تضمين الأسر ذات دخل غير معروف صواب/خطأ. اطّلِع على قائمة النطاقات المقبولة لـ Top_of_Range/Bottom_of_Range.
المثال 1: لاستهداف الشريحة الأعلى من %10 إلى %50 من الأسر وتضمين الأسر ذات الدخل غير المعروف، حدِّد التنسيق {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;
المثال 2: لاستهداف الشريحة الأدنى من %50 من الأسر فقط واستبعاد الأسر ذات الدخل غير المعروف، حدِّد التنسيق {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;
القيم المقبولة لسمة Top_of_Range/Bottom_of_Range:
  • أعلى 10%
  • 11 -‏ 20‏%
  • 21‏ - 30‏%
  • 31‏ - 40‏%
  • 41 - 50‏%
  • أدنى 50%

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

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

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

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

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

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

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

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

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