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

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

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

تم إيقاف الشراء المستند إلى النتائج نهائيًا. و"الظهور" هي القيمة الوحيدة الصالحة.

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

مثال "(CPM; 2; Display & Video 360 مقياس; False) ; (Media; 13; Default; True);"
عرض القيم المقبولة في الجدول التالي:

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

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

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

التنسيق = Channel.channelId

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

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

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

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

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

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

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

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

الاستهداف القريبلاسلسلة، قائمة القوائمنعمقائمة بالأهداف القريبة بالتنسيق التالي: "(خط العرض؛ خط الطول؛ النطاق الجغرافي؛ الوحدة؛ العنوان الكامل؛)". يتراوح خط العرض بين -90 و90 درجة (شاملة)؛ ويتراوح خط الطول بين -180 و180 درجة (شاملة)؛ النطاق الجغرافي هو مسافة تتراوح بين 1 و500 (شامل) في الوحدة، ويمكن أن تكون الوحدة "ميل" أو "كلم"، والعنوان الكامل اختياري. على سبيل المثال: "(38.907192; -77.03687; 1.0; mi; Washington D.C., DC، الولايات المتحدة؛)؛ (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; كلم;);".
استهداف اللغة - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

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

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

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

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

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

تصنيفات المحتوى الرقمي - استبعادلاسلسلة، قائمةنعمقائمة بتصنيفات المحتوى الرقمي المطلوب استبعادها تنسيق القائمة = (G;PG، إلخ.).
  • 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 (يشمل ذلك النظامَين الأساسيَين لـ "متجر 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) أو معرّف تطبيق من App Store التابع لشركة 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) أو معرّف تطبيق من App Store التابع لشركة Apple (على سبيل المثال: 422689480).

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

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

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

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

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

تنسيق القائمة = (TargetOption.targetingOptionId; استهدافOption.targetingOptionId; وما إلى ذلك).

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

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

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

تنسيق القائمة = (TargetOption.targetingOptionId; استهدافOption.targetingOptionId; وما إلى ذلك).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تنسيق القائمة = ((FirstAndFirstPartyGroup.firstAndPartyGroupId; recencyoptional;); (FirstAndParty AudienceId; 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"، وأرقام تعريف التبادلات المنشورة، وأرقام تعريف موارد واجهة برمجة التطبيقات TargetingOption على "مساحة العرض والفيديو 360" من نوع الاستهداف TARGETING_TYPE_SUB_EXCHANGE.

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

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

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

يستخدِم هذا العمود أرقام تعريف موارد واجهة برمجة التطبيقات InventorySource في "مساحة العرض والفيديو 360"، وأرقام تعريف التبادلات المنشورة، وأرقام تعريف موارد واجهة برمجة التطبيقات TargetingOption على "مساحة العرض والفيديو 360" من نوع الاستهداف 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, 16 .1=صفة=مَعلمة .



"المحلي"). ولن يتم تغيير المنطقة الزمنية في الكيانات الحالية.

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

المنطقة الزمنية للاستهداف خلال اليوممطلوب عند تضمين "استهداف فترات اليوم".سلسلةنعمالمنطقة الزمنية المراد استخدامها للاستهداف خلال فترات اليوم.
  • حملة محلية
  • المعلِن
استهداف البيئةلاسلسلة، قائمةنعمقائمة البيئات المطلوب استهدافها. اختَر قيمة أو أكثر من القيم المقبولة. تجدر الإشارة إلى أنّه لا يمكن اختيار "الويب غير محسَّن" بدون اختيار "الويب".
  • الويب
  • غير محسَّنة على الويب
  • تطبيق
تم تفعيل إمكانية العرض وسط الاستهدافلاسلسلةنعميتيح استهداف مرات الظهور القابلة للقياس فقط من خلال معيار القياس المفتوح.
  • 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;+;false;.
القيم المقبولة بالنسبة إلى
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

القيم المقبولة للسمة "إلى":
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
استهداف الفئة الديمغرافية دخل الأسرةلاسلسلة، قائمةنعماستهداف فئة دخل للأسرة. حدِّد نطاق دخل من/إلى نطاق عن طريق اختيار مستوى دخل واحد في Top_of_Range ونطاق دخل Bottom_of_Range واحد وما إذا كان سيتم تضمين الأسر ذات الدخل غير المعروف (صواب/خطأ). يُرجى الاطّلاع على قائمة القيم المقبولة: Top_of_Range/Bottom_Range/Bottom_Range النطاق/الحد الأدنى للنطاقات المقبولة:
المثال 1:استهداف أعلى 10% إلى 50% من الأسر بما في ذلك الأسر ذات الدخل غير المعروفة، حدد الصيغة {Top_of_Range; Bottom_of_Range; Bottom_of_Range} = أعلى صواب/خطأ من الفئة = أعلى 10%، القيم الأدنى_المقبولة، القيم الأعلى = %10، أو الحد_الأدنى = القيم

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

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

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

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

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

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

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

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

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

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