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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.