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

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

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

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

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

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

لا يتوافق وضع "في أقرب وقت ممكن" مع وتيرة "الطيران".
مبلغ الوتيرةنعمعدد عائمنعمالمبلغ المطلوب إنفاقه لكل فترة زمنية يحددها نوع مستوى السرعة.
تم تفعيل الترددنعمسلسلةنعميفعِّل/يوقف تحديد عدد مرات الظهور المستند إلى مرات الظهور في طلب الإدراج.
  • صواب
  • خطأ
مرّات الظهور حسب معدّل التكرارمطلوبة عندما تكون قيمة "عدد مرّات الظهور مفعّل" هي "صحيح"عدد صحيحنعمعدد صحيح موجب لعدد مرّات الظهور في عدد مرّات ظهور معيّن، أي x في "عرض x مرّات ظهور خلال فترة y".
فترة عدد مرّات الظهورمطلوب عندما تكون قيمة "تفعيل التكرار" هي "صحيح"سلسلةنعمتحدّد وحدة الفترة الزمنية لعدد مرّات الظهور.
  • الدقائق
  • ساعات
  • الأيام
  • أسابيع
  • الأشهر
  • الفترة منذ الإنشاء
عدد مرّات الظهورمطلوبة عندما تكون قيمة "عدد مرّات الظهور مفعّل" هي "صحيح"عدد صحيحنعمعدد صحيح موجب لطول الفترة الزمنية لنوع "فترة التكرار"، أي أن y في "إظهار س عدد مرات الظهور على مدار ص".
نوع مؤشر الأداء الرئيسينعمسلسلةنعموحدة مؤشر الأداء الرئيسي لطلب الإدراج
  • التكلفة لكل ألف ظهور
  • تكلفة الإجراء
  • تكلفة النقرة
  • تكلفة تشغيل الفيديو
  • تكلفة مرة الظهور المسموعة والقابلة للعرض عند الاكتمال
  • نسبة النقر إلى الظهور
  • نسبة إمكانية العرض
  • التكلفة لكل اشتراك
  • معدل الإحالات الناجحة لكل نقرة
  • معدل الإحالات الناجحة لكل مرة ظهور
  • VCPM
  • معدل الإحالة الناجحة بعد رؤية الإعلان فقط
  • معدل الاستماع إلى الملف الصوتي بالكامل
  • معدّل مشاهدة الفيديو بالكامل
  • تكلفة الاستماع المكتمل
  • تكلفة المشاهدة المكتملة
  • TOS10
  • زيادة معدّل تسجيل مرات الظهور إلى أقصى حد
  • تكلفة/قيمة مرات الظهور المخصصة
  • لا ينطبق
  • غير ذلك
قيمة مؤشر الأداء الرئيسينعمسلسلةنعمقيمة مؤشر الأداء الرئيسي بعملة معيّنة (التكلفة لكل ألف ظهور أو تكلفة الإجراء أو تكلفة النقرة أو تكلفة المشاهدة أو تكلفة المشاهدة لكل ألف ظهور أو تكلفة التفاعل أو تكلفة المشاهدة لكل ألف ظهور قابل للعرض) أو كنسبة مئوية (نسبة العرض القابل للقياس أو نسبة النقر إلى الظهور أو معدّل الإحالات الناجحة الناتجة عن النقر أو معدّل الإحالات الناجحة الناتجة عن مرّات الظهور أو معدّل مشاهدة الفيديو أو معدّل الإحالات الناجحة الناتجة عن الصوت أو معدّل الإحالات الناجحة الناتجة عن الفيديو أو تكلفة النقرة لكل ألف ظهور أو تكلفة الإجراء لكل ألف ظهور أو TOS10) أو بدون وحدة (قيمة مرّة الظهور المخصّصة / التكلفة) أو كسلسلة (غير ذلك). وإذا كان نوع مؤشر الأداء الرئيسي المقدَّم هو "زيادة وتيرة السرعة إلى أقصى حد" أو "بدون"، سيتم تجاهل هذا العمود.
رقم تعريف خوارزمية مؤشرات الأداء الرئيسيةمطلوب عندما يكون "نوع مقياس الأداء الرئيسي" هو "تكلفة / قيمة مرّات الظهور المخصّصة"عدد صحيحنعمرقم تعريف خوارزمية عروض الأسعار المخصّصة المرتبطة بمقياس الأداء الرئيسي إذا كان نوع مقياس الأداء الرئيسي هو CUSTOM_BIDDING_VALUE_COST. وبخلاف ذلك، يتم تجاهل هذا العمود.
قياس معدّل الوصول إلى الجمهورنعمسلسلةنعمتفعيل/إيقاف قياس الجمهور باستخدام تقييمات الإعلانات الرقمية من Nielsen
  • صواب
  • خطأ
قياس قناة DARمطلوبة عندما تكون قيمة "قياس DAR" هي "صحيح"عدد صحيحنعم

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

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

التنسيق = Channel.channelId

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

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

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

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

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

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

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

تنسيق القائمة = (TargetOption.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., العاصمة، الولايات المتحدة الأمريكية، (40.712775؛ -74.005972؛ 20.5؛ كم؛ 40.712775، -74.005972؛)؛ (20.000234؛ -56.675423؛ 5.0؛ ميل؛ ؛).
استهداف قائمة المواقع الجغرافية القريبةلاسلسلة، قائمة قوائمنعمقائمة باستهدافات قائمة المواقع الجغرافية القريبة لطلبات الإدراج أو العناصر غير التابعة لشبكة Google الإعلانية، وكلّ منها بالتنسيق "(ProximityListId; Radius; Unit; );". ProximityListId هو رقم تعريف قائمة مواقع جغرافية ضمن موارد المعلِن. النطاق الجغرافي هو مسافة تتراوح بين 1 و500 (شاملة) في الوحدة، ويمكن أن تكون الوحدة "ميل" أو "كيلومتر". وهناك حدّ أقصى لاستهداف قائمتَي مواقع جغرافية لكلّ كيان، بالإضافة إلى قوائم المواقع الجغرافية الإقليمية. على سبيل المثال: "(10041691678; 20.0; mi;); (10038858567; 20.5; km;);".
استهداف اللغة - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تنسيق القائمة = (TargetOption.targetingOptionId; TargetOption.targetingOptionId; وغيرها).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى قوائم مستخدمي الطرف الأول، يتم إدراج كل شريحة جمهور كزوج من إعدادات FirstAndParty Audience.firstAndThirdPartyId وإعداد مدى الحداثة. يتمثل الزوج في (1؛1d؛)، حيث يشير 1d إلى عيّنة من معدّل تكرار الظهور خلال يوم واحد. لا تتوفّر سمة "الحداثة" للجماهير التابعة لجهات خارجية، لذا يكون تنسيق القائمة على النحو التالي: (3;);(4;);. بالنسبة إلى المجموعتَين "و" و"أو" من الجماهير، اتّبع هذا المثال: للجمع بين أزواج من الجماهير سواء مع حداثة أو بدون حداثة: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. وهذا يعني (القائمة 1 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال يوم واحد أو القائمة 2 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال 365 يومًا) و (القائمة 3 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال فترة غير محدّدة أو القائمة 4 التي تتضمّن بيانات المستخدمين الذين أجروا عملية بحث خلال 5 دقائق أو القائمة 5 التي تتضمّن بيانات جميع المستخدمين).

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

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

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

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

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

تنسيق القائمة = ((FirstAndParty Audience.firstAndThirdPartyResourceId; recency violation;)؛ (FirstAndThirdPartyAudiences.firstAndPartyPartyId; recency متخصّص;);)
مثال: "(1;1d;);(2;)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

base_dayparting_id = 300000
days_since_monday: 0=Monday, 1=Tuesday, ..., 6=Sunday
start: 0..95 (00:00--23:45) عدد صحيح من 0 إلى 95 يمثّل خانات مدتها 15 دقيقة
end: 1..96 (00:15--24:00) عدد صحيح من 0 إلى 95 يمثّل خانات مدتها 15 دقيقة
start < end
بالنسبة إلى الكيانات الجديدة، سيتم ضبط الأوقات حسب المنطقة الزمنية للمستخدمين(أي "المحلية"). بالنسبة إلى الكيانات الحالية، لن يتم تغيير المنطقة الزمنية.

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

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

القيم المقبولة لسمة "إلى":
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
استهداف الفئة الديمغرافية لدخل الأسرةلاسلسلة، قائمةنعماستهدِف نطاقًا لدخل الأسرة. حدد نطاق من/إلى عن طريق تحديد نطاق دخل واحد أعلى_of_Range ونطاق دخل واحد سفلي_من_نطاق_نطاق دخل واحد وما إذا كان سيتم تضمين الأسر ذات دخل غير معروف صواب/خطأ.


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

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

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

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

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

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

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

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

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

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