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

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

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

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

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

فئة الرسومنوع الرسومخيار الفوترة
CPM/Mediaتلقائيغير مسموح به (اتركه فارغًا)
CPM/Mediaخادم إعلانات خارجيغير مسموح به (اتركه فارغًا)
CPM/MediaDoubleVerifyمسموح به (صحيح/خطأ)
CPM/MediaAdsafeغير مسموح به (اتركه فارغًا)
CPM/MediaAdxposeغير مسموح به (اتركه فارغًا)
CPM/MediaVizuغير مسموح به (اتركه فارغًا)
CPM/Mediaإجمالي المعرفةغير مسموح به (اتركه فارغًا)
CPM/MediaTeracentغير مسموح به (اتركه فارغًا)
CPM/MediaEvidonغير مسموح به (اتركه فارغًا)
CPM/Mediaرسوم مكتب التداول للوكالةغير مسموح به (اتركه فارغًا)
CPM/MediaAdlooxمسموح به (صحيح/خطأ)
التكلفة لكل ألف ظهورتسوّق محليمطلوب (True)
التكلفة لكل ألف ظهورTrustMetricsغير مسموح به (اتركه فارغًا)
التكلفة لكل ألف ظهورفيديو من Integral Ad Scienceمسموح به (صحيح/خطأ)
التكلفة لكل ألف ظهورMOAT Videoغير مسموح به (اتركه فارغًا)
الوسائطرسوم "مساحة العرض والفيديو 360"مطلوب (True)
الوسائطبيانات تكلفة جميع الوسائلغير مسموح به (اتركه فارغًا)
الوسائطرسوم Scibidsمطلوب (True)
شفرة الدمجلاسلسلةنعمرمز اختياري لأغراض التتبُّع
التفاصيللاسلسلةنعمتفاصيل الإدخال بتنسيق السلسلة
تعديل الفيديونعمسلسلةنعم

الفترة الزمنية المستخدَمة لإنفاق مبلغ تحديد وتيرة الإنفاق

  • يوميًا
  • شهريًا
  • مدّة عرض الإعلانات
معدّل تسجيل مرات الظهورنعمسلسلةنعم

معدّل تحديد وتيرة عرض هذا الإدخال.

  • في أقرب وقت ممكن
  • متساوٍ
  • قبالة
لا يتوافق خيار "في أقرب وقت ممكن" في
مع وتيرة العرض "رحلة جوية".
مبلغ تحديد وتيرة الإنفاقنعمعدد عائمنعمالمبلغ المطلوب إنفاقه لكل فترة زمنية يحدّدها نوع وتيرة الإنفاق.
تفعيل ميزة "عدد مرات الظهور"نعمسلسلةنعمتتيح هذه السمة تفعيل ميزة تحديد عدد مرات الظهور المستندة إلى مرات الظهور أو إيقافها في طلب الإدراج.
  • صواب
  • خطأ
عدد مرات الظهورمطلوبة عندما تكون قيمة "تفعيل عدد مرات الظهور" هي "TRUE"عدد صحيحنعممبلغ عدد صحيح موجب لعدد مرّات الظهور في "مبلغ عدد مرات الظهور" معيّن، أي x في "عرض x مرّات ظهور خلال الفترة y".
فترة التكرارمطلوبة عندما تكون قيمة "تفعيل عدد مرات الظهور" هي "TRUE"سلسلةنعمتحدّد هذه السمة وحدة الفترة الزمنية لتحديد عدد مرات الظهور.
  • دقائق
  • ساعات
  • الأيام
  • الأسابيع
  • الأشهر
مبلغ التكرارمطلوبة عندما تكون قيمة "تفعيل عدد مرات الظهور" هي "TRUE"عدد صحيحنعممبلغ عدد صحيح موجب لمدة الفترة الزمنية لنوع "فترة تحديد عدد مرات الظهور"، أي y في "عرض x مرة ظهور خلال الفترة y".

يجب أن تكون الفترات الزمنية لتحديد عدد مرات الظهور 30 يومًا أو أقل.
نوع مؤشر الأداء الرئيسينعمسلسلةنعموحدة مؤشر الأداء الرئيسي لطلب الإدراج
  • التكلفة لكل ألف ظهور
  • التكلفة لكل إجراء
  • تكلفة النقرة
  • انخفاض في تكلفة المشاهدة
  • تكلفة مرة الظهور المسموعة والقابلة للعرض عند الاكتمال
  • CTR
  • نسبة إمكانية العرض
  • التكلفة لكل اشتراك
  • معدل الإحالات الناجحة لكل نقرة
  • معدل الإحالات الناجحة لكل مرة ظهور
  • VCPM
  • زيادة في نسبة المشاهدات المكتملة
  • معدل الاستماع إلى الملف الصوتي بالكامل
  • معدّل مشاهدة الفيديو بالكامل
  • تكلفة الاستماع المكتمل
  • تكلفة المشاهدة المكتملة
  • TOS10
  • زيادة معدّل تسجيل مرات الظهور إلى أقصى حد
  • تكلفة/قيمة مرات الظهور المخصصة
  • بدون
  • غير ذلك
قيمة مؤشر الأداء الرئيسينعمسلسلةنعمقيمة مؤشر الأداء الرئيسي بالعملة (CPM، CPA، CPC، CPV، CPIAVC، CPE، VCPM)، أو كنسبة مئوية (نسبة المشاهدة، CTR، CVR النقرة، CVR الظهور، VTR، CR الصوت، CR الفيديو، CPCL، CPCA، TOS10)، أو بدون وحدة (قيمة / تكلفة الظهور المخصصة)، أو كسلسلة نصية (أخرى). إذا كان نوع مؤشر الأداء الرئيسي المقدَّم هو "زيادة سرعة عرض الإعلانات إلى أقصى حد" أو "بلا"، سيتم تجاهل هذا العمود.
معرّف خوارزمية مؤشر الأداء الرئيسيمطلوب عندما يكون "نوع مؤشر الأداء الرئيسي" هو "تكلفة / قيمة مرات الظهور المخصّصة"عدد صحيحنعمرقم تعريف خوارزمية عروض الأسعار المخصّصة المرتبط بمؤشر الأداء الرئيسي إذا كان نوع مؤشر الأداء الرئيسي هو CUSTOM_BIDDING_VALUE_COST. بخلاف ذلك، يتم تجاهل هذا العمود.
قياس مدى الوصول إلى الجمهور المستهدفنعمسلسلةنعمتفعيل/إيقاف قياس الجمهور باستخدام Nielsen Digital Ad Ratings
  • صواب
  • خطأ
قياس قناة DARمطلوب عندما تكون قيمة "قياس مدى الوصول إلى الجمهور" هي "TRUE"عدد صحيحنعم

القناة التي سيتم قياسها باستخدام Nielsen Digital Ad Ratings

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

Format = Channel.channelId

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

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

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

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

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

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

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

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

الاستهداف القريبلاسلسلة، قائمة قوائمنعمقائمة بالمواقع الجغرافية المستهدَفة القريبة، كلّ منها بالتنسيق "(Latitude; Longitude; Radius; Unit; FullAddress;);". يجب أن يتراوح خط العرض بين 90- و90 درجة (شاملة)، وخط الطول بين 180- و180 درجة (شاملة)، وأن تكون المسافة بين 1 و500 (شاملة) في الوحدة، ويمكن أن تكون الوحدة "mi" أو "km"، وFullAddress اختيارية. على سبيل المثال: "(38.907192; -77.03687; 1.0; mi; Washington D.C., DC, USA;); (40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; mi; ;);".

استهداف قائمة المواقع الجغرافية القريبةلاسلسلة، قائمة قوائمنعمقائمة بالاستهدافات المستندة إلى قوائم المواقع القريبة لطلبات الإدراج أو عناصر "غير TrueView"، كلّ منها بالتنسيق "(ProximityListId; Radius; Unit; );". ProximityListId هو رقم تعريف قائمة مواقع جغرافية ضِمن موارد أحد المعلِنين. النطاق الجغرافي هو مسافة تتراوح بين 1 و500 (شاملة) في الوحدة، ويمكن أن تكون الوحدة "ميل" أو "كيلومتر". هناك حدّ لاستهداف قائمتَي مواقع جغرافية لكل كيان إلى جانب قوائم المواقع الجغرافية الإقليمية. على سبيل المثال: "(10041691678; 20.0; mi;); (10038858567; 20.5; km;);".

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

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

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

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

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

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

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

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

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

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

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

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

تنسيق القائمة = (TargetingOption.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; etc.). يتم إنشاء هذه القائمة بالترتيب الأبجدي التصاعدي.

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

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

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

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

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

تُستخدَم القيم التالية لتحديد نظام تشغيل التطبيق:

  • 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; etc.). يتم إنشاء هذه القائمة بالترتيب الأبجدي التصاعدي.

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

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

تُستخدَم القيم التالية لتحديد نظام تشغيل التطبيق:

  • 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; etc.). يتم إنشاء هذه القائمة بالترتيب الأبجدي التصاعدي.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى قوائم جمهور الطرف الأول، يتم إدراج كل جمهور كزوج من FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId وإعداد "الحداثة". الزوج هو (1;1d;‎)، حيث يمثّل 1d مدى الحداثة لعيّنة تبلغ يومًا واحدًا. لا تتوفّر بيانات الحداثة لشرائح الجمهور التابعة لجهات خارجية، لذا يكون تنسيق القائمة هو (3;);(4;);. لدمج مجموعات من شرائح الجمهور باستخدام "AND" و "OR"، اتّبِع المثال التالي: لدمج أزواج مع مراعاة الحداثة وبدون مراعاتها: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. يعني ذلك (القائمة 1 مع حداثة البيانات ليوم واحد أو القائمة 2 مع حداثة البيانات لـ 365 يومًا) و (القائمة 3 بدون حداثة بيانات محدّدة أو القائمة 4 مع حداثة البيانات لـ 5 دقائق أو القائمة 5 مع جميع المستخدمين).

في ما يلي قيم الحداثة الصالحة:

  • الكل
  • 1 د
  • ‫5 د
  • ‫10 دقائق
  • ‫15 د
  • ‫30 د
  • 1 س
  • ساعتان
  • 3 ساعات
  • 6 ساعات
  • ‫12 ساعة
  • يوم واحد
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • ‫10 أيام
  • 14 يومًا
  • ‫15 يومًا
  • ‫21 يومًا
  • 28 يومًا
  • 30 يومًا
  • 45 يومًا
  • ‫60 يومًا
  • 90 يومًا
  • ‫120d
  • ‫180 يومًا
  • ‫270 يومًا
  • 365 يومًا

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

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

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

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

تنسيق القائمة = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)
مثال: "(1;1d;);(2;);".

في ما يلي قيم الحداثة الصالحة:

  • الكل
  • 1 د
  • ‫5 د
  • ‫10 دقائق
  • ‫15 د
  • ‫30 د
  • 1 س
  • ساعتان
  • 3 ساعات
  • 6 ساعات
  • ‫12 ساعة
  • يوم واحد
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • ‫10 أيام
  • 14 يومًا
  • ‫15 يومًا
  • ‫21 يومًا
  • 28 يومًا
  • 30 يومًا
  • 45 يومًا
  • ‫60 يومًا
  • 90 يومًا
  • ‫120d
  • ‫180 يومًا
  • ‫270 يومًا
  • 365 يومًا

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

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

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

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

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

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

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

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

استهداف قائمة العملاءلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

تنسيق القائمة = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

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

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

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

تنسيق القائمة = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

استهداف مصدر المساحة الإعلانية - استهداف التبادلات الجديدةلاسلسلةنعمإعداد لاستهداف التبادلات الجديدة
  • True
  • خطأ

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

قائمة بالمعرّفات، حيث يتم إنشاء كل معرّف لفترة من اليوم بالتنسيق التالي:

daypart_id = base_dayparting_id + (days_since_monday * 10000) + (start * 100) + end

حدود المتغيّرات:

  • base_dayparting_id = 300000
  • ‫days_since_monday: 0=الاثنين، 1=الثلاثاء، ...، 6=الأحد
  • البداية: 0..95 (00:00--23:45) عدد صحيح من 0 إلى 95، يمثّل فترات زمنية مدتها 15 دقيقة
  • end: 1..96 (00:15--24:00); عدد صحيح من 0 إلى 95، يمثّل فترات زمنية مدتها 15 دقيقة
  • البداية < النهاية

بالنسبة إلى الكيانات الجديدة، سيتم ضبط الأوقات في المنطقة الزمنية للمستخدمين(أي "Local"). بالنسبة إلى الكيانات الحالية، لن يتم تغيير المنطقة الزمنية.

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

المنطقة الزمنية لاستهداف أوقات معيّنة من اليوممطلوب عند تضمين "الاستهداف حسب الأوقات خلال اليوم"سلسلةنعمالمنطقة الزمنية التي سيتم استخدامها لاستهداف أوقات معيّنة من اليوم
  • بالتوقيت المحلي
  • المعلِن

استهداف البيئةلاسلسلة، قائمةنعمقائمة البيئات التي يجب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة. يُرجى العِلم أنّه لا يمكن اختيار "غير محسّن للويب" بدون اختيار "الويب".
  • الويب
  • غير محسَّنة على الويب
  • التطبيق

تفعيل استهداف Omid لإمكانية العرضلاسلسلةنعميتيح هذا الخيار استهداف مرّات الظهور القابلة للقياس فقط من خلال معيار القياس المفتوح.
  • صواب
  • خطأ

استهداف إمكانية العرض في "العرض النشط"لاسلسلةنعماستهداف نسب إمكانية العرض المتوقّعة يتم تمثيل النسب المئوية كأرقام عشرية. إحدى القيم {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}

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

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

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

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

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

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

استهداف مدة المحتوىلاسلسلة، قائمةنعمقائمة بمدد المحتوى المطلوب استهدافه قيمة الوحدة هي دقائق. اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • ‪60+
  • غير معروف

استهداف نوع مجموعة بث المحتوىلاسلسلة، قائمةنعمقائمة بأنواع مجموعات بث المحتوى التي يجب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • بث مباشر
  • عند الطلب

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

استهداف الفئة الديمغرافية حسب الجنسلاسلسلة، قائمةنعمقائمة الأجناس المطلوب استهدافها. اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • أنثى
  • ذكر
  • غير معروف

استهداف الفئة الديمغرافية حسب العمرلاسلسلة، قائمةنعماستهداف فئة عمرية معيّنة من المستخدمين حدِّد نطاقًا من/إلى من خلال اختيار عمر واحد في حقل "من" وعمر واحد في حقل "إلى" وما إذا كنت تريد تضمين الأعمار غير المعروفة (صحيح/خطأ). اطّلِع على قائمة الأعمار المقبولة في الحقلَين "من" و"إلى".
المثال 1: لاستهداف الفئة العمرية من 18 إلى 55 عامًا وتضمين الأعمار غير المعروفة، حدِّد التنسيق {من؛ إلى؛ تضمين الأعمار غير المعروفة صحيح/خطأ} = 18؛55؛صحيح؛
المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الأعمار غير المعروفة، حدِّد ما يلي = 35؛+؛خطأ؛.
القيم المقبولة في الحقل "من":
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

القيم المقبولة في حقل "إلى"
  • 25
  • 35
  • 45
  • 55
  • 65
  • +

استهداف الفئات الديمغرافية حسب دخل الأسرةلاسلسلة، قائمةنعماستهداف نطاق دخل الأسرة حدِّد نطاقًا من/إلى من خلال اختيار نطاق دخل Top_of_Range واحد ونطاق دخل Bottom_of_Range واحد وما إذا كنت تريد تضمين الأسر التي يكون دخلها غير معروف (true/false). اطّلِع على قائمة بنطاقات 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)
  • 4G

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

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

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

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

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

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

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

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

تحسين طلب الإدراجنعمسلسلةنعم

تفعيل/إيقاف تحسين ترتيب الإعلانات

إذا تم ضبط هذا العمود على "TRUE"، ستستخدِم عناصر الحملة ضمن أمر الإدراج هذا استراتيجية عروض الأسعار الخاصة بأمر الإدراج.

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

يجب استخدام معرّف الخوارزمية المطابق هذا عند ضبط "وحدة استراتيجية عروض الأسعار" على "قيمة/تكلفة الظهور المخصّصة".

يجب تضمين أيّ أنشطة في Floodlight مستخدَمة في الخوارزمية المعيّنة لهذا العمود في عمود "معرّفات أنشطة الإحالات الناجحة في Floodlight". ستؤدي محاولات تعيين خوارزمية بدون تعديل عمود "أرقام تعريف نشاط الإحالة الناجحة في Floodlight" بشكلٍ صحيح إلى حدوث خطأ.