用途：为 Spotify Ads 规划并配置转化衡量，先设计事件计划，再配置 Spotify 资源，最后交付实现与验证。所有测量路径需要 business_id，缺失时用 GET businesses 查询，注意不要与 ad_account_id 混淆。推荐 Pixel 用于浏览器端网站事件与自动页面浏览；CAPI 用于服务器端网页、应用或离线事件，对事件负载控制更强；同一真实事件同时由 Pixel 与 CAPI 上报时，放入同一数据集并使用相同稳定的 event_id 以便去重；应用归因由支持的移动测量合作伙伴提供时注册移动应用。
资源流程：盘点现有 Pixel、CAPI、移动应用与数据集；确认事件矩阵与来源拓扑；复用兼容资源，仅创建缺失项；按正确顺序创建集成：先创建 Pixel（自动创建数据集），再创建 CAPI 并将 dataset_id 指向该数据集；将数据集或移动应用共享给目标广告账户；向实现方提供对应来源的代码或负载要求。实现后至少等待 20 分钟再判断诊断缺失为失败，之后使用 measurement-debug。不要仅因摄入已配置就承诺归因、优化或报告效果。
限制：API 只创建和配置 Pixel，不安装站点 JavaScript；指向式安装与标签管理器安装不应同时使用。Pixel 事件只读，API 不提供 Pixel 删除或任意自定义事件创建；事件活动是收到的站点总活动，不是归因的广告系列结果。CAPI 令牌为长期有效，与 Ads API OAuth 不同，须与连接 ID 匹配；每个连接最多三个令牌；令牌创建与列表响应包含活跃密钥，须视为机密，不得在聊天、日志或命令摘要中打印，只暴露脱敏的令牌 ID 或数量；创建新令牌应直接存入用户的密钥管理器，否则停止并让用户通过安全路径创建存储。CAPI 事件提交使用 POST https://capi.spotify.com/capi-direct/events/，不走 Ads API 包装。未经明确确认目标与预期效果，不得提交示例或测试转化事件；获授权提交时须对显示命令与输出中的标识符和令牌脱敏。不要自动重试 POST；实现方可对瞬时 5xx 做有界退避重试并保持 event_id 稳定，非超时 4xx 原样不得重试。GET datasets 不接受 limit 或 offset。移动应用合作伙伴支持 KOCHAVA、APPS_FLYER、ADJUST、BRANCH，注册并不代表安装或配置合作伙伴 SDK。不要因存在 API 资源就声称支持 Direct IO、SAX、PG 等购买渠道，也不要声称 tCPA/tROAS 优化或保证跨设备归因。变更前确认 business、资源与广告账户 ID；共享/取消共享、令牌创建/撤销或集成迁移前先给出确切计划。已有损坏配置使用 measurement-debug。检查 HTTP_STATUS，遇 4xx 显示脱敏错误并停止。