> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timothe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics 4 連携

> Turnint AI のセッションイベントを Google Analytics 4 (GA4) に送信する方法

セッションイベントを [GA4](https://marketingplatform.google.com/intl/ja/about/analytics/) のカスタムイベントとして自動送信します。

## 検出条件

`window.gtag` が関数として存在する場合に検出されます。

## 送信方法

```javascript theme={null}
gtag("event", "turnint_started", { type: "started" });
```

<Info>
  GA4 と GTM は排他的に扱われます。`gtag` が検出された場合、`dataLayer` への重複プッシュは行いません。
</Info>

## ヘッドスクリプト設定

ポータルの **ヘッドスクリプト** に以下を貼り付けてください。`G-XXXXXXXXXX` はご自身の測定 ID に置き換えてください。

```html theme={null}
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXXXXX');
</script>
```

## クロスドメイン計測

自社サイト（例: `example.com`）とポータルのドメイン（例: `subdomain.turnint.site`）間でユーザーセッションを一貫して計測するには、GA4 のクロスドメイン設定が必要です。設定しない場合、ポータルへの遷移が新規セッションとして扱われ、コンバージョンの参照元が正しく記録されません。

1. GA4 の **管理** > **データストリーム** でウェブストリームを選択
2. **タグ設定を行う** > **ドメインの設定** を開く
3. **条件を追加** をクリックし、ポータルのドメインを追加:
   * マッチタイプ: **含む**
   * ドメイン: `subdomain.turnint.site`（または独自ドメインを設定している場合はそのドメイン）

<Warning>
  自社サイトとポータルの両方で**同じ測定 ID**（`G-XXXXXXXXXX`）を使用してください。異なる測定 ID を使用するとクロスドメイン計測は機能しません。
</Warning>

## GA4 でのカスタムイベント登録

Turnint AI のイベントをレポートやオーディエンスで活用するには、GA4 にカスタムイベントとして登録する必要があります。

1. GA4 の **管理** > **データの表示** > **イベント** を開く
2. **イベントを作成** をクリック
3. 以下のイベントを登録:

| カスタムイベント名                 | 説明                          |
| ------------------------- | --------------------------- |
| `turnint_started`         | セッション開始                     |
| `turnint_ended`           | セッション終了                     |
| `turnint_slide_viewed`    | スライド閲覧                      |
| `turnint_action_executed` | アクション実行（CTA クリックなど）         |
| `turnint_message_sent`    | メッセージ送信                     |
| `turnint_context_updated` | ゲート（フォームなど）を通じてユーザー情報が識別された |

<Note>
  `turnint_action_executed` をコンバージョンとしてマークすることで、CTA のコンバージョン率を計測できます。
</Note>

## GA4 での確認方法

1. **管理** > **DebugView** でリアルタイムにイベントを確認
2. **レポート** > **エンゲージメント** > **イベント** で `turnint_` プレフィックスのイベントを確認