# UTM による流入元トラッキング

Source: https://docs.rooquiz.com/ja/publish/tracking

> UTM による流入元トラッキングは、各回答がどこから来たのかにラベルを付け、チャネルごとの効果を比較できるようにする仕組みです。ソース・メディア・キャンペーンといった各パラメーターの意味、チャネルごとにタグ付きリンクを作成する方法、集計された数値を確認できる場所、命名のコツを説明します。配信プランとの併用にも役立ちます。

同じクイズを複数のチャネルで配信する場合、**UTM による流入元トラッキング** を使うと、各回答がどこから来たのかを区別でき、チャネルごとの効果を評価できます。

## UTM とは

UTM は、リンクに付け加えてトラフィックの流入元にラベルを付けるためのパラメーターのセットです。よく使われるものは次のとおりです。

* **ソース**:例 `facebook`、`linkedin`、`x`、`newsletter`。
* **メディア**:例 `post`、`bio`、`email`、`cpc`。
* **キャンペーン**:今回のキャンペーンの名前。例 `spring-launch`。

## 使い方

対象のクイズで **共有** → **配信プラン** を開きます。組み込みの各チャネルのカードには、すでに専用の UTM 付きリンクがあります。それ以外のチャネルでは、**チャネルを追加** をクリックして **utm\_source**(必須)、**utm\_medium** と **utm\_campaign**(どちらも任意)を入力すると、新しいカードに専用のトラッキング付きリンクが用意されます。[配信プラン](https://docs.rooquiz.com/ja/publish/promotion)をご覧ください。

UTM の値に使えるのは、英字、数字、アンダースコア、ハイフンだけです。

ウェブサイトの埋め込みにも UTM タグを付けられます。[埋め込み](https://docs.rooquiz.com/ja/publish/embed#使える属性)の `data-rooquiz-utm-*` 属性をご覧ください。

## 流入元のデータを確認する

回答者が UTM 付きのリンクから回答を送信すると、流入元が回答と一緒に記録されます。リンクに付いた UTM パラメーター(`utm_source`、`utm_medium`、`utm_campaign`)は、配信プランから作ったリンクでも手作業で作ったリンクでも、同じように保存されます。[回答記録](https://docs.rooquiz.com/ja/results/records)と[インサイト](https://docs.rooquiz.com/ja/results/insights)で、流入元ごとに区別して分析できます。

<Callout type="info">
  チャネルごとに **わかりやすく一貫した命名**(例:すべて小文字、ハイフン区切り)を使うと、後の分析がすっきりします。
</Callout>

## URL パラメータ（隠しフィールド）

UTM が扱うのは流入チャネルです。それ以外の情報（どの**パートナー**、どの**キャンペーン ID**、どの**ランディングページ**から来たか）をリンクから記録したい場合は、独自の URL パラメータを宣言します。

値はふつう外部から入ります。メール配信ツールの差し込みタグ（`?crm_id={{contact.id}}` など）、クイズを埋め込んだページのアドレス、パートナーごとに渡す専用リンクなどです。流入チャネルを見分けたいだけなら、代わりに[配信プラン](https://docs.rooquiz.com/ja/publish/promotion)を使ってください。UTM を自動で付け、チャネルごとの数字も確認できます。

<Steps>
  ### パラメータを宣言する

  クイズで **共有** → **URL パラメータ** を開き、`partner` や `campaign_id` などの名前を追加します。小文字・数字・アンダースコアのみ、1 つのクイズにつき最大 10 個です。`utm_*` と、`email`・`name`・`lang`・`ref` などのシステム名は使えません。

  ### リンクに付ける

  クイズのリンクに値を付けます：`https://YOUR_QUIZ_LINK?partner=acme&campaign_id=spring`。
</Steps>

値は回答ごとに保存され、[回答記録](https://docs.rooquiz.com/ja/results/records)の詳細、エクスポート（パラメータごとに 1 列）、Webhook と Zapier の `metadata.params` に表示されます。保存されるのは宣言したパラメータだけで、リンク上のそれ以外のパラメータは無視されます。値は最大 256 文字です。すべてのプランで利用できます。

<Callout type="info">
  結果ページから共有されたリンクにはこれらのパラメータは付かないため、友人の回答が元のパートナーやキャンペーンに計上されることはありません。
</Callout>

## リンクでリード獲得フォームを事前入力する

クイズのリンクに `?email=`（必要なら `?name=` も）を付けると（メールマガジンなどで）、レポート前のリード獲得フォームがあらかじめ入力されます。入力の手間を省くだけで、回答者は通常どおりメール認証を行います。値はページの読み込み直後にアドレスバーから削除され、Google Analytics や広告ピクセルには渡りません。

<Callout type="warning">
  メールアドレスはリンクそのものに含まれるため、サーバーのログやブラウザの履歴、リンクの転送先に残る可能性があります。事前入力リンクは本人宛てのメールなど 1 対 1 のチャネルでのみ使い、公開ページや広告には載せないでください。
</Callout>
