使用 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 控制台中设置配额提醒和监控。监控配额用量有助于您在应用达到每日或每分钟限制之前,跟踪消耗模式并优化请求批处理。
部署到生产环境
从本地测试迁移到生产工作负载时,请使用应用默认凭证以及关联的服务账号或工作负载身份联合,以非交互方式安全地进行身份验证。
如需详细了解如何为不同的生产环境配置身份验证,请参阅部署到生产环境。