除非您要求更詳細的區隔資料,否則 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 }
請求多個區隔
您可以在要求中加入多個區隔欄。請注意:
-
如果您按週、月或季進行區隔,建議您在要求中同時加入起始欄和結尾欄。例如,在每季報表中,請同時包含
quarterStart
和quarterEnd
資料欄。如果同時納入這兩個資料欄,系統會輸出期間的開始和結束日期,協助您確認是否已納入每個完整時段的資料。 -
您無法在同一個要求中加入不同類型的時間相關區隔。舉例來說,您無法在同一個要求中依據季度和月份進行區隔。
-
每增加一個區隔,列數可能會以指數方式增加。