举报常见问题解答

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

我的报表范围应该是什么？

对于大多数报表，我们建议您将 Reports.reportScope 设置为特定的引擎帐号或广告客户。对于非常大的报表（例如关键字报表、转化报表或细分的报告），我们建议您将范围限定为特定的引擎帐号。对于超过 1000 万行的报告，此 API 可能会返回错误。

为什么我会收到“禁止”(403) 错误？

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

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

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

以下是一个示例请求：

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 在您运行 sa360Api.py --login 时输出的字符串相同，如设置授权中所述。）
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。在范围限定为某个广告客户或更低级别的其他报告中，您可以请求以其他币种返回报告。

报告数据的时效性如何？

某些指标的时效性高于其他指标。如需了解详情，请参阅 Search Ads 360 中的报表数据多久更新一次？

为确保您的报表包含所有可用的指标，我们建议您在午夜（引擎帐号时区）后等待大约 4 小时，然后再请求生成昨天的指标报表；对于 conversion 报表，我们建议您在午夜（Campaign Manager 广告客户所在的时区）后等待 12 小时。如果您使用 API 上传转化数据，请参阅 insert.operation，详细了解上传的数据的可用性。

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

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

用户在 Search Ads 360 中做出的属性更改大约需要 1 分钟才会显示在您通过 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。

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

在某些情况下，转化难以衡量，例如当用于存储广告点击信息的网站 Cookie 因浏览器设置等因素而无法使用时。 在这种情况下，Floodlight 会使用调整比例来计算无法直接衡量的转化数据。也就是说，Floodlight 将机器学习应用于历史数据，以便为无法衡量的转化次数和转化收入金额建模。然后，Floodlight 可以将生成的估算数据添加到其转化指标中，从而更全面地了解您的广告如何促成转化。

Floodlight 始终会将调整比例应用于以下报表列：

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

conversion 报告不包含按比例推算的转化数据。其中仅显示直接衡量到的转化。conversion 报告中的转化次数和收入金额可能与上面列出的列中报告的转化次数和收入不符。

为什么原始转化次数的总和不能得出汇总指标 XX？

在极少数情况下，汇总的指标与 Search Ads 360 中的原始事件不一致，此时请信任汇总的指标。计算指标汇总时，Search Ads 360 会尝试移除其怀疑重复的转化，从而对数据源进行清理。

如果我的问题没有得到解答，该怎么办？

如果阅读此网站上的资源后无法解决问题，请与支持团队联系并准备好以下信息：

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

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

• 您用于访问 API 的 Google 帐号的用户名。
  此帐号已被授予 Search Ads 360 访问权限，与您设置授权时所用的帐号相同。

• 您的请求的代码段

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