常见问题解答

请注意以下几点限制：

• 单个 batchinsert 和 batchupdate 请求最多只能包含 1,000 次转化。
• 转化的时间戳最多可比提交时间早 28 天。
• 您只能将转化数据提交到您的 Campaign Manager 360 用户个人资料有权访问的 Floodlight 配置。

如需详细比较这两种产品提供的功能，请参阅 Search Ads 360 帮助中心。

如果您将同一转化同时插入到 Campaign Manager 360 和 Search Ads 360 中，系统不会对这些条目进行去重。在这种情况下，请使用单独的 Floodlight 活动。

我们建议使用 Data Manager API，以获得更好的开发者体验并使用更多功能。

序数值控制重复转化的处理方式。如果插入的多次转化具有相同的 Floodlight 活动、Floodlight 配置 ID、用户标识符和转化时间戳，则系统会使用序号来确定：

• 系统会对这些转化进行去重，仅保留其中一个。如果所有转化都具有相同的序数值，就会发生这种情况。
• 系统会单独处理这些转化，并且所有转化都会保留。如果所有转化都具有不同的序数值，就会发生这种情况。

这些值本身不需要有意义。一般来说，为所有转化使用固定值（例如 1）即可启用重复信息删除功能。为每次转化使用随机或唯一价值会停用此功能。

batchinsert 和 batchupdate 会尽力处理转化：批量请求可能会返回 HTTP 200 OK 响应，而该批次中的个别转化可能会失败。请务必检查响应中的 hasFailures，并检查每个 ConversionStatus 对象上的 errors[] 列表：

• INTERNAL（重试）：Google 系统在处理转化数据时发生暂时性错误。转化未插入或更新。使用指数退避算法重试失败的转化（例如，在几分钟后开始重试，并在几个小时内重试），同时保持 ordinal、timestampMicros、floodlightActivityId 以及用户或点击标识符完全相同。
• NOT_FOUND（延迟重试）：尚未找到标识符（gclid、dclid、matchId 或 mobileDeviceId）或正在修改的现有转化。由于线上点击、Floodlight 代码和转化可能需要 1 到 2 小时才能处理和编入索引，因此请定期重试 NOT_FOUND 转化（例如，每 1 到 3 小时重试一次，最长持续 6 小时）。如果 NOT_FOUND 在 6 小时后仍然存在，请参阅以下部分，了解按标识符类型划分的常见原因。
• INVALID_ARGUMENT 和 PERMISSION_DENIED（不重试）：转化数据无效（例如，转化时间戳早于 28 天或字段格式不正确），或者您的用户个人资料缺少目标 Floodlight 配置的权限。在解决根本问题之前，请勿重试这些转换。

如果整个 HTTP 请求失败，并返回 5xx 服务器错误或 429 配额/速率限制错误，请使用指数退避算法重试请求。

安全重试和去重：重试因 INTERNAL 或 NOT_FOUND 而失败的转换时（或在 HTTP 5xx 超时且结果未知后），请始终发送完全相同的 ordinal 和 timestampMicros。如果转化已被记录，Campaign Manager 360 会根据 ordinal、用户标识符、Floodlight 活动和转化日期自动对其进行去重。

导致此错误的最常见原因如下：

• mobileDeviceId 无效。
• Search Ads 360 不知道mobileDeviceId。这意味着 Campaign Manager 360 尚未向该设备投放广告。

导致此错误的最常见原因如下：

• gclid 无效。
• gclid 未与 Search Ads 360 广告系列或 Display & Video 360 YouTube 订单项相关联。如果 gclid 是从不经过 Search Ads 360 的 Google Ads 点击重定向（例如，点击附加地址信息）中收集的，或者从与 Display & Video 360 YouTube 订单项不关联的 YouTube 广告点击重定向中收集的，则可能会发生这种情况。
• 与gclid关联的点击发生时间过于久远。 只能为过去 60 天内的点击插入转化数据。
• 与gclid关联的点击发生时间过近。我们建议将基于 gclid 的转化数据上传延迟 1 小时，以确保 gclid 已处理并可用于匹配。

导致此错误的最常见原因如下：

• dclid 无效。
• 与dclid关联的点击发生时间过于久远。 只能为过去 60 天内的点击插入转化数据。
• 与dclid关联的点击发生时间过近。我们建议将基于 dclid 的转化数据上传延迟 1 小时，以确保 dclid 已处理并可用于匹配。

导致此错误的最常见原因如下：

• Campaign Manager 360 无法识别 matchId。如果 matchId 是从 Floodlight 调用中收集的，而该调用未正确通过 Campaign Manager 360，则可能会发生这种情况（请确保您的 Floodlight 调用正常运行，包括 matchId 代码参数）。
• 与matchId关联的 Floodlight 调用不包含 Cookie。Floodlight 调用必须包含 Cookie / 标识符，以便 Campaign Manager 360 正确存储 matchId（例如，用户可能已屏蔽 Cookie 或选择停用）。
• 与 matchId 关联的 Floodlight 调用发生的时间太久远。线下转化数据必须在包含 matchId 的 Floodlight 调用发生后的 60 天内上传。
• 与 matchId 关联的 Floodlight 调用发生得太近。 我们建议将基于 matchId 的转化数据上传延迟 2 小时，以确保 matchId 已处理完毕并可用于匹配。

如果上传的线下转化数据的时间戳早于 Floodlight 活动的创建时间，则这些数据可能会被报告为 Floodlight 展示次数和未归因/已归因的转化，最长可追溯到提交时间之前的 28 天。不过，此行为无法保证，不应依赖。最佳做法是在线下转化的最早时间戳之前创建 Floodlight 活动。

除了广告用户数据同意情况之外，还必须将 nonPersonalizedAd 字段明确设置为 false，才能创建受众群体名单。