Billing 接入
本节介绍 Billing 接入所需的事件采集。网站 SDK 用于采集网页交互，服务端事件用于从后端发送已配置的业务事件。
安装 SDK 或创建 API Key 不会创建计费合同，也不会开启收费。数据采集、事件接收、归因和计费是不同的步骤。
选择方式
| 方式 | 适用任务 | 所需凭据 |
|---|---|---|
| 网站 SDK | 用 HTML 或 JavaScript 采集网站交互，管理访客同意并获取访客 ID。 | 公开的 Website install ID，不能使用秘密 API Key。 |
| 服务端事件 | 用 Python 或 Go 从后端发送已配置的业务事件，并保存服务端回执。 | 具有 Write 权限和品牌访问权限的 API Key，以及已配置的事件。 |
同一个事件只选一种上报方式，不要同时从浏览器和服务端发送。如果后端需要网站访客 ID，可以将 ID 传给后端，但不要为同一事件再从浏览器上报一次。事件何时发生，由你的应用判断。
接入准备
- 选择目标品牌，获取该品牌的 Website install ID。
- 从后端上报时，先创建 API Key，并确认业务事件已配置。仅采集数据的连接不能接收服务端业务事件，会返回
422 server_event_not_configured。 - 按网站 SDK 或服务端事件章节接入，检查访客同意、凭据和访客关联要求。
- 在接口参考中查看响应与错误码。
响应含义
getVisitorId()只读取 ID，不上报事件。- 浏览器采集不验证业务结果，也不证明网站归属。浏览器 measurement 响应没有回执 ID。
- 服务端事件回执可用于排错和重试。
202只表示接收或入队，不代表业务成功、归因或计费完成。 - 事件是否参与计费，取决于已配置的事件与合同，不取决于是否安装 SDK 或创建密钥。
MCP Server 是使用 OAuth 的独立接入方式，不属于这里的事件上报方式。