问题排查

如果您在使用 Search Ads 360 API 时遇到问题,请查看此问题排查部分。

如果您在阅读本网站上的资源后仍遇到问题,请与支持团队联系并提供以下信息:

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

  • 来自 Google API 控制台的项目编号

  • 您用于访问 API 的 Google 帐号的用户名。
    这个帐号已获得访问 Search Ads 360 的权限,即您用于设置授权的帐号。

  • 请求的代码段

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

授权错误

下面是一些常见的授权错误:

讯息 说明

Access Not Configured. Please use Google API Console to activate the API for your project.

如果您没有为自己的帐号启用 Search Ads 360 API,则会出现此错误。请确保您已完成以下操作:

  1. 转到 Google API 控制台

  2. 选择您的项目。如果您尚未创建项目,请参阅为客户创建项目

  3. 在左侧边栏中,展开 API 和身份验证。接下来,点击 API。在 API 列表中,确保 Search Ads 360 API 的状态为启用

Invalid grant

如果您的刷新令牌无效,便会出现此错误。您可以通过调用 Search Ads 360 实用程序脚本获取刷新令牌,如下所示:

sa360Api.py --login

详细了解推荐的授权工作流。

Invalid client
no application name

如果您在 Google API 控制台中设置项目时未指定商品名称,则会出现此错误。如需解决此错误,请在 Google API 控制台的“同意”屏幕上输入产品名称

其他类型的授权错误

在登录 Google API 控制台时,请务必使用已获得 Search Ads 360 访问权限的 Google 帐号检索您的客户端 ID 和客户端密钥,以及获取刷新令牌。

转化上传错误

下表列出了上传转化数据时可能遇到的错误。请注意,十六进制错误代码是不可变的,因此您可以在自己的脚本中使用它们来识别错误。

错误代码 讯息 说明
0x00000101

Click ID '{ID}' is not found

您在 update 请求中指定的点击 ID 无效。完成以下操作后,重新上传转化数据:

  • 验证点击 ID 在上传转化数据前 4 小时生成。

  • 已启用 API 转化服务

  • 如果您将转化归因于特定的访问,请在相应访问发生后至少等待 30 分钟,然后再上传转化数据。如果您在相应访问发生后的 30 分钟内上传,那么 Search Ads 360 可能无法识别此访问的点击 ID。在极少数情况下,您可能需要等待最多 4 小时,Search Ads 360 才能识别该 ClickId。

  • 确认点击来自gclsrc 参数指示的有效来源。

  • 确认您已在 广告客户 ID 列中指定正确的广告客户。

  • 您的点击 ID 是在过去 90 天内生成的。

0x0000010E Floodlight activity name '{name}' is not found

segmentationName ”列中指定的 Floodlight 活动名称不正确或尚不可用。如果您看到此错误,请检查是否出现以下常见问题:

  • 名称区分大小写,因此,请确保您的请求与大小写完全一致。
  • 确保您未在 Floodlight 活动名称中包含任何不可打印的 Unicode 字符或双空格。
  • 请确保您指定的是 Floodlight 活动的名称,而不是 Floodlight 列
  • 检查您在 advertiserId 列中指定的广告客户的 Floodlight 活动是否存在。(您可能指定了错误的广告客户。)
  • 创建或修改 Floodlight 活动后,请等待几个小时,然后再为活动上传转化数据。
0x00000115 Custom dimension '{name}' is not found

请确保您已将自定义 Floodlight 变量设置为与您归因到相应转化的 clickIdcriterionIdproductGroupId 相关联的广告客户的维度(而不是指标)。

0x00000116 Custom metric '{name}' is not found

请确保您已将自定义 Floodlight 变量设置为与您归因于转化的 clickIdcriterionIdproductGroupId 相关联的广告客户的指标(而非维度)。

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

有人已经上传了 conversionId 列中指定的相同范围和广告客户转化 ID 的转化。

“广告客户转化 ID”是指您生成的 ID。Search Ads 360 在给定范围内要求此 ID 必须是唯一的。Search Ads 360 转化 ID 由 Search Ads 360 生成,并保证是唯一的。

0x0000011B Advertiser conversion ID '{ID}' is not found

您的 update 请求尝试更新的广告客户转化 ID 不存在。确保您指定了正确的 ID。

0x0000011D User does not have permission to view advertiser {advertiser ID}

您的客户端使用的 Google 帐号无权查看请求中指定的广告客户。

当您登录 Google API 控制台检索客户端 ID 和客户端密钥时,以及获取刷新令牌时,请务必使用向您指定的广告客户授予访问权限的 Google 帐号。

0x0000011F Advertiser conversion ID is already specified in this request

请求中的两个或多个转化指定了相同的范围和广告客户转化 ID。

广告客户转化 ID 是您在 conversionId 列中生成和指定的 ID。Search Ads 360 要求此 ID 在指定范围内必须是唯一的。

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

您提供的 Floodlight 活动 ID 或名称与您指定的转化类型不符。

报告响应代码和错误消息

如果您请求报告后得到的响应为错误消息,请参阅 Search Ads 360 API 中的响应代码标准错误响应,详细了解相应错误。

Search Ads 360 界面中的数据与 API 返回的报表不匹配

默认情况下,Search Ads 360 界面中的数据应该与 API 返回的数据一致。 如果您在报告请求中将 includeRemovedEntities 设置为 true,请确保还在界面中选中了显示已移除的内容复选框。

如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC):2023-02-27。