ستون های ذخیره شده

API جدید Search Ads 360 Reporting اکنون در دسترس است. API جدید انعطاف‌پذیری بیشتری برای ایجاد گزارش‌های سفارشی و ادغام داده‌ها در برنامه‌ها و فرآیندهای گزارش‌دهی شما فراهم می‌کند. درباره انتقال و استفاده از Search Ads 360 Reporting API جدید بیشتر بیاموزید.

برای گزارش فعالیت‌های Floodlight، اهداف Google Analytics یا KPIهای سفارشی، یک تبلیغ‌کننده می‌تواند وارد رابط کاربری Search Ads 360 شود و یک یا چند ستون ذخیره‌شده مانند ستون‌های فعالیت Floodlight ، ستون‌های فعالیت Google Analytics یا ستون‌های فرمول ایجاد کند. می‌توانید یک ستون ذخیره‌شده را در درخواست گزارش بگنجانید یا برای بارگیری داده‌های آن یا فیلتر کردن یک گزارش .

لیستی از ستون های ذخیره شده را دریافت کنید

برای مشاهده تمام ستون های ذخیره شده ای که یک تبلیغ کننده ایجاد کرده است، یک درخواست SavedColumns.list() ارسال کنید. پاسخ شامل savedColumnName برای هر یک از ستون‌های تبلیغ‌کننده است.

درخواست گزارش برای ستون های ذخیره شده

برای گنجاندن یک ستون ذخیره شده در درخواست گزارش، ستونی با ویژگی savedColumnName به نام ستون اضافه کنید:

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

هنگام استفاده از ستون های ذخیره شده، به خاطر داشته باشید که:

  • ستون های ذخیره شده در سطح تبلیغ کننده تعریف می شوند. اگر یک ستون ذخیره شده را در یک درخواست اضافه می کنید، request.reportScope باید تبلیغ کننده یا محدوده کمتری را مشخص کند. در نتیجه، هر گزارش می‌تواند شامل ستون‌های ذخیره‌شده فقط برای یک تبلیغ‌کننده باشد.

  • نام ستون های ذخیره شده حساس به حروف بزرگ، فضای خالی و حساس به علائم نقطه گذاری هستند. ویژگی savedColumnName باید دقیقاً با نام ستون ذخیره شده مطابقت داشته باشد. اگر نام یک ستون ذخیره شده با نام ستون دیگری در همان درخواست یکسان باشد، Search Ads 360 از شما می‌خواهد که یک headerText جایگزین و منحصر به فرد برای یک یا هر دو ستون مشخص کنید.

  • ستون‌های ذخیره‌شده را می‌توان در رابط کاربری مدیریت کمپین Search Ads 360 در هر زمان تغییر داد یا حذف کرد. اگر درخواستی که ستون های ذخیره شده را مشخص می کند با شکست مواجه شد، سعی کنید ستون های ذخیره شده را از درخواست حذف کرده و دوباره ارسال کنید.

  • گزارش‌های افزایشی نمی‌توانند شامل معیارهایی باشند که به صراحت توسط API پشتیبانی نمی‌شوند (مثلاً ستون‌های فعالیت Google Analytics). علاوه بر این، از آنجایی که کاربران Search Ads 360 می‌توانند ستون‌های ذخیره‌شده را دوباره تعریف کنند، گزارش‌های افزایشی حاوی ستون‌های ذخیره‌شده ممکن است دقیق نباشند.