已保存的列

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

为 Floodlight 活动、Google Analytics 目标或自定义 则广告客户可以登录 Search Ads 360 界面并创建 KPI，或 更多已保存的列，如 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 广告系列管理页面中修改或移除 界面更新；如果指定已保存列的请求失败，请尝试 从请求中移除已保存的列，然后重新发送。

  • 增量报告不得包含未明确表示 （例如，Google Analytics 活动列）。在 此外，由于 Search Ads 360 用户可以重新定义已保存的列 包含已保存列的报告可能不准确。