# 分析提供商

分析提供商可让您将**浏览器端分析与广告 SDK** 挂到公开 stream 页面。Stream 浏览与游玩事件会出现在您已在使用的工具中 — 与 DailyPlay 内置的[数据分析](/zh/sharing/analytics/)报告，以及服务端[连接](/zh/connections/overview/)（CRM / webhook）彼此独立。

:::note
配置仅保存**公开**的测量 ID 与项目令牌。请勿粘贴密钥 API key 或服务器凭证。
:::

---

## 与连接、报告的区别

| 功能 | 作用 |
| :--- | :--- |
| **分析提供商** | 在播放器中加载客户端 SDK，事件进入 GA4 / Mixpanel 等仪表盘 |
| **连接** | 服务端 webhook 与 CRM 同步（Braze、Zapier、HubSpot 等） |
| **报告 / 数据分析** | DailyPlay 托管的游玩指标、会话、线索与导出 |

---

## 支持的提供方

| 提供方 | 必填字段 | 可选字段 |
| :--- | :--- | :--- |
| **Google Analytics** | Measurement ID（`G-…`） | — |
| **Mixpanel** | 项目 token | API host；Session Replay 采样率（0–100；留空默认为 100） |
| **PostHog** | 项目 API key、API host（如 `https://us.i.posthog.com`） | — |
| **Amplitude** | API key | Server zone（`US` 或 `EU`；默认 US） |
| **Google Tag Manager** | Container ID（`GTM-…`） | — |
| **Meta Pixel** | Pixel ID | — |

同一 stream 可启用多种提供方类型（每种类型一条有效链接）。

---

## 设置

仅组织 **owners** 与 **admins** 可管理分析提供商。

### 1. 添加提供商（组织库）

1. 前往 **Connect → Analytics**（或打开 `/analytics`）
2. 点击 **Add Provider**
3. 选择类型，填写显示名称与所需公开 ID
4. 保存 — 可在多个 stream 间复用

在同一页面可激活、停用、编辑或删除。删除会移除其在 stream 上的链接。

### 2. 在 stream 上启用追踪

1. 创建或编辑 stream
2. 打开 **Tracking** 步骤
3. 启用所需提供方类型
4. 选择其一：
   - **Use org provider** — 选用组织库中的现有配置，或
   - **Create new…** — 内联填写显示名称与字段（保存 stream 时创建组织提供商并链接）
5. 保存 stream

在 Tracking 中关闭某类型只会关闭该 stream，不会删除组织提供商。

---

## 发送到第三方工具的事件

当链接的提供商处于活动状态时，DailyPlay 会加载 SDK 并转发：

| 事件 | 时机 |
| :--- | :--- |
| Stream / 页面浏览 | SDK 初始化时（GA `page_view`；Mixpanel/Amplitude `stream_view`；GTM `dp_stream_view`；Meta `PageView`） |
| `play_start` | 玩家开始游戏（Meta 映射为 `ViewContent`） |
| `play_complete` | 玩家完成游戏（Meta 映射为 `CompleteRegistration`） |
| `share` | 玩家分享结果 |
| `cta_click` | 在支持时 Meta 映射为 `Lead` |

上下文常包含 `stream_id`、`stream_slug`、`stream_name`、`org_slug`、`player_uuid`、`session_id`、游戏/分数字段，以及 `utm_*`、`external_id`、`user_id` 等 URL 查询参数。存在 `player_uuid` 时用其标识玩家。

GTM 在 dataLayer 上接收 `dp_<event>`，便于在容器中路由标签。

---

## 隐私与同意

- 测量 ID 会出现在公开 stream 载荷中（客户端 SDK 所需）。
- DailyPlay **不会**用单独的 Cookie 同意横幅拦截这些 SDK — 请确保您自己的隐私政策与 CMP 覆盖 stream 页上的第三方标签。
- Stream CTA 的营销同意适用于线索表单，不适用于分析 SDK 加载。
- Mixpanel 与 PostHog 可能使用 `localStorage`。启用 Mixpanel Session Replay 时可录制 canvas 游玩。

---

## 管理

| 操作 | 效果 |
| :--- | :--- |
| **Activate / Deactivate**（组织） | 控制链接后是否可加载 |
| **Enable / Disable**（stream Tracking） | 开关该 stream 的追踪 |
| **Delete**（组织） | 删除提供商及所有 stream 链接 |
| **Unlink**（stream） | 停止该 stream 追踪；组织提供商保留 |

公开播放器加载 SDK 需要组织提供商与 stream 链接均为活动状态。SDK 加载失败会软失败 — 游玩继续。

---

## 代理与 API Keys

组织管理员可通过 [MCP 服务器](/zh/api/mcp/) 使用：

- `mcp:analytics_providers:read`
- `mcp:analytics_providers:write`

完整工具列表见 [MCP Tools](/zh/api/mcp-tools/#analytics-providers)。

典型流程：

1. `create_analytics_provider`（`provider` + 公开 `config`）
2. `link_stream_analytics_provider`（`stream_id` + `analytics_provider_id`）
3. 可选按 stream 的 `config_override`；unlink 会保留组织提供商

---

## 后续步骤

- 查看内置[数据分析](/zh/sharing/analytics/)与[报告](/zh/sharing/analytics/#reports)
- 用[连接](/zh/connections/overview/)接入 CRM / webhook
- 用 [UTM 追踪](/zh/streams/overview/#utm-追踪)传递归因参数