问题排查

如果您在使用 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

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

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

  • 启用了 API 转化服务。

  • 如果您要将已归因的转化归因于特定访问,请在访问发生后至少等待 6 小时,然后再上传转化数据。如果您在访问发生后不到 6 小时内上传,Search Ads 360 可能无法识别访问的 clickID。在极少数情况下,您可能需要等待最多 24 小时,Search Ads 360 才能识别 clickId。

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

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

0x00000106 Either a click ID or keyword ID is required

转化未指定其归因对象。指定 clickId 列,或指定用于标识关键字的 customerId、campaignId、adGroupId 和 criterionId 列。

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

在 segmentationName 或 segmentationId 列中指定 segmentationType: "FLOODLIGHT" 和 Floodlight 活动。

当您修改 Search Ads 360 通过 Floodlight 代码记录的转化时,需要使用 Floodlight 活动来标识该转化。

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

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

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

确保您指定的自定义 Floodlight 变量已设置为维度(而非指标),并且该维度适用于与您要归因于转化的 clickId、criterionId 或 productGroupId 相关联的广告客户。

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

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

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

您的 update 请求未指定 conversionId 列。必须提供 conversionId 才能标识要修改的转化。请参阅弃用 dsConversionId。

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。检查是否存在以下常见问题:

  • 请确保您在 conversionId 列中指定了正确的 ID。对于通过 API 上传的转化,这是您在插入转化时指定的 conversionId。对于通过 Floodlight 代码记录的转化,此 ID 为 Floodlight 订单 ID。
  • 确保 conversionTimestamp 是现有转化的时间戳(采用世界协调时间,以毫秒为单位,从纪元起算)。从本地时区转换的时间戳,或以秒(而非毫秒)为单位指定的时间戳,与现有转化不匹配。
  • 对于通过 Floodlight 代码记录的转化,请确保您在 segmentationName 或 segmentationId 列中指定了转化的 Floodlight 活动,并且转化发生在过去 28 天内。
0x0000011D User does not have permission to view advertiser {advertiser ID}

您的客户所使用的 Google 账号无权查看请求中的点击 ID 或关键字所属的广告客户。

当您登录 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 或名称与您指定的转化类型不匹配。

0x00000124 Conversion timestamp is before click timestamp

conversionTimestamp 早于您在 clickId 列中指定的点击时间。确保时间戳以世界协调时间 (UTC) 纪元毫秒为单位指定,而不是以秒或本地时区为单位。

0x00000125 Conversion age is older than the max supported age

您的 update 请求尝试修改的转化过于久远,无法修改。 Search Ads 360 通过 Floodlight 代码记录的转化数据只能在conversionTimestamp后的 28 天内修改。

0x00000126 Service internal error

请稍后重试请求。这可能是暂时性错误。如果此错误仍然存在,请与 SA360 支持团队联系。

0x00000129 Invalid customer ID: {ID}

Search Ads 360 找不到您在 customerId 列中指定的客户 ID。指定包含关键字的客户账号的新版 Search Ads 360 客户 ID,例如 123-456-7890。

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 找不到由 customerId、campaignId、adGroupId 和 criterionId 列标识的关键字。确保所有四个 ID 都是新版 Search Ads 360 ID,并且关键字属于您指定的广告组、广告系列和客户账号。

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

归因于关键字的转化需要指定 customerId、campaignId、adGroupId 和 criterionId。该消息会指明缺失的 ID。请参阅仅将转化归因于关键字。

0x0000012F Editing a click ID older than 60 days is not supported.

您的 update 请求指定了 60 天前生成的 clickId。您只能在点击发生后的 60 天内修改相应转化。

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

您的 update 请求指定了已弃用的 dsConversionId 列,或在 conversionId 列中传递了 Search Ads 360 转化 ID。请改为通过广告客户转化 ID 来标识转化。请参阅弃用 dsConversionId。

报告响应代码和出错提示

如果您请求报告,但收到的响应是出错提示,请参阅 Search Ads 360 API 中的响应代码和标准错误响应,详细了解该错误。

Search Ads 360 界面中的数据与 API 返回的报告不一致

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