细分的报告

除非您请求更详细的细分数据，否则 Search Ads 360 API 只会返回汇总数据。例如，关键字报告中的“点击次数”列会列出您指定的时间范围内某个关键字的总点击次数。

但是，如果您请求按季度细分的关键字报表，则对于每个关键字，您会看到每个季度对应一行，而“点击次数”列会列出季度总计。

请注意，细分报告只有在细分有了数据可用时才会返回行。 例如，在包含 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
}