问题排查
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
如果您在使用 Search Ads 360 API 时遇到问题,请参阅此问题排查部分。
如果您在阅读本网站上的资源后仍无法解决问题,请与支持团队联系,并准备好以下信息:
授权错误
以下是一些常见的授权错误:
消息 |
说明 |
Access Not Configured. Please use Google API Console to activate the API for your project.
|
如果您尚未为自己的账号启用 Search Ads 360 API,就会出现此错误。请确保您已完成以下操作:
转到 Google API 控制台。
选择您的项目。如果您尚未创建项目,请参阅为客户端创建项目。
在左侧边栏中,展开 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 是在上传转化数据前 6 小时生成的。
启用了 API 转化服务。
如果您要
将转化归因于具体的访问,请在相应访问发生后至少等待 6 小时,然后再上传转化数据。如果您在相应访问发生后的 6 小时内进行上传,那么 Search Ads 360 可能无法识别此访问的点击 ID。在极少数情况下,您可能需要等待最长 24 小时,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 或名称与您指定的转化类型不匹配。 |
0x00000126 |
Service internal error |
请稍后重试您的请求。这可能是暂时性错误。如果此错误仍然存在,请与 SA360 支持团队联系。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-04-07。
[null,null,["最后更新时间 (UTC):2025-04-07。"],[[["\u003cp\u003eThis page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors.\u003c/p\u003e\n"],["\u003cp\u003eIf the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses.\u003c/p\u003e\n"],["\u003cp\u003eThe page lists common authorization errors such as \u003ccode\u003eAccess Not Configured\u003c/code\u003e, \u003ccode\u003eInvalid grant\u003c/code\u003e, and \u003ccode\u003eInvalid client\u003c/code\u003e, with explanations and solutions.\u003c/p\u003e\n"],["\u003cp\u003eIt also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps.\u003c/p\u003e\n"],["\u003cp\u003eFor report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the \u003ccode\u003eincludeRemovedEntities\u003c/code\u003e setting in your request matches the "Show removed" checkbox selection in the Search Ads 360 UI.\u003c/p\u003e\n"]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"],null,[]]