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

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

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

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