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

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

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

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

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

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

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

لا يتوافق وضع "في أقرب وقت ممكن" مع وتيرة "الطيران".
مبلغ الوتيرةنعمعدد عائمنعمالمبلغ الذي سيتم إنفاقه خلال الفترة الزمنية التي يحدّدها نوع الوتيرة.
تم تفعيل الترددنعمسلسلةنعمتفعيل/إيقاف ميزة تحديد عدد مرّات الظهور المستندة إلى مرّات الظهور في طلب الإدراج
  • صواب
  • خطأ
مرّات الظهور حسب معدّل التكرارمطلوب عندما تكون قيمة "تفعيل التكرار" هي "صحيح"عدد صحيحنعمعدد صحيح موجب لعدد مرّات الظهور في عدد مرّات ظهور معيّن، أي x في "عرض x مرّات ظهور خلال فترة y".
فترة عدد مرّات الظهورمطلوبة عندما تكون قيمة "عدد مرّات الظهور مفعّل" هي "صحيح"سلسلةنعمتحدّد وحدة الفترة الزمنية لعدد مرّات الظهور.
  • الدقائق
  • ساعات
  • الأيام
  • أسابيع
  • الأشهر
  • الفترة منذ الإنشاء
عدد مرّات الظهورمطلوب عندما تكون قيمة "تفعيل التكرار" هي "صحيح"عدد صحيحنعمعدد صحيح موجب لمدة نوع "فترة تكرار"، أي المدة y في "عرض x مرّات ظهور خلال مدة 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 في Display & Video 360 API لنوع الاستهداف TARGETING_TYPE_GEO_REGION.

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

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

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

يستخدم هذا العمود أرقام تعريف الموارد TargetingOption في Display & Video 360 API لنوع الاستهداف 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., واشنطن العاصمة، الولايات المتحدة الأمريكية؛); (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 في Display & Video 360 API لنوع الاستهداف 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 واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" لأنواع الاستهداف التالية:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

تنسيق القائمة = (TargetingOption.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"
  • استخدام درجات الحرارة المخصّصة
الإعدادات المخصّصة لأمان العلامة التجاريةمطلوب عندما يكون "الإعداد المخصّص لأمان العلامة التجارية" هو "استخدام إعداد مخصّص".سلسلة، قائمةنعمإذا كان إعداد حساسية أمان العلامة التجارية هو "استخدام إعداد مخصّص"، حدِّد قائمة المصنّفات العادية للمحتوى. على سبيل المثال، (محتوى جنسي أو كحول أو تبغ أو غير ذلك).
  • محتوى جنسي
  • ازدرائي
  • عمليات التنزيل والمشاركة
  • الأسلحة
  • المقامرة
  • عنف
  • محتوى موحي جنسيًا
  • اللغة النابية
  • الكحول
  • مخدرات
  • التبغ
  • السياسة
  • الديانة
  • التراجيديا
  • حوادث النقل
  • المشاكل الاجتماعية الحساسة
  • محتوى صادم
خدمات التحقُّق التابعة لجهات خارجيةلاسلسلةنعممقدّم خدمات إثبات الملكية التابع لجهة خارجية
  • لا ينطبق
  • Integral Ad Science
  • DoubleVerify
  • Adloox
تصنيفات إثبات الملكية من خلال جهة خارجيةلاسلسلة، قائمةنعمإذا لم يكن خيار "خدمات إثبات الهوية التابعة لجهات خارجية" هو "بدون"، حدِّد قائمة بالتصنيفات المتوافقة مع مقدّم الخدمة المحدّد.
استهداف القنوات - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

قائمة بالمواقع الإلكترونية المطلوب تضمينها في الاستهداف القائمة هي سلاسل من عناوين 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 في Display & Video 360 API لنوع الاستهداف TARGETING_TYPE_APP_CATEGORY.

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

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

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

يستخدم هذا العمود أرقام تعريف الموارد TargetingOption في Display & Video 360 API لنوع الاستهداف 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 API لنوع الاستهداف TARGETING_TYPE_CONTENT_GENRE.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى قوائم جمهور الطرف الأول، يتم إدراج كل شريحة جمهور كزوج من FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId وإعداد "الحداثة". الزوج هو (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 يومًا
  • 120 يومًا
  • 180 يومًا
  • 270 يومًا
  • 365 يومًا
استهداف الجمهور - استبعادلاسلسلة، قائمة الأزواجنعم

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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












"المحلية"). بالنسبة إلى الكيانات الحالية، لن يتم تغيير المنطقة الزمنية.

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

المنطقة الزمنية لاستهداف فترات اليوممطلوب عند تضمين "استهداف فترات اليوم".سلسلةنعمالمنطقة الزمنية المستخدَمة لاستهداف وقت اليوم
  • بالتوقيت المحلي
  • المعلِن
استهداف البيئةلاسلسلة، قائمةنعمقائمة البيئات المستهدفة اختَر قيمة واحدة أو أكثر من القيم المقبولة. يُرجى العلم أنّه لا يمكن اختيار "الويب غير محسّن" بدون اختيار "الويب".
  • الويب
  • غير محسّنة على الويب
  • تطبيق
تم تفعيل ميزة "استهداف 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
  • +
استهداف الفئات الديمغرافية حسب دخل الأسرةلاسلسلة، قائمةنعماستهدِف نطاقًا لدخل الأسرة. حدِّد نطاقًا من/إلى من خلال اختيار نطاق دخل 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)
  • شبكة الجيل الرابع
استهداف شركات الجوّال - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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