问题排查

如果您在使用 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 控制台检索客户端 ID 和客户端密钥以及获取刷新令牌时，请务必使用已获授 Search Ads 360 访问权限的 Google 账号。

转化数据上传错误

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

错误代码 消息 说明
0x00000101

Click ID '{ID}' is not found

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

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

  • 启用了 API 转化服务。

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

  • 确认点击来自有效来源（如 gclsrc 参数所示）。

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

  • 您的点击 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 变量已设置为与您要为其分配转化功劳的 clickId、criterionId 或 productGroupId 相关联的广告客户的维度（而非指标）。

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

确保您指定的自定义 Floodlight 变量已设置为与您要为其分配转化功劳的 clickId、criterionId 或 productGroupId 相关联的广告客户的指标（而非维度）。

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，请确保在界面中也选中了显示已移除的内容复选框。