البيانات المنظَّمة - الإصدار 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);‎
يتم تقديم القيم المقبولة في الجدول التالي:

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

يجب أن تكون الفترات الزمنية لتحديد عدد مرات الظهور 30 يومًا أو أقل.
نوع مؤشر الأداء الرئيسينعمسلسلةنعموحدة مؤشر الأداء الرئيسي لطلب الإدراج
  • التكلفة لكل ألف ظهور
  • تكلفة الإجراء
  • تكلفة النقرة
  • انخفاض في تكلفة المشاهدة
  • تكلفة مرة الظهور المسموعة والقابلة للعرض عند الاكتمال
  • نسبة النقر إلى الظهور
  • نسبة إمكانية العرض
  • التكلفة لكل اشتراك
  • معدل الإحالات الناجحة لكل نقرة
  • معدل الإحالات الناجحة لكل مرة ظهور
  • VCPM
  • زيادة في نسبة المشاهدات المكتملة
  • معدل الاستماع إلى الملف الصوتي بالكامل
  • معدّل مشاهدة الفيديو بالكامل
  • تكلفة الاستماع المكتمل
  • تكلفة المشاهدة المكتملة
  • TOS10
  • زيادة معدّل تسجيل مرات الظهور إلى أقصى حد
  • تكلفة/قيمة مرات الظهور المخصصة
  • بدون
  • غير ذلك
قيمة مؤشر الأداء الرئيسينعمسلسلةنعمقيمة مؤشر الأداء الرئيسي بالعملة (CPM، CPA، CPC، CPV، CPIAVC، CPE، VCPM)، النسبة المئوية (% قابلية العرض، CTR، Click CVR، Impression CVR، VTR، Audio CR، Video 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 (شاملة) في الوحدة، ويمكن أن تكون الوحدة "ميل" أو "كيلومتر"، و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; إلخ).

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

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

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

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

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

قائمة بالمواقع الإلكترونية المطلوب تضمينها في الاستهداف. القائمة هي سلاسل من عناوين 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 في واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360" لنوع الاستهداف TARGETING_TYPE_CONTENT_GENRE.

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

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

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

يستخدم هذا العمود أرقام تعريف الموارد TargetingOption في واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 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 التي تتضمّن جميع المستخدمين).

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

  • الكل
  • دقيقة واحدة
  • ‫5 دقائق
  • ‫10 دقائق
  • ‫15 دقيقة
  • ‫30 دقيقة
  • 1 س
  • ساعتان
  • 3 ساعات
  • 6 ساعات
  • ‫12 ساعة
  • يوم واحد
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • ‫10 أيام
  • 14 يومًا
  • ‫15 يومًا
  • 21d
  • 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;);".

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

  • الكل
  • دقيقة واحدة
  • ‫5 دقائق
  • ‫10 دقائق
  • ‫15 دقيقة
  • ‫30 دقيقة
  • 1 س
  • ساعتان
  • 3 ساعات
  • 6 ساعات
  • ‫12 ساعة
  • يوم واحد
  • يومَان
  • ثلاثي الأبعاد
  • 5 ي
  • 7 أيام
  • ‫10 أيام
  • 14 يومًا
  • ‫15 يومًا
  • 21d
  • 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=Monday, 1=Tuesday, ..., 6=Sunday
start: 0..95 (00:00--23:45) an integer from 0-95, representing 15min slots
end: 1..96 (00:15--24:00); an integer from 0-95, representing 15min slots
start < end
For new entities, times will be set in the timezone of your users(i.e., "Local"). بالنسبة إلى الكيانات الحالية، لن يتم تغيير المنطقة الزمنية.

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

المنطقة الزمنية لاستهداف أوقات معيّنة من اليوممطلوبة عند تضمين "استهداف أوقات معيّنة من اليوم".سلسلةنعمالمنطقة الزمنية التي سيتم استخدامها لاستهداف أوقات معيّنة من اليوم
  • بالتوقيت المحلي
  • المعلِن
استهداف البيئةلاسلسلة أو قائمةنعمقائمة بالبيئات التي يجب استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة. يُرجى العِلم أنّه لا يمكن اختيار "غير محسّن للويب" بدون اختيار "الويب".
  • الويب
  • غير محسّنة على الويب
  • تطبيق
تفعيل استهداف Omid لإمكانية العرضلاسلسلةنعميتيح هذا الخيار استهداف مرات الظهور القابلة للقياس فقط من خلال معيار القياس المفتوح.
  • صواب
  • خطأ
استهداف إمكانية العرض في "العرض النشط"لاسلسلةنعمالنسب المئوية المستهدَفة لإمكانية العرض المتوقّعة يتم تمثيل النسب المئوية كأرقام عشرية. إحدى القيم {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
استهداف المواضع - العرض على الشاشةلاسلسلة أو قائمةنعماستهداف مواضع الإعلانات الظاهرة على الشاشة اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف المواضع - الفيديو على الشاشةلاسلسلة أو قائمةنعماستهداف مواضع إعلانات الفيديو على الشاشة اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف المواضع - موضع الإعلان الصوري في المحتوىلاسلسلة أو قائمةنعممواضع محتوى الإعلان الصوري التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • إعلان ضمن المقال
  • ضمن الخلاصة
  • In-Banner
  • إعلان بيني
  • غير معروف
استهداف المواضع - موضع الفيديو في المحتوىلاسلسلة أو قائمةنعممواضع محتوى إعلانات الفيديو التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • إعلان ضمن المقال
  • ضمن الخلاصة
  • In-Banner
  • إعلان بيني
  • إعلان خارج البث غير معروف
  • إعلان ما قبل التشغيل
  • إعلان أثناء التشغيل
  • إعلان ما بعد التشغيل
  • إعلان أثناء عرض الفيديو غير معروف
استهداف مواضع الإعلان - موضع الإعلان الصوتي في المحتوىلاسلسلة أو قائمةنعممواضع محتوى الإعلانات الصوتية التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • إعلان ما قبل التشغيل
  • إعلان أثناء التشغيل
  • إعلان ما بعد التشغيل
  • غير معروف
استهداف حجم مشغّل الفيديولاسلسلة أو قائمةنعمقائمة بأحجام مشغّل إعلانات الفيديو التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • غير معروف
  • صغير
  • كبير
  • الدقة العالية
استهداف مدة المحتوىلاسلسلة أو قائمةنعمقائمة بمدد المحتوى المطلوب استهدافه قيمة الوحدة هي دقائق. اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • 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 وما إذا كنت تريد تضمين الأسر التي لا يتوفّر عنها معلومات حول الدخل (صحيح/خطأ). اطّلِع على قائمة بنطاقات 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)
  • شبكة الجيل الرابع
استهداف شركات الجوّال - التضمينلاسلسلة أو قائمةنعم

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

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

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

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

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

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

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

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

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

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