已保存的列

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

若要针对 Floodlight 活动、Google Analytics（分析）目标或自定义 KPI 生成报表，广告客户可以登录 Search Ads 360 界面，并创建一个或多个已保存的列，例如 Floodlight 活动列、Google Analytics（分析）活动列或公式列。您可以在报告请求中添加已保存的列，以便下载其数据或过滤报告。

获取已保存列的列表

要查看某个广告客户已创建的所有已保存列，请发送 SavedColumns.list() 请求。响应包含广告客户每个列的 savedColumnName 。

请求针对已保存的列生成报告

如需将已保存的列添加到报告请求中，请添加一个列，并将 savedColumnName 属性设置为该列的名称：

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

使用已保存的列时，请注意以下几点：

• 已保存的列在广告客户级进行定义。如果您要在请求中添加已保存的列，则 request.reportScope 必须指定广告客户或更小范围。因此，每个报告只能包含单个广告客户的已保存列。

• 保存的列名称区分大小写、区分空格和标点符号。savedColumnName 属性需要与已保存的列名称完全匹配。如果已保存列的名称与同一请求中另一列的名称相同，则 Search Ads 360 会要求您为这两个列或其中一个列指定唯一的备用 headerText。

• 您可以随时在 Search Ads 360 广告系列管理界面中修改或移除已保存的列；如果指定已保存列的请求失败，请尝试从该请求中移除已保存的列，然后重新发送。

• 增量报告不能包含 API 未明确支持的指标（例如 Google Analytics（分析）活动列）。此外，由于 Search Ads 360 用户可以重新定义已保存的列，因此包含已保存列的增量报告可能不准确。