除非您请求更详细的细分数据,否则 Search Ads 360 API 只会返回汇总数据。例如,关键字报告中的“点击次数”列会列出您指定的时间范围内某个关键字的总点击次数。
keywordText | keywordLandingPage | clicks |
---|---|---|
微件 | http://www.example.com | 6000 |
但是,如果您请求按季度细分的关键字报表,则对于每个关键字,您会看到每个季度对应一行,而“点击次数”列会列出季度总计。
keywordText | keywordLandingPage | quarterStart | quarterEnd | clicks |
---|---|---|---|---|
微件 | 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
列。包含这两个列会输出相应时间段的开始日期和结束日期,这将有助于您确认是否已包含每个完整时间段的数据。 -
您无法在同一请求中添加不同类型的时间相关细分。例如,您不能在同一请求中按季度和月份进行细分。
-
每增加一个片段,行数可能会成倍增加。