# UTM 來源追蹤

Source: https://docs.rooquiz.com/zh-TW/publish/tracking

> 當你在多個管道分發同一個測驗時，UTM 來源追蹤能幫你區分每條作答來自哪裡，從而評估各管道的效果。這一頁解釋 source、medium、campaign 等參數分別代表什麼、怎麼為每個管道拼出帶標記的連結、在後台哪裡檢視來源資料，以及和分發計畫的關係。同一份測評可以生成多條帶不同標記的連結，回到後台就能按來源對比轉化效果。

當你在多個管道分發同一個測驗時,**UTM 來源追蹤**能幫你區分每條作答來自哪裡,從而評估各管道效果。

## 什麼是 UTM

UTM 是附加在連結末尾的一組參數,用來標註流量來源,常見包括:

* **來源(source)**:如 `facebook`、`linkedin`、`x`、`newsletter`。
* **媒介(medium)**:如 `post`、`bio`、`email`、`cpc`。
* **活動(campaign)**:本次推廣活動的名稱,如 `spring-launch`。

## 使用方式

在目標測驗中開啟 **分享** → **分發計畫**。每張內建管道卡片都已經帶有自己的 UTM 追蹤連結。其他管道點 **新增渠道**,填寫 **utm\_source**(必填)、**utm\_medium** 與 **utm\_campaign**(皆為可選),新卡片會有自己的追蹤連結。見 [分發計畫](https://docs.rooquiz.com/zh-TW/publish/promotion)。

UTM 值僅支援字母、數字、底線和連字號。

網站嵌入同樣可以帶 UTM 參數——見 [網站嵌入](https://docs.rooquiz.com/zh-TW/publish/embed#可用屬性) 裡的 `data-rooquiz-utm-*` 屬性。

## 檢視來源資料

答題者透過帶 UTM 的連結提交後,來源資訊會隨作答一併記錄。任何連結上的 UTM 參數(`utm_source`、`utm_medium`、`utm_campaign`)都會這樣儲存,不論連結來自分發計畫還是你手動拼接。你可以在 [答卷記錄](https://docs.rooquiz.com/zh-TW/results/records) 與 [數據洞察](https://docs.rooquiz.com/zh-TW/results/insights) 中按來源進行區分與分析。

<Callout type="info">
  為每個管道使用**清晰一致的命名**(如統一用小寫、用連字元分隔),能讓後續的資料分析更整潔。
</Callout>

## URL 參數（隱藏欄位）

UTM 解決的是管道。想從連結上記錄其他資訊——例如作答者是哪個**合作夥伴**、哪個**活動 ID**、哪個**到達頁**帶來的——可以自訂 URL 參數。

參數值通常來自外部：郵件工具的合併標籤（如 `?crm_id={{contact.id}}`）、嵌入測驗的網頁網址，或發給每個合作夥伴的專屬連結。如果只是想區分管道，請改用[分發計畫](https://docs.rooquiz.com/zh-TW/publish/promotion)：它會自動加上 UTM，還能看到每個管道的數據。

<Steps>
  ### 宣告參數

  在測驗裡開啟 **分享** → **URL 參數**，填上參數名稱，例如 `partner`、`campaign_id`。只能使用小寫字母、數字和底線，每個測驗最多 10 個。`utm_*` 以及 `email`、`name`、`lang`、`ref` 等系統參數名稱不能使用。

  ### 加到連結上

  在測驗連結後面帶上值：`https://你的測驗連結?partner=acme&campaign_id=spring`。
</Steps>

這些值會隨每份作答儲存，出現在[作答紀錄](https://docs.rooquiz.com/zh-TW/results/records)詳情裡、匯出檔案裡（每個參數一欄），以及 Webhook 和 Zapier 推送的 `metadata.params` 裡。只儲存宣告過的參數，連結上的其他參數一律忽略；每個值最長 256 個字元。所有方案都可使用。

<Callout type="info">
  從結果頁分享出去的連結不會帶這些參數，朋友的作答不會算到原本的合作夥伴或活動上。
</Callout>

## 用連結預先填好留資表單

在測驗連結上加 `?email=`（也可以再加 `?name=`）——例如放在電子報裡——看報告前的留資表單就會預先填好。它只是省去輸入：作答者仍要照常驗證信箱。頁面一載入，這些值就會從網址列移除，Google Analytics 和廣告像素都看不到。

<Callout type="warning">
  信箱地址是直接寫在連結裡的，可能出現在伺服器日誌、瀏覽器記錄以及連結被轉寄到的任何地方。預先填寫的連結只用在一對一的管道，例如寄給本人的電子郵件；不要放在公開頁面或廣告裡。
</Callout>
