已儲存的資料欄

新版 Search Ads 360 Reporting API 現已開放使用。這個新 API 提供更靈活彈性的功能,協助您建立自訂報表,並將這些資料整合至報表應用程式和程序。進一步瞭解如何使用及遷移至新版 Search Ads 360 Reporting API

如要針對 Floodlight 活動、Google Analytics (分析) 目標或自訂 KPI 製作報表,廣告客戶可以登入 Search Ads 360 UI,然後建立一或多個已儲存的資料欄,例如 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 使用者可以重新定義已儲存的資料欄,因此包含已儲存資料欄的增量報表可能不準確。