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

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

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


اعتبارًا من 28 شباط (فبراير) 2025، لن يتم قبول الفترات الزمنية لتحديد عدد مرّات الظهور التي تزيد عن 30 يومًا. سيؤدي محاولة ضبط "المدة" على هذا العمود إلى ظهور خطأ.
عدد مرّات الظهورمطلوبة عندما تكون قيمة "عدد مرّات الظهور مفعّل" هي "صحيح"عدد صحيحنعمعدد صحيح موجب لمدة نوع "فترة تكرار"، أي القيمة y في "عرض x مرّات ظهور على مدار y فترة".

اعتبارًا من 28 شباط (فبراير) 2025، لن يتم قبول الفترات الزمنية لعدد مرّات الظهور ضمن الحدّ الأقصى لعدد مرّات الظهور التي تزيد عن 30 يومًا. سيؤدي محاولة ضبط القيمة 2 أو أكثر لهذا العمود عند ضبط "أشهر" على عمود "فترة التكرار" إلى ظهور خطأ.
شرائح ميزانية الحملةلاسلسلة، قائمة قوائمنعممجموعة شرائح الميزانية للحملة. تنسيق القائمة = (الرقم التعريفي؛ الاسم؛ النوع؛ المبلغ؛ تاريخ البدء؛ تاريخ الانتهاء؛ مصدر الميزانية الخارجية؛ رقم تعريف الميزانية الخارجية؛ رقم تعريف تجميع الفواتير؛ رمز عميل 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. يتم تمثيل تاريخ البدء غير المحدّد بقيمة حقل فارغة.
    تاريخ الانتهاءلاطابع زمني لتاريخ انتهاء عرض الإعلانات لشريحة الميزانية بالتنسيق 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 واحد وما إذا كان سيتم تضمين الأسر ذات الدخل غير المعروف (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%

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

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

يستخدم هذا العمود أرقام تعريف الموارد 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; إلخ). يتم إنشاء هذه القائمة بترتيب رقمي تصاعدي.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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