# アナリティクスプロバイダー

アナリティクスプロバイダーは、公開ストリームページに**ブラウザ向けの分析・広告SDK**を取り付けます。ストリームの閲覧やプレイイベントが、既に使っているツールに届きます。DailyPlay本体の[アナリティクス](/ja/sharing/analytics/)レポートや、サーバー側の[コネクション](/ja/connections/overview/)（CRM / Webhook）とは別機能です。

:::note
設定には**公開**の測定IDやプロジェクトトークンのみを保存します。シークレットAPIキーやサーバー認証情報は貼り付けないでください。
:::

---

## コネクション・レポートとの違い

| 機能 | 内容 |
| :--- | :--- |
| **アナリティクスプロバイダー** | プレイヤー上でクライアントSDKを読み込み、GA4 / Mixpanel などのダッシュボードへイベント送信 |
| **コネクション** | サーバー側Webhook・CRM連携（Braze、Zapier、HubSpot など） |
| **レポート / アナリティクス** | DailyPlay上のプレイ指標、セッション、リード、エクスポート |

---

## 対応プロバイダー

| プロバイダー | 必須フィールド | 任意フィールド |
| :--- | :--- | :--- |
| **Google Analytics** | Measurement ID（`G-…`） | — |
| **Mixpanel** | プロジェクトトークン | APIホスト、Session Replayサンプル率（0–100、空欄は100） |
| **PostHog** | プロジェクトAPIキー、APIホスト（例：`https://us.i.posthog.com`） | — |
| **Amplitude** | APIキー | サーバーゾーン（`US` / `EU`、既定はUS） |
| **Google Tag Manager** | コンテナID（`GTM-…`） | — |
| **Meta Pixel** | Pixel ID | — |

同一ストリームで複数のプロバイダータイプを有効にできます（タイプごとに1リンク）。

---

## セットアップ

組織の**オーナー**と**管理者**のみがアナリティクスプロバイダーを管理できます。

### 1. プロバイダーを追加（組織ライブラリ）

1. **Connect → Analytics**（または `/analytics`）を開く
2. **Add Provider** をクリック
3. プロバイダータイプを選び、表示名と必要な公開IDを入力
4. 保存 — ストリーム間で再利用できます

同じページから有効化・無効化・編集・削除ができます。削除するとストリーム上のリンクも外れます。

### 2. ストリームでトラッキングを有効化

1. ストリームを作成または編集
2. **Tracking** ステップを開く
3. 使いたいプロバイダータイプを有効化
4. 次のいずれかを選択：
   - **Use org provider** — ライブラリの既存設定を選ぶ
   - **Create new…** — 表示名とフィールドをその場で入力（保存時に組織プロバイダーを作成してリンク）
5. ストリームを保存

Trackingでタイプをオフにすると、組織プロバイダーは残したままそのストリームだけ無効になります。

---

## サードパーティへ送るイベント

リンク済みプロバイダーが有効なとき、公開ストリームでSDKを読み込み次を転送します：

| イベント | タイミング |
| :--- | :--- |
| ストリーム / ページビュー | 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はクライアントSDKのため公開ストリーム応答に含まれます。
- DailyPlayはこれらのSDKを別のCookie同意バナーでは制御しません。ストリームページの第三者タグは、自社のプライバシーポリシーとCMPでカバーしてください。
- ストリームCTAのマーケティング同意はリードフォーム用であり、分析SDKの読み込みには適用されません。
- MixpanelとPostHogは `localStorage` を使う場合があります。Mixpanel Session Replayが有効なときはキャンバスのゲームプレイを記録できます。

---

## 管理

| 操作 | 効果 |
| :--- | :--- |
| **Activate / Deactivate**（組織） | リンク時に読み込めるかを制御 |
| **Enable / Disable**（ストリームTracking） | そのストリームのトラッキングを切替 |
| **Delete**（組織） | プロバイダーと全ストリームリンクを削除 |
| **Unlink**（ストリーム） | そのストリームのトラッキングを停止（組織プロバイダーは残る） |

公開プレイヤーでSDKが読み込まれるには、組織プロバイダーとストリームリンクの両方が有効である必要があります。SDKの読み込み失敗はソフトフェイルで、プレイは続きます。

---

## エージェントとAPIキー

組織管理者は[MCPサーバー](/ja/api/mcp/)で次のスコープを使えます：

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

ツール一覧と設定形状は[MCP Tools](/ja/api/mcp-tools/#analytics-providers)を参照してください。

典型的な流れ：

1. `create_analytics_provider`（`provider` + 公開 `config`）
2. `link_stream_analytics_provider`（`stream_id` + `analytics_provider_id`）
3. 任意でストリームごとの `config_override`、unlinkしても組織プロバイダーは残る

---

## 次のステップ

- 本体の[アナリティクス](/ja/sharing/analytics/)と[レポート](/ja/sharing/analytics/#reports)を確認
- CRM / Webhookは[コネクション](/ja/connections/overview/)で連携
- アトリビューションは[UTMトラッキング](/ja/streams/overview/#utmトラッキング)