區隔報表

新版 Search Ads 360 Reporting API 現已開放使用。這個新 API 提供更靈活彈性的功能，協助您建立自訂報表，並將這些資料整合至報表應用程式和程序。進一步瞭解如何使用及遷移至新版 Search Ads 360 Reporting 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 資料的資料欄 (例如 dfaActions、dfaRevenue、dfaTransactions 和 dfaWeightedActions) 時， 根據 floodlightActivity 區隔資料才有意義。其他類型的轉換欄 (例如 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 資料欄。如果同時納入這兩個資料欄，系統會輸出期間的開始和結束日期，協助您確認是否已納入每個完整時段的資料。

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

  • 每增加一個區隔，列數可能會以指數方式增加。