區隔報表

新版 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 欄。您可以欄會輸出經期的開始和結束日期，方便您確認納入所有時段的資料
您不可以在同一個要求中加入不同類型的時間相關區隔。舉例來說，您無法在同一個要求中依季度和月份區隔報表。
每增加一個區隔，列數就會急遽增加。