الأعمدة المحفوظة

لإعداد تقارير عن أنشطة Floodlight أو أهداف "إحصاءات Google" أو لمؤشرات الأداء الرئيسية، يمكن للمعلِن تسجيل الدخول إلى واجهة مستخدم "إعلانات شبكة البحث 360" وإنشاء واحد أو المزيد من الأعمدة المحفوظة، مثل أعمدة نشاط Floodlight أو أعمدة نشاط "إحصاءات Google" أعمدة الصيغ. إِنْتَ تضمين عمود محفوظ في طلب تقرير إما لتنزيل بياناته أو فلترة أي تقرير

الحصول على قائمة بالأعمدة المحفوظة

للاطّلاع على كل الأعمدة المحفوظة التي أنشأها المعلِن، أرسِل SavedColumns.list() طلبك. يتضمن الرد savedColumnName لكل عمود من أعمدة المعلن.

طلب تقارير للأعمدة المحفوظة

لتضمين عمود محفوظ في طلب تقرير، أضف عمودًا يحتوي على تم ضبط السمة savedColumnName على اسم العمود:

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

عند استخدام الأعمدة المحفوظة، يجب مراعاة ما يلي:

• يتم تحديد الأعمدة المحفوظة على مستوى المعلِن. إذا كنت تضمين عمود محفوظ في الطلب، يجب أن يحدد request.reportScope معلِنًا أو أقل النطاق. وبالتالي، يمكن أن يتضمن كل تقرير أعمدة محفوظة فقط معلن واحد.

• أسماء الأعمدة المحفوظة حساسة لحالة الأحرف والمسافات البيضاء علامات الترقيم حساسة. تشير رسالة الأشكال البيانية يجب أن تتطابق السمة savedColumnName مع اسم العمود المحفوظ. بالضبط. إذا كان اسم العمود المحفوظ مطابقًا لاسم عمود آخر في الطلب نفسه، تطلب منك "إعلانات شبكة البحث 360" تحديد قيمة headerText بديلة وفريدة لأحد العمودين أو كليهما.

• يمكن تعديل الأعمدة المحفوظة أو إزالتها ضمن إدارة الحملات على "إعلانات شبكة البحث 360". واجهة المستخدم في أي وقت؛ إذا فشل طلب يحدد الأعمدة المحفوظة، فحاول إزالة الأعمدة المحفوظة من الطلب وإرساله مرة أخرى.

• لا يمكن أن تحتوي التقارير المتزايدة على مقاييس غير مرتبطة بشكل صريح. متوافقة مع واجهة برمجة التطبيقات (على سبيل المثال، أعمدة نشاط "إحصاءات Google"). ضِمن ونظرًا لأنه يمكن لمستخدمي "إعلانات شبكة البحث 360" إعادة تعريف الأعمدة المحفوظة قد لا تكون التقارير التي تحتوي على أعمدة محفوظة دقيقة.