举报常见问题解答

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

我的报告范围应该是多少？

对于大多数报告，我们建议您将 Reports.reportScope 特定的引擎账号或广告客户。超大 报告，例如关键字报告、转化报告或 细分的报表 - 我们建议您将范围限制在 特定引擎账号。如果报告的数量超过 1000 万行。

为什么我会收到禁止访问 (403) 错误？

您很可能需要 获取刷新 OAuth 令牌。

如何查找代理商和广告客户的 ID？

如果您还没有代理机构和广告客户的 ID 查看权限、请求 advertiser 包含agencyId和advertiserId列的报告 但不要指定 reportScope。 Search Ads 360 将返回您的 Google 账号有权查看。

下面是一个示例请求：

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

使用 Search Ads 360 实用程序脚本发送此请求

要发送原始 JSON POST 请求，您可以使用 sa360Api.py 脚本如下：

1. 复制示例 JSON 对象（两者之间的所有内容，包括两者之间的内容） 大括号中的内容）复制到名为 request.txt 的新文本文件中。
2. 将 JSON 代码中的代理机构 ID 更改为您自己的代理机构 ID。
3. 移除所有评论，例如 // The date column segments the report by individual days.
4. 将您的 OAuth 2.0 凭据整合到一个以英文逗号分隔的字符串中，如下所示： 跟随：
   client-ID,client-secret,refresh-token
   （此字符串与您运行 sa360Api.py --login 时 sa360Api.py 输出的字符串相同，如设置 授权。）
5. 按如下方式调用 sa360Api.py：
   sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
   在上面的命令中，将 CREDENTIALS 替换成您在上一步中组建的字符串。
   将 API-method 替换成下面框中的 POST 方法的名称。

   例如：
   sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/reports/generate --post < request.txt

。

注意：

由于“statisticsCurrency”是必填字段，因此请指定 此请求中的usd。在范围限定为 广告客户或更低级别，您可以请求 以其他币种返回报告。

报告数据的新鲜度如何？

某些指标的时效性要高于其他指标。有关详情，请参见报告数据的新鲜度 ？

为确保您的报告包含所有可用指标，我们建议您等待大约 4 小时 小时（即引擎账号时区）之后，再请求昨天 metrics;收到conversion报告，建议您等待 午夜 12 小时后（Campaign Manager 广告客户时区）。如果您使用 API 上传转化数据，请参阅 insert.operation 。

即使在几天之后，指标仍可能会因引擎垃圾流量过滤器或离线而发生变化 通过 API 上传转化数据如需逐步下载这些 更改，请求报告 自您上次下载后更改的数据。如果您以增量方式 建议您每隔一段时间请求生成一次完整报告例如： 您可以每隔几天下载增量更改，然后请求获取一次完整报告 一个月。

属性更改何时会显示在报告中？

用户在 Search Ads 360 中进行的属性更改大约需要一分钟的时间才能显示在 通过 API 下载的报告直接在外部引擎上进行的更改（不是 通过 Search Ads 360 导入）时，需要先使用入站同步功能导入到 Search Ads 360 中。

我们建议 仅更改的数据，从而确定哪些实体有属性更改。

什么是未归因广告和关键字？

有时，Search Ads 360 无法将指标归因于特定广告。例如，包含 格式不受支持，或者 Clickserver 网址出现错误，都可能会导致 Search Ads 360 无法将 指标。对于每个广告组，Search Ads 360 会将属于 “未归因广告”。要在报告中请求这些指标，请将 includeRemovedEntities 发送至 true。为了便于查看哪些广告未归因，请添加 isUnattributedAd 列。

同样，Search Ads 360 有时也无法将指标归因于特定关键字。 当报告存在差异时就会出现这种情况。在这种情况下， 未归因关键字的“keywordId”列设置为 0。

报告中是否包含按比例调整的转化？

在某些情况下，转化难以衡量，例如在存储了 由于浏览器设置等因素，系统无法提供有关您的广告点击次数的信息。 在这种情况下，Floodlight 使用调整比例来计算无法衡量的转化数据 直接测量。也就是说，Floodlight 将机器学习应用于历史数据， 无法衡量的转化次数和转化收入金额。Floodlight 可以 然后将得出的估算结果添加到其转化指标中，以更全面地了解 您的广告如何促成转化

Floodlight 始终对以下报表列应用缩放比例：

• dfaActions
• dfaRevenue
• dfaTransactions
• dfaWeightedActions
• 已保存的列 生成 Floodlight 活动报表

conversion 不包含按比例调整的转化。它仅显示已衡量的转化 。conversion 报告中的转化次数和收入金额 预计会与上述列中报告的转化次数和收入不符。

为什么原始转化次数的总和不能等于汇总指标 X？X

在极少数情况下，如果汇总的指标与 Search Ads 360 中的原始事件不一致，请信任 Search Ads 360 中的 汇总指标。在计算指标汇总值时，Search Ads 360 会尝试清理数据 删除疑似重复的转化，从而找出相应的转化来源。

如果这里没有回答我的问题，该怎么办？

如果在阅读本网站上的资源后仍无法解决某个问题 与支持团队联系，并确保 以下信息：

• 您尝试访问的 Search Ads 360 代理机构 ID 和广告客户 ID

• Google API 控制台中的项目编号

• 您用来访问 API 的 Google 账号的用户名。
  也就是系统获得的 访问 Search Ads 360，这与您用来 设置授权。

• 请求的代码段

• JSON 响应
  如果响应为错误，请务必包含错误消息，而不仅仅是 数字错误代码。