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

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

الحقلحقل مطلوبالنوعقابل للكتابةالوصف
رقم تعريف الحملةمطلوب فقط عند تعديل الحملات الحاليةعدد صحيحلاقيمة المعرّف الرقمي للحملة. في حال ترك هذا الحقل فارغًا، سيتم إنشاء رقم تعريف حملة جديد وسيتم تخصيص رقم تعريف فريد. اختياريًا، عند إنشاء حملة جديدة، يمكنك استخدام معرّف مخصص لغرض تعيين طلبات الإدراج للحملة الجديدة. تنسيق المعرّف المخصّص هو "ext[المعرّف المخصص]"، على سبيل المثال، ext123. عند تحميل الملف ومعالجته، سيتم استبدال جميع المعرّفات المخصّصة بأرقام التعريف التي حدّدتها DBM وسيتم ربط العناصر (مثل طلب الإدراج بالحملة) استنادًا إلى المعرّفات المخصّصة.
رقم تعريف المعلننعمعدد صحيحلاقيمة المعرّف الرقمي للمعلن. يجب أن يكون رقمًا تعريفيًا صالحًا للمعلِن.
الاسمنعمسلسلةنعماسم الإدخال.
الطابع الزمنيمطلوب عند تعديل الإدخالات الحاليةعدد صحيحلاالطابع الزمني للإدخال، ويستخدمه النظام للتحقق من أن الإدخال لم يتغير بين التنزيل والتحميل.
الحالةنعمسلسلةنعمإعداد حالة الإدخال.
  • نشِط
  • متوقفة مؤقتًا
  • محتوى من الأرشيف
هدف الحملةنعمسلسلةنعماختر أحد أهداف الحملات السارية:
  • رفع الوعي بعلامتي التجارية أو منتجي
  • زيادة الزيارات أو الإجراءات على الإنترنت
  • زيادة المبيعات التي تتم بلا إنترنت أو في المتجر
  • زيادة عمليات تثبيت التطبيق أو التفاعلات مع التطبيق
مؤشر الأداء الرئيسي لهدف الحملةنعمسلسلةنعماختر أحد مؤشرات الأداء الرئيسية السارية لهدف الحملة:
  • التكلفة لكل ألف ظهور
  • نسبة مرات الظهور القابلة للعرض
  • تكلفة مرة الظهور المسموعة والقابلة للعرض عند الاكتمال
  • تكلفة الإجراء
  • تكلفة النقرة
  • نسبة النقر إلى الظهور
  • غير ذلك
قيمة مؤشر الأداء الرئيسي لهدف الحملةنعمfloatنعمرقم موجب لمؤشر الأداء الرئيسي لهدف الحملة. بالنسبة إلى مؤشر الأداء الرئيسي «النسبة المئوية القابلة للعرض» لهدف الحملة، أدخِل القيمة بالنسبة المئوية لهذا الحقل، على سبيل المثال: سيتم إدخال 80% على هذا النحو: "80". بالنسبة لمؤشر الأداء الرئيسي 'الأخرى'، يُعد هذا الحقل وصفًا موجزًا للهدف.
أنواع تصميمات الإعلاناتنعمسلسلة، قائمةنعمقائمة بأنواع تصميمات الإعلانات التي تتوقّع استخدامها.
  • الشبكة الإعلانية
  • حملة فيديو
  • الصوت
ميزانية الحملةلاfloatنعممبلغ ميزانية موجب للحملة وهو دائمًا عدد عائم لمبلغ العملة بما أنه سيكون دائمًا ميزانية مالية. سيتم عرض العملات بعملة المعلِن بالوحدات العادية (وليس 1/1,000,000 وحدة عملة معيّنة).
تاريخ بدء الحملةنعمسلسلةنعمتاريخ بدء الحملة بالتنسيق MM/DD/YYYY HH:mm
تاريخ انتهاء الحملةلاسلسلةنعمتاريخ انتهاء الحملة بالتنسيق MM/DD/YYYY HH:mm
تم تفعيل التكرارنعمسلسلةنعميؤدي هذا الخيار إلى تفعيل/إيقاف ميزة تحديد عدد مرات الظهور المستندة إلى مرات الظهور في الحملة.
  • TRUE
  • FALSE
عدد المشاهدات الناتجة عن التردّد الصوتيمطلوب عندما يكون "تم تفعيل التكرار" "TRUE"عدد صحيحنعممبلغ عدد صحيح موجب لعدد مرات الظهور في عدد مرات ظهور معيّن، أي قيمة x في "عرض × عدد مرات الظهور على مدار فترة ص".
فترة التكرارمطلوب عندما يكون "تم تفعيل التكرار" "TRUE"سلسلةنعمتُستخدَم لتحديد وحدة الفترة الزمنية لتحديد عدد مرات الظهور.
  • الدقائق
  • ساعات العمل
  • الأيام
  • أسابيع
  • الأشهر
  • الفترة منذ الإنشاء
مقدار التكرارمطلوب عندما يكون "تم تفعيل التكرار" "TRUE"عدد صحيحنعمعدد صحيح موجب للطول الزمني لنوع فترة التكرار، أي قيمة y في "عرض × عدد مرات الظهور على مدار الفترة ص".
شرائح ميزانية الحملةلاسلسلة، قائمة من القوائمنعممجموعة شرائح ميزانية الحملة. تنسيق القائمة = (المعرِّف، الاسم، النوع، المبلغ، تاريخ البدء، تاريخ الانتهاء، مصدر الميزانية الخارجية، معرِّف الميزانية الخارجية، معرِّف تجميع الفواتير، رمز عميل Prisma، رمز منتج Prisma، رمز تقدير Prisma، نوع Prisma، المورّد؛).

    مثال '(; MyBudget; impression; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)' حيث لا يتمّ تقديم المعرّف وتاريخ الانتهاء.
    يتمّ عرض القيم المقبولة في الجدول التالي:

    اسم العَمودحقل مطلوبالوصف
    رقم التعريفلارقم التعريف الفريد لشريحة ميزانية الحملة. ويجب تقديمه عند تعديل شريحة ميزانية. وفي حال ترك هذا الحقل فارغًا، ستتم كتابة شريحة الميزانية على أنّها جديدة.
    الاسمنعمالاسم المعروض لشريحة ميزانية الحملة.
    النوعنعمنوع مبلغ الميزانية. القيم المقبولة هي:
    • المبلغ
    • مرات الظهور
    المبلغنعممبلغ ميزانية موجب لنوع الميزانية. قد يتمثّل هذا في قيمة ظهور عدد صحيح بسيط أو عدد عائم لمبلغ معيّن من العملة. ستظهر العملات بعملة المعلِن بالوحدات العادية (وليس 1/1,000,000 لكل وحدة عملة).
    Start Dateلاطابع زمني لتاريخ بدء عرض الإعلانات لشريحة الميزانية بالتنسيق MM/DD/YYYY HH:mm. ويتم تمثيل تاريخ بدء لم يتم ضبطه بقيمة حقل فارغة.
    تاريخ الانتهاءلاطابع زمني لتاريخ انتهاء عرض الإعلانات لشريحة الميزانية بالتنسيق MM/DD/YYYY HH:mm. ويتم تمثيل تاريخ انتهاء غير محدَّد بقيمة حقل فارغة.
    مصدر الميزانية الخارجيةنعممصدر شريحة الميزانية. القيم المقبولة هي:
    • لا ينطبق
    • Mediaocean
    معرّف الميزانية الخارجيةلشرائح الميزانية في Mediaocean فقطوفي حال ضبط هذه السياسة، ستتضمّن جميع مرات الظهور المعروضة ضمن شريحة الميزانية هذه هذا المعرّف في الفاتورة إذا اختار العميل الفوترة على مستوى شريحة الميزانية.
    معرّف تجميع الفواتيرلافي حال ضبط هذه السياسة، سيتم تجميع كل شرائح الميزانية التي تستخدِم معرِّف الميزانية الخارجية ومعرِّف تجميع الفواتير نفسهما في فاتورة واحدة إذا كان العميل قد فعّل الفوترة على مستوى شريحة الميزانية.
    رمز عميل Prismaلشرائح الميزانية في Mediaocean فقطلا يمكن الضبط إلا لشرائح الميزانية في Mediaocean. يتيح "مركز دفعات Google" البحث والفلترة في هذا الحقل.
    رمز منتج Prismaلشرائح الميزانية في Mediaocean فقطلا يمكن الضبط إلا لشرائح الميزانية في Mediaocean. يتيح "مركز دفعات Google" البحث والفلترة في هذا الحقل.
    رمز تقدير Prismaلشرائح الميزانية في Mediaocean فقطلا يمكن الضبط إلا لشرائح الميزانية في Mediaocean. يتيح "مركز دفعات Google" البحث والفلترة في هذا الحقل.
    نوع Prismaلشرائح الميزانية في Mediaocean فقطلا يمكن الضبط إلا لشرائح الميزانية في Mediaocean. نوع Prisma للمقطع. القيم المقبولة هي:
    • الشبكة الإعلانية
    • بحث
    • حملة فيديو
    • الصوت
    • الاجتماعية
    • رسوم
    مورّد Prismaلشرائح الميزانية في Mediaocean فقطلا يمكن الضبط إلا لشرائح الميزانية في Mediaocean. الكيان المخصّص لهذه الميزانية (DSP أو الموقع الإلكتروني أو غير ذلك)
استهداف الفئة الديمغرافية حسب الجنسلاسلسلة، قائمةنعمقائمة الأجناس المطلوب استهدافها. اختر قيمة أو أكثر من القيم المقبولة:
  • أنثى
  • ذكر
  • غير معروف
العمر في استهداف الفئات الديمغرافيةلاسلسلة، قائمةنعماستهداف فئة عمرية للمستخدم: يمكنك تحديد نطاق من/إلى عن طريق تحديد عمر واحد في الحقل "من" وعمر "إلى" واحد وما إذا كان سيتم تضمين صواب/خطأ لأعمار غير معروفة. راجِع قائمة الأعمار المقبولة من/إلى.
مثال 1: لاستهداف 18-55 وتضمين أعمار غير معروفة، حدِّد التنسيق التالي: {من; إلى ؛ تضمين صواب/خطأ غير معروف} = 18;55;صحيح؛
المثال 2: لاستهداف المستخدمين الذين تزيد أعمارهم عن 35 عامًا فقط واستبعاد الأعمار غير المعروفة، حدِّد ما يلي = 35;+;false;.
القيم المقبولة للقيمة:
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

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


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

استهداف الفئة الديمغرافية - الحالة الأبويةنعمسلسلة، قائمةنعمقائمة الحالات الأبوية المطلوب استهدافها. اختر قيمة أو أكثر من القيم المقبولة.
  • أحد الوالدين
  • ليس أحد الوالدين
  • غير معروف
الاستهداف الجغرافي - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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

قائمة اللغات المراد تضمينها في الاستهداف.

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

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

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

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

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

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

تصنيفات المحتوى الرقمي - استبعادلاسلسلة، قائمةنعمقائمة بتصنيفات المحتوى الرقمي المطلوب استبعادها تنسيق القائمة = (G;PG؛ إلخ.).
  • G
  • PG
  • T
  • المغرب
  • ?
إعدادات الحساسية لأمان العلامة التجاريةلاسلسلةنعماختر إعداد الحساسية لحظر المستودع استنادًا إلى موضوع المحتوى المحيط به.
  • عدم الحظر
  • استخدام عملية إثبات الملكية في "مدير الحملة 360"
  • استخدام خيار التخصيص
الإعدادات المخصّصة لأمان العلامة التجاريةمطلوب عندما يكون "الإعداد المخصّص لأمان العلامة التجارية" هو "استخدام مخصّص".سلسلة، قائمةنعمإذا كان إعداد حساسية أمان العلامة التجارية هو "استخدام مخصّص"، يجب تحديد قائمة مصنِّفات المحتوى العادية. على سبيل المثال، (الجنس؛الكحول؛التبغ؛ إلخ.).
  • محتوى جنسي
  • محتوى ازدرائي
  • عمليات التنزيل والمشاركة
  • الأسلحة
  • المقامرة
  • مشاهد عنيفة
  • محتوى موحي جنسيًا
  • اللغة النابية
  • الكحول
  • مخدرات
  • التبغ
  • السياسة
  • الدِّين
  • التراجيديا
  • حوادث النقل
  • القضايا الاجتماعية الحسّاسة
  • محتوى صادم
خدمات التحقق من الجهات الخارجيةلاسلسلةنعممقدم خدمات إثبات الملكية من طرف ثالث.
  • لا ينطبق
  • Integral Ad Science
  • DoubleVerify
  • Adloox
تصنيفات التحقّق التابعة لجهات خارجيةلاسلسلة، قائمةنعمإذا لم تكن خدمات التحقُّق التابعة لجهة خارجية هي "لا شيء"، حدِّد قائمة من التصنيفات التي يتيحها مقدِّم الخدمة المحدَّد.
إمكانية العرض التي تستهدف العرض النشطلاسلسلةنعماستهداف النسب المئوية لإمكانية العرض المتوقّعة. يتم تمثيل النسب المئوية على شكل أعداد عشرية. واحد من {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
استهداف الموضع - الشبكة الإعلانية على الشاشةلاسلسلة، قائمةنعماستهداف مواضع الإعلانات الصورية على الشاشة. اختر قيمة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف الموضع - الفيديو على الشاشةلاسلسلة، قائمةنعماستهداف مواضع إعلانات الفيديو على الشاشة. اختر قيمة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف الموضع - موضع العرض في المحتوىلاسلسلة، قائمةنعممواضع محتوى الإعلان الصوري المطلوب استهدافها. اختر قيمة أو أكثر من القيم المقبولة:
  • ضمن المقالة
  • إعلان ضمن الخلاصة
  • إعلان ضمن البانر
  • إعلان بيني
  • غير معروف
استهداف الموضع - موضع الفيديو في المحتوىلاسلسلة، قائمةنعممواضع محتوى إعلان الفيديو المطلوب استهدافها. اختر قيمة أو أكثر من القيم المقبولة:
  • ضمن المقالة
  • إعلان ضمن الخلاصة
  • إعلان ضمن البانر
  • إعلان بيني
  • البث خارج البث غير معروف
  • قبل التشغيل
  • أثناء التشغيل
  • ما بعد التشغيل
  • إعلان غير معروف أثناء البث
استهداف مصدر المستودع - خيارات البائعين المعتمَدينمطلوب عندما يكون "النوع" هو "العرض" أو "الفيديو" أو "الصوت"سلسلةنعمالإعداد لاستهداف البائعين المباشرين المعتمَدين أو البائعِين المباشرين المعتمَدين أو المورِّدين المعتمَدين أو البائعِين المعتمَدِين + غير معروف تعني عبارة "البيع المباشر المعتمَد" أنّه سيتم استهداف البائعين المعتمَدين فقط. يعني "البائعون والمورِّدون المعتمَدون مباشرةً" استهداف البائعين والمورِّدين المعتمَدين. "الناشر المعتمد وغير المشارك" يُقصد به أنه سيستهدف البائعين المعتمَدين والموردين والبائعين غير المعروفين.
  • البائعون المباشرون المعتمَدون
  • المورّدون والبائعون المباشرون المعتمَدون
  • ناشر معتمد وغير مشارك
استهداف مصدر المستودع - تضمينلاسلسلة، قائمةنعم

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

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

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

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

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

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

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

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