> ## 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.

# トラッキングパラメータの自動保持

> UTM パラメータ・広告クリック ID・クロスドメインパラメータを自動的にセッションに保存し、リンクへ引き継ぐ仕組み

ウィジェットが埋め込まれたページの URL に含まれるトラッキングパラメータ、および広告プラットフォームが設定する Cookie を**自動的に検出**し、セッションへの保存とリンクへの伝播を行います。追加の設定は不要です。

## 対応パラメータ

### UTM パラメータ

| パラメータ          | 用途                         |
| -------------- | -------------------------- |
| `utm_source`   | 流入元（例: google, newsletter） |
| `utm_medium`   | メディア種別（例: cpc, email）      |
| `utm_campaign` | キャンペーン名                    |
| `utm_term`     | 検索キーワード                    |
| `utm_content`  | 広告コンテンツの識別                 |

### 広告クリック ID

| パラメータ       | プラットフォーム                   |
| ----------- | -------------------------- |
| `gclid`     | Google Ads                 |
| `gbraid`    | Google Ads（プライバシー対応・アプリ）   |
| `wbraid`    | Google Ads（プライバシー対応・ウェブ）   |
| `dclid`     | DoubleClick                |
| `fbclid`    | Meta（Facebook / Instagram） |
| `msclkid`   | Microsoft Ads              |
| `ttclid`    | TikTok Ads                 |
| `twclid`    | X (Twitter) Ads            |
| `epik`      | Pinterest Ads              |
| `sclid`     | Snapchat Ads               |
| `rdt_cid`   | Reddit Ads                 |
| `li_fat_id` | LinkedIn Ads               |
| `click_id`  | MGID 等                     |
| `clickid`   | Mondiad 等                  |
| `dicbo`     | Outbrain                   |
| `tblci`     | Taboola                    |
| `yclid`     | Yahoo! 広告                  |
| `vmcid`     | Yahoo DSP（グローバル）           |
| `ldtag_cl`  | LINE Ads                   |

### クロスドメインパラメータ

| パラメータ | 用途                    |
| ----- | --------------------- |
| `_gl` | GA4 クロスドメインリンカー       |
| `_ga` | ユニバーサルアナリティクス クロスドメイン |

### CRM パラメータ

| パラメータ       | 用途                    |
| ----------- | --------------------- |
| `hubspotid` | HubSpot のコンタクト／リード識別子 |

<Note>
  `hubspotid` は大文字小文字の揺れ（`HubspotId` 等）と、アンダースコア表記（`hubspot_id`）も自動的に正規化され、`hubspotid` として保存されます。HubSpot Contact ID を表す `hs_contact_id` と `hscontactid` も同様に `hubspotid` として扱われます。
</Note>

### 広告プラットフォーム Cookie

URL のクエリパラメータに加え、広告プラットフォームのタグ・ピクセルが設定する Cookie も自動的に読み取ります。

| Cookie 名      | プラットフォーム            |
| ------------- | ------------------- |
| `_gcl_aw`     | Google Ads (gclid)  |
| `_gcl_dc`     | DoubleClick (dclid) |
| `_gcl_gb`     | Google Ads (gbraid) |
| `_fbc`        | Meta (fbclid)       |
| `_fbp`        | Meta ブラウザ ID        |
| `_ttp`        | TikTok Pixel        |
| `_epik`       | Pinterest           |
| `_uetmsclkid` | Microsoft Ads       |
| `_scid`       | Snapchat            |
| `_rdt_uuid`   | Reddit              |
| `_li_fat_id`  | LinkedIn            |

### CRM プラットフォーム Cookie

HubSpot のトラッキングスクリプトが設定する Cookie も自動的に読み取ります。

| Cookie 名     | 用途                    |
| ------------ | --------------------- |
| `hubspotutk` | HubSpot ユーザートークン      |
| `__hstc`     | HubSpot メイン解析 Cookie  |
| `__hssc`     | HubSpot セッション Cookie  |
| `__hsfp`     | HubSpot ブラウザフィンガープリント |

<Note>
  Cookie とクエリパラメータに同じキー名の値が存在する場合、クエリパラメータの値が優先されます。
</Note>

## データフロー

```mermaid theme={null}
flowchart LR
    A1["ページ URL<br/>?utm_source=google&gclid=abc"] --> B["ウィジェット<br/>自動検出"]
    A2["Cookie<br/>_gcl_aw, _fbp 等"] --> B
    B --> C["セッション保存<br/>context.sys.tracking"]
    B --> D["リンク伝播<br/>アクション・外部リンク"]
    C --> E["ダッシュボード<br/>Webhook"]
```

## セッションへの保存

ウィジェットがセッションを開始する際、Cookie およびページ URL からトラッキングパラメータを抽出し、セッションコンテキストの `sys.tracking` に保存します。

```json theme={null}
{
  "context": {
    "sys": {
      "pageUrl": "https://example.com/lp?utm_source=google&gclid=abc123",
      "referrer": "https://google.com",
      "tracking": {
        "utm_source": "google",
        "gclid": "abc123",
        "_gcl_aw": "GCL.1234567890.abc123",
        "_fbp": "fb.1.1234567890.987654321"
      }
    }
  }
}
```

保存されたトラッキングデータは以下から確認できます。

* **ダッシュボード** — セッション詳細画面
* **Webhook** — セッション開始イベントのペイロードに含まれます（[Webhook 連携](/ja/integrations/webhook)）

<Info>
  トラッキングパラメータはページ訪問ごとに URL と Cookie から取得されます。ゲートの設定やフォーム入力とは独立して、常に自動的に保存されます。
</Info>

## リンクへの自動伝播

ウィジェット内に表示されるすべてのリンクに、検出されたトラッキングパラメータが自動的に付与されます。

* **リダイレクトアクション** — 遷移先 URL にパラメータが追加されます
* **埋め込みアクション** — 埋め込み元の URL にパラメータが追加されます
* **エージェントの回答内リンク** — 回答に含まれるリンクにもパラメータが追加されます

<Note>
  リンク先に同名のパラメータがすでに存在する場合は上書きしません。リンク側のパラメータが優先されます。
</Note>

## 関連ドキュメント

* [GA4 連携 — クロスドメイン計測](/ja/integrations/analytics.ga4#クロスドメイン計測)
* [GTM 連携 — クロスドメイン計測](/ja/integrations/analytics.gtm#クロスドメイン計測)
* [Webhook 連携](/ja/integrations/webhook)