细分的报告

新版 Search Ads 360 Reporting API 现已发布。这一新 API 提供 可以更灵活地生成自定义报告，并将数据整合到您的报告应用程序中 和进程。详细了解如何迁移到和使用新版 Search Ads 360 报告 API。

除非您请求更具体的、更细致的数据，否则 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 报表的列时，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 列。同时包含这两项 列将输出该时间段的开始日期和结束日期， 这将帮助您确认 包含每个完整时间段的数据。

  • 您不能在同一请求中添加不同类型的时间相关细分。 例如，您不能在同一请求中按季度和月份进行细分。

  • 每增加一个细分，行数就可能成倍增加。