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

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

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

يجب أن تكون الفترات الزمنية لتحديد عدد مرات الظهور 30 يومًا أو أقل.
شرائح ميزانية الحملةلاسلسلة، قائمة قوائمنعممجموعة شرائح الميزانية للحملة. تنسيق القائمة = (المعرّف؛ الاسم؛ النوع؛ المبلغ؛ تاريخ البدء؛ تاريخ الانتهاء؛ مصدر الميزانية الخارجية؛ معرّف الميزانية الخارجية؛ معرّف تجميع الفواتير؛ رمز عميل Prisma؛ رمز منتج Prisma؛ رمز تقدير Prisma؛ نوع Prisma؛ المورّد؛).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تصنيفات المحتوى الرقمي - الاستبعادلاسلسلة أو قائمةنعمقائمة بتصنيفات المحتوى الرقمي التي سيتم استبعادها. تنسيق القائمة = (G;PG; etc.).
  • 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}
استهداف المواضع - العرض على الشاشةلاسلسلة أو قائمةنعماستهداف مواضع الإعلانات الظاهرة على الشاشة اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف المواضع - الفيديو على الشاشةلاسلسلة أو قائمةنعماستهداف مواضع إعلانات الفيديو على الشاشة اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • الجزء المرئي من الصفحة
  • الجزء السفلي غير المرئي من الصفحة
  • غير معروف
استهداف المواضع - موضع الإعلان الصوري في المحتوىلاسلسلة أو قائمةنعممواضع محتوى الإعلان الصوري التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • إعلان ضمن المقال
  • ضمن الخلاصة
  • In-Banner
  • إعلان بيني
  • غير معروف
استهداف المواضع - موضع الفيديو في المحتوىلاسلسلة أو قائمةنعممواضع محتوى إعلانات الفيديو التي تريد استهدافها اختَر قيمة واحدة أو أكثر من القيم المقبولة:
  • إعلان ضمن المقال
  • ضمن الخلاصة
  • In-Banner
  • إعلان بيني
  • إعلان خارج البث غير معروف
  • إعلان ما قبل التشغيل
  • إعلان أثناء التشغيل
  • إعلان ما بعد التشغيل
  • إعلان أثناء عرض الفيديو غير معروف
استهداف مصدر المساحات الإعلانية - خيارات البائع المعتمَدمطلوبة عندما يكون "النوع" هو "إعلان مصوّر" أو "فيديو" أو "صوتي"سلسلةنعمإعداد لاستهداف البائعين المباشرين المعتمَدين أو البائعين المباشرين المعتمَدين والمورّدين أو البائعين المعتمَدين وغير المعروفين تعني "البيع المباشر المعتمَد" استهداف البائعين المعتمَدين فقط. يشير مصطلح "البائعون المباشرون والمورّدون المعتمَدون" إلى استهداف البائعين والمورّدين المعتمَدين. يشير الخيار "الناشر المعتمَد وغير المشارك" إلى أنّه سيستهدف البائعين والمورّدين المعتمَدين والبائعين غير المعروفين.
  • البائعون المباشرون المعتمَدون
  • البائعون المباشرون والمورّدون المعتمَدون
  • الناشر المعتمد وغير المشارك
استهداف مصدر المساحات الإعلانية - تضمينلاسلسلة أو قائمةنعم

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

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

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

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

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

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

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

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