最佳实践

使用 Data Manager API 时,请牢记以下最佳实践。

发送所有用户标识符

无论是使用 UserData 发送受众群体成员还是事件,都应尽可能多地添加 user_identifiers,包括发送多个相同类型的标识符。

例如,如果您有用户的多个电子邮件地址,请为每个电子邮件地址添加一个单独的 UserIdentifier。同样,如果您有用户的不同类型的标识符(例如邮箱、电话号码和地址),请为每个标识符添加一个单独的 UserIdentifier,最多可添加标识符数量上限。

优化请求

为了降低超出每日请求限制的可能性,请在每个请求中尽可能多地批量处理内容,最多不超过每个请求的限制。

例如,如果您想向某个受众群体添加 10,000 名受众群体成员,请在一个 IngestAudienceMembersRequest 中将所有 10,000 名成员添加到 audience_members 列表中。在单个请求中批量添加所有 10,000 名成员,比单独发送请求来添加每位受众群体成员更高效。

发送并发请求

如需缩短提取数据所需的总时间,请向 IngestionService 发送并发请求。我们建议您同时发送最多 10 个请求,以降低超出每分钟请求数限制的可能性。

即使请求具有相同的 destinations,您也可以发送并发请求。

使用 validateOnly 检查快速失败错误

发送将 validateOnly 设置为 true 的请求,以捕获快速失败错误。Data Manager API 会运行与常规请求相同的验证检查,但不会提取或移除任何数据。

仅验证请求成功并不保证在处理过程中不会出现错误,因此在发送常规请求后,请继续检查诊断信息。

查看诊断信息

从每个 IngestAudienceMembersResponse 或 IngestEventsResponse 中捕获并收集 request_id,然后使用请求 ID 检查诊断。

监控配额并发出提醒

为避免请求意外遭到拒绝,请在 Google Cloud 控制台中设置配额提醒和监控。监控配额用量有助于您在应用达到每日或每分钟限制之前,跟踪消耗模式并优化请求批处理。

部署到生产环境

从本地测试迁移到生产工作负载时,请使用应用默认凭证以及关联的服务账号或工作负载身份联合,以非交互方式安全地进行身份验证。

如需详细了解如何为不同的生产环境配置身份验证,请参阅部署到生产环境。