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

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على المزيد من المعلومات عن نقل البيانات إلى واجهة Search Ads 360 Reporting API الجديدة واستخدامها.

لإعداد تقارير عن أنشطة 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" إعادة تعريف الأعمدة المحفوظة، قد لا تكون التقارير المتزايدة التي تحتوي على أعمدة محفوظة دقيقة.