使用 Data Manager API 时,请牢记以下最佳实践。
发送所有用户标识符
无论是发送包含 UserData 的受众群体成员还是事件,都应尽可能多地添加 user_identifiers,包括发送同一类型的多个标识符。
例如,如果某个用户有多个电子邮件地址,请为每个电子邮件地址分别添加一个 UserIdentifier。同样,如果您有用户的不同类型的标识符(例如电子邮件地址、电话号码和地址),请为每个标识符添加单独的 UserIdentifier,最多可添加最大标识符数量。
优化请求
为降低超出每日请求次数上限的可能性,请在每个请求中尽可能批量处理更多商品,但不得超出每个请求的限制。
例如,如果您想向某个受众群体添加 10,000 名受众群体成员,请在 audience_members 列表中一次性添加所有 10,000 名成员,即在一次 IngestAudienceMembersRequest 中添加。与为每位受众群体成员单独发送添加请求相比,在单个请求中批量添加所有 10,000 名成员的效率更高。
发送并发请求
为了缩短数据提取所需的总时间,请向 IngestionService 发送并发请求。我们建议您最多同时发送 10 个请求,以降低超出每分钟请求数上限的可能性。
即使请求具有相同的 destinations,您也可以发送并发请求。
使用 validateOnly 检查快速失败错误
发送将 validateOnly 设置为 true 的请求,以捕获快速失败错误。Data Manager API 会运行与常规请求相同的验证检查,但不会提取或移除任何数据。
仅验证请求成功并不保证在处理过程中不会出现错误,因此在发送常规请求后,请继续检查诊断信息。
查看诊断信息
捕获并收集每个 IngestAudienceMembersResponse 或 IngestEventsResponse 中的 request_id,并使用请求 ID 检查诊断信息。
部署到生产环境
从本地测试迁移到生产工作负载时,请使用附加了服务账号的应用默认凭证或工作负载身份联合以非交互方式安全地进行身份验证。
如需详细了解如何为不同的生产环境配置身份验证,请参阅部署到生产环境。