若要针对 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 用户可以重新定义已保存的列,因此包含已保存列的增量报告可能不准确。