區隔報表

新版 Search Ads 360 Reporting API 現已上線。新版 API 提供 更有彈性，可用來建立自訂報表，以及將資料整合至報表應用程式 和處理程序進一步瞭解如何遷移至及使用新版 Search Ads 360 報表 API。

除非您要求取得更詳細的區隔詳細資料，否則 Search Ads 360 API 只會傳回匯總資料 資料。例如，關鍵字中的「點擊次數」欄 報表會列出指定時間範圍內，關鍵字獲得的總點擊次數。

keywordText keywordLandingPage 點擊次數
小工具 http://www.example.com 6000

但如果要索取按季區隔的關鍵字報表 此欄會逐季顯示，「點擊次數」欄則會列出季度總計。

keywordText keywordLandingPage quarterStart quarterEnd 點擊次數
小工具 http://www.example.com 2012-01-01 2012-03-31 1000
小工具 http://www.example.com 2012-04-01 2012-06-30 1000
小工具 http://www.example.com 2012-07-01 2012-09-30 1000
小工具 http://www.example.com 2012-10-01 2012-12-31 3000

請注意，區隔報表只會在區隔有可用資料時，才會傳回一列。 舉例來說，在包含 floodlightActivity 欄的關鍵字報表中，一個關鍵字 如果沒有已歸因的指標，報表就不會顯示 Floodlight 活動組合 報表日期範圍

部分區隔與特定資料欄不相容

部分區隔可能會導致特定資料欄傳回無效資料。例如 只有在您加入會回報 Floodlight 資料欄的情況下，「floodlightActivity」才有意義 資料，例如 dfaActions、dfaRevenue、dfaTransactions 和 dfaWeightedActions。其他類型的轉換欄 (例如 adWordsConversions)，或回報引擎指標的資料欄 (例如點擊和 曝光) 不包含 Floodlight 所回報的資料，因此如果您指定了曝光，就會傳回無效值 按 floodlightActivity 區隔報表

如何索取區隔報表

如要索取區隔報表，請在「類型報表」參考資料中，加入將 segment 列為行為的資料欄。

下列非同步要求適用於按季區隔的關鍵字報表。 每一列的點擊次數欄將包含該季的點擊總數：

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
注意：請謹慎設定日期。如要申請每季報表，請確認 報表的 timeRange 包括整季內容否則，您只會收到部分結果 點擊次數、收益等人數都大幅下滑

請求多個區隔

您可以在要求中加入多個區隔欄。注意事項：

  • 如果您是按週、月或季進行區隔，建議您同時加入 起始和結尾欄例如，在每季報表中，請同時包含 quarterStart 和 quarterEnd 欄。您可以 欄會輸出經期的開始和結束日期，方便您確認 納入所有時段的資料

  • 您不可以在同一個要求中加入不同類型的時間相關區隔。 舉例來說，您無法在同一個要求中依季度和月份區隔報表。

  • 每增加一個區隔，列數就會急遽增加。