يُرجى الاطّلاع على النظرة العامة للحصول على شرح حول التنسيق.
| الحقل | مطلوب | النوع | قابل للكتابة | الوصف | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| رقم تعريف طلب الإدراج | مطلوب فقط عند تعديل طلبات الإدراج الحالية | عدد صحيح | لا | القيمة الرقمية لمعرّف طلب الإدراج. إذا تم ترك هذا الحقل فارغًا، سيتم إنشاء معرّف جديد لطلب الإدراج وسيتم تعيين معرّف فريد. يمكنك اختياريًا استخدام معرّف مخصّص عند إنشاء طلب إدراج جديد بغرض تعيين بنود الإعلان لطلب الإدراج الجديد. تنسيق المعرّف المخصّص هو "ext[المعرّف المخصّص]"، مثلاً ext123. عند تحميل الملف ومعالجته، سيتم استبدال جميع المعرّفات المخصّصة بمعرّفات يحدّدها "مساحة العرض والفيديو 360" وسيتم ربط العناصر (مثلاً، بند الإعلان بطلب الإدراج) استنادًا إلى المعرّفات المخصّصة. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| رقم تعريف الحملة | لا | عدد صحيح | لا | القيمة الرقمية لمعرّف الحملة. يمكنك تحديد معرّف مخصّص (مثلاً، "ext[معرّف الحملة المخصّص]") لحملة تنشئها في الوقت نفسه الذي تنشئ فيه طلب الإدراج هذا. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| الاسم | نعم | سلسلة | نعم | اسم الإدخال. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| الطابع الزمني | مطلوب عند تعديل الإدخالات الحالية | عدد صحيح | لا | الطابع الزمني للإدخال، ويستخدمه النظام للتأكّد من عدم تغيير الإدخال بين التنزيل والتحميل. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| الحالة | نعم | سلسلة | نعم | إعداد الحالة للإدخال.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| نوع طلب الإدراج | نعم | سلسلة | نعم | نوع طلب الإدراج. لا يمكن ضبط هذا الحقل إلا عند الإنشاء.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| النوع الفرعي لطلب الإدراج | نعم | سلسلة | نعم | الحقل مطلوب لطلبات الإدراج للتمييز بين التنسيقات المختلفة. إذا تم ترك الحقل فارغًا، سيتم استخدام القيمة "تلقائي".
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| هدف طلب الإدراج | نعم | سلسلة | نعم | هدف طلب الإدراج. هذا الحقل في مرحلة تجريبية ولا يتوفّر حاليًا إلا للعملاء المشاركين. سيكون هذا العمود فارغًا دائمًا للعملاء غير المشاركين في الإصدار التجريبي.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| الرسوم | لا | سلسلة، قائمة قوائم | نعم | جميع الرسوم لهذا الإدخال. تنسيق القائمة = (فئة الرسم، مبلغ الرسم، نوع الرسم، تم تقديم فاتورة،).
مثال: '(CPM; 2; رسوم "مساحة العرض والفيديو 360"؛ خطأ)؛ (الوسائط؛ 13؛ تلقائي؛ صواب)؛'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| شفرة الدمج | لا | سلسلة | نعم | رمز اختياري لأغراض التتبُّع. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| التفاصيل | لا | سلسلة | نعم | تفاصيل الإدخال بتنسيق سلسلة. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| تعديل الفيديو | نعم | سلسلة | نعم | الفترة الزمنية المستخدَمة لإنفاق مبلغ تعديل الفيديو.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| معدّل تعديل الفيديو | نعم | سلسلة | نعم | معدّل تعديل الفيديو لهذا الإدخال.
لا يتوافق "في أقرب وقت ممكن" مع تعديل الفيديو "مدّة عرض الإعلانات". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| مبلغ تعديل الفيديو | نعم | float | نعم | المبلغ المطلوب إنفاقه لكل فترة زمنية يحدّدها نوع تعديل الفيديو. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| تفعيل تحديد عدد مرات الظهور | نعم | سلسلة | نعم | تفعيل/إيقاف تحديد عدد مرات الظهور المستند إلى مرّات الظهور في طلب الإدراج.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| عدد مرات الظهور | مطلوب عندما تكون قيمة "تفعيل تحديد عدد مرات الظهور" هي "صواب" | عدد صحيح | نعم | عدد صحيح موجب لعدد مرّات الظهور في "مبلغ التكرار" معيّن، أي القيمة x في "عرض x مرّات ظهور خلال الفترة الزمنية y". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| الفترة الزمنية للتكرار | مطلوب عندما تكون قيمة "تفعيل تحديد عدد مرات الظهور" هي "صواب" | سلسلة | نعم | تحديد وحدة الفترة الزمنية لتحديد عدد مرات الظهور.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| مبلغ التكرار | مطلوب عندما تكون قيمة "تفعيل تحديد عدد مرات الظهور" هي "صواب" | عدد صحيح | نعم | عدد صحيح موجب لطول الفترة الزمنية لنوع "الفترة الزمنية للتكرار"، أي القيمة y في "عرض x مرّات ظهور خلال الفترة الزمنية y". يجب ألا تزيد الفترات الزمنية لتحديد عدد مرات الظهور عن 30 يومًا. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| نوع مؤشر الأداء الرئيسي | نعم | سلسلة | نعم | وحدة مؤشر الأداء الرئيسي لطلب الإدراج
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| قيمة مؤشر الأداء الرئيسي | نعم | سلسلة | نعم | قيمة مؤشر الأداء الرئيسي بالعملة (التكلفة لكل ألف ظهور، التكلفة لكل إجراء، تكلفة النقرة، انخفاض في تكلفة المشاهدة، تكلفة مرة الظهور المسموعة والقابلة للعرض عند الاكتمال، التكلفة لكل اشتراك، VCPM)، أو النسبة المئوية (نسبة إمكانية العرض، CTR، معدل الإحالات الناجحة لكل نقرة، معدل الإحالات الناجحة لكل مرة ظهور، زيادة في نسبة المشاهدات المكتملة، معدل الاستماع إلى الملف الصوتي بالكامل، معدّل مشاهدة الفيديو بالكامل، تكلفة الاستماع المكتمل، تكلفة المشاهدة المكتملة، الوقت المستغرق على الشاشة 10 ثوانٍ)، أو بدون وحدة (تكلفة / قيمة مرات الظهور المخصصة)، أو كسلسلة (غير ذلك). إذا كان نوع مؤشر الأداء الرئيسي المقدَّم هو "زيادة معدّل تسجيل مرات الظهور إلى أقصى حد" أو "بدون"، يتم تجاهل هذا العمود. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| رقم تعريف خوارزمية مؤشر الأداء الرئيسي | مطلوب عندما يكون "نوع مؤشر الأداء الرئيسي" هو "تكلفة / قيمة مرات الظهور المخصصة" | عدد صحيح | نعم | رقم تعريف خوارزمية عروض الأسعار المخصّصة المرتبطة بمؤشر الأداء الرئيسي إذا كان نوع مؤشر الأداء الرئيسي هو CUSTOM_BIDDING_VALUE_COST. وإلّا، يتم تجاهل هذا العمود. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| نوع الميزانية | نعم | سلسلة | نعم | تحديد نوع الميزانية من حيث مبلغ "الإيرادات" المطلوب إنفاقه (المبلغ) أو عدد مرّات الظهور (مرّات الظهور) المطلوب شراؤها.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| شرائح الميزانية | نعم | سلسلة، قائمة قوائم | نعم | تحديد شرائح الميزانية المحدّدة. تنسيق القائمة = (الميزانية، تاريخ البدء، تاريخ الانتهاء، رقم تعريف ميزانية الحملة، الوصف). الميزانية بتنسيق عدد عائم للعملة. التواريخ بتنسيق شهر/يوم/سنة. يكون رقم تعريف ميزانية الحملة فارغًا إذا لم يتم تحديده. لا يمكن أن يكون الوصف فارغًا لأي شرائح ميزانية. إذا كانت شريحة ميزانية حالية تتضمّن وصفًا فارغًا، يجب تقديم وصف للصف ليتم تحميله. مثال: "(100.50;01/01/2016;03/31/2016;12345;شريحة الميزانية 1;);(200.00;04/01/2016;06/30/2016;;شريحة الميزانية 1 المعدَّلة;);" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| التخصيص التلقائي للميزانية | نعم | سلسلة | نعم | تفعيل/إيقاف التخصيص التلقائي للميزانية
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| تحسين طلب الإدراج | نعم | سلسلة | نعم | تفعيل/إيقاف تحسين طلب الإدراج إذا تم ضبط هذا العمود على "صواب"، ستستخدِم بنود الإعلان ضمن طلب الإدراج هذا استراتيجية عروض الأسعار الخاصة بطلب الإدراج.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| وحدة استراتيجية عروض الأسعار | مطلوب عندما تكون قيمة "تحسين طلب الإدراج" هي "صواب" | سلسلة | نعم | اختيار وحدة استراتيجية عروض الأسعار لتحسين عروض الأسعار:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| استراتيجية عروض الأسعار "عدم تجاوز" | مطلوب عندما تكون قيمة "تحسين طلب الإدراج" هي "صواب" | float | نعم | ضبط قيمة "عدم تجاوز" للتكلفة لكل ألف ظهور. إذا كانت القيمة 0، لا يتم تفعيل "عدم تجاوز". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| تطبيق الحد الأدنى لعرض السعر على الصفقات | مطلوب عندما تكون قيمة "تحسين طلب الإدراج" هي "صواب" | سلسلة | نعم | تحديد ما إذا كان يجب إعطاء الأولوية للصفقات على المساحة الإعلانية في المزاد المفتوح
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| رقم تعريف الخوارزمية | مطلوب عندما تكون "وحدة استراتيجية عروض الأسعار" هي "قيمة مرات الظهور المخصّصة/التكلفة" | عدد صحيح | نعم | يجب استخدام رقم تعريف الخوارزمية المقابل هذا عندما يتم ضبط "وحدة استراتيجية عروض الأسعار" على "قيمة مرات الظهور المخصّصة/التكلفة". يجب تضمين أيّ أنشطة في Floodlight مستخدَمة في الخوارزمية المعيّنة لهذا العمود في عمود "أرقام تعريف أنشطة الإحالات الناجحة في Floodlight". ستؤدي محاولات تعيين خوارزمية بدون تعديل عمود "أرقام تعريف أنشطة الإحالات الناجحة في Floodlight" بشكلٍ صحيح إلى حدوث خطأ. |