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

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

الحقلمطلوبالنوعقابل للكتابةالوصف
معرّف Ioمطلوب فقط عند تعديل طلبات الإدراج الحاليةعدد صحيحلاقيمة المعرّف الرقمي لطلب الإدراج. إذا تُرك هذا الحقل فارغًا، سيتم إنشاء معرّف جديد لأمر الإدراج وسيتم تعيين معرّف فريد. اختياريًا، عند إنشاء "طلب إدراج" جديد، يمكنك استخدام معرّف مخصّص لغرض تعيين "بنود إعلانية" لطلب الإدراج الجديد. تنسيق المعرّف المخصّص هو "ext[المعرّف المخصّص]"، على سبيل المثال ext123. عند تحميل الملف ومعالجته، سيتم استبدال جميع المعرّفات المخصّصة بالمعرّفات التي يحدّدها "مدير حملة DoubleClick"، وسيتم ربط العناصر (على سبيل المثال، البند في قائمة الأسعار بطلب الإدراج) استنادًا إلى المعرّفات المخصّصة.
رقم تعريف الحملةلاعدد صحيحلاقيمة رقم تعريف الحملة. يمكنك تحديد معرّف مخصّص (على سبيل المثال، "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 يومًا أو أقل.
نوع مؤشر الأداء الرئيسينعمسلسلةنعموحدة مؤشر الأداء الرئيسي لطلب الإدراج
  • التكلفة لكل ألف ظهور
  • التكلفة لكل إجراء
  • تكلفة النقرة
  • انخفاض في تكلفة المشاهدة
  • تكلفة مرة الظهور المسموعة والقابلة للعرض عند الاكتمال
  • CTR
  • نسبة إمكانية العرض
  • التكلفة لكل اشتراك
  • معدل الإحالات الناجحة لكل نقرة
  • معدل الإحالات الناجحة لكل مرة ظهور
  • VCPM
  • زيادة في نسبة المشاهدات المكتملة
  • معدل الاستماع إلى الملف الصوتي بالكامل
  • معدّل مشاهدة الفيديو بالكامل
  • تكلفة الاستماع المكتمل
  • تكلفة المشاهدة المكتملة
  • TOS10
  • زيادة معدّل تسجيل مرات الظهور إلى أقصى حد
  • تكلفة/قيمة مرات الظهور المخصصة
  • بدون
  • غير ذلك
قيمة مؤشر الأداء الرئيسينعمسلسلةنعمقيمة مؤشر الأداء الرئيسي بالعملة (التكلفة لكل ألف ظهور، والتكلفة لكل إجراء، وتكلفة النقرة، وتكلفة المشاهدة، وتكلفة المشاهدة لكل مستخدم، وتكلفة التفاعل، والتكلفة لكل ألف ظهور قابل للعرض)، أو بالنسبة المئوية (نسبة إمكانية العرض، ونسبة النقر إلى الظهور، ونسبة الإحالات الناجحة للنقرات، ونسبة الإحالات الناجحة لمرّات الظهور، ونسبة مشاهدة الفيديو، ونسبة الإحالات الناجحة للصوت، ونسبة الإحالات الناجحة للفيديو، وتكلفة النقرة لكل مستمع، وتكلفة النقرة لكل مستخدم صوت، ونسبة إكمال الفيديو بنسبة %10)، أو بدون وحدة (قيمة مرات الظهور المخصّصة / التكلفة)، أو كسلسلة (أخرى). إذا كان نوع مؤشر الأداء الرئيسي المقدَّم هو "زيادة سرعة عرض الإعلانات إلى أقصى حد" أو "بلا"، سيتم تجاهل هذا العمود.
معرّف خوارزمية مؤشر الأداء الرئيسيمطلوب عندما يكون "نوع مؤشر الأداء الرئيسي" هو "تكلفة / قيمة مرات الظهور المخصّصة"عدد صحيحنعممعرّف خوارزمية عروض الأسعار المخصّصة المرتبط بمؤشر الأداء الرئيسي إذا كان نوع مؤشر الأداء الرئيسي هو CUSTOM_BIDDING_VALUE_COST، وإلا سيتم تجاهل هذا العمود.
نوع الميزانيةنعمسلسلةنعمتحدّد هذه السمة نوع الميزانية من حيث مبلغ "الأرباح" المطلوب إنفاقه (المبلغ) أو عدد مرّات الظهور المطلوب شراؤها (مرّات الظهور).
  • المبلغ
  • مرات الظهور
شرائح الميزانيةنعمسلسلة، قائمة قوائمنعمتحدّد هذه السمة شرائح الميزانية المحدّدة. تنسيق القائمة = (الميزانية، تاريخ البدء، تاريخ الانتهاء، رقم تعريف ميزانية الحملة، الوصف). تكون الميزانية بتنسيق العملة العائم. تكون التواريخ بالتنسيق شهر/يوم/سنة. يكون رقم تعريف ميزانية الحملة فارغًا إذا لم يتم تحديده. يجب ألا يكون الوصف فارغًا لأي من شرائح الميزانية. إذا كانت إحدى شرائح الميزانية الحالية تتضمّن وصفًا فارغًا، يجب تقديم وصف للصف ليتم تحميله. مثال: "(100.50;01/01/2016;03/31/2016;12345;budget segment 1;);(200.00;04/01/2016;06/30/2016;;updated budget segment 1;);"
التخصيص التلقائي للميزانيةنعمسلسلةنعمتفعيل/إيقاف التخصيص التلقائي للميزانية
  • صواب
  • خطأ
تحسين طلب الإدراجنعمسلسلةنعم

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

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

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

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

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