# UTM 유입 경로 추적

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

> UTM 유입 경로 추적은 각 응답이 어디에서 왔는지 표시해 채널별 성과를 비교할 수 있게 해 줍니다. 소스·매체·캠페인 같은 UTM 매개변수의 의미, 채널마다 태그가 붙은 링크를 만드는 방법, 그리고 수집된 유입 경로 데이터가 응답 기록과 인사이트 중 어디에 표시되는지 설명합니다.

같은 퀴즈를 여러 채널에 배포할 때 **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/ko/publish/promotion)을 참고하세요.

UTM 값에는 영문자, 숫자, 밑줄, 하이픈만 사용할 수 있습니다.

웹사이트 임베드에도 UTM 태그를 붙일 수 있습니다. [임베드](https://docs.rooquiz.com/ko/publish/embed#사용할-수-있는-속성)의 `data-rooquiz-utm-*` 속성을 참고하세요.

## 유입 경로 데이터 보기

응답자가 UTM 태그가 붙은 링크로 제출하면 유입 경로가 응답과 함께 기록됩니다. 배포 계획에서 만든 링크든 직접 만든 링크든, 모든 링크의 UTM 매개변수(`utm_source`, `utm_medium`, `utm_campaign`)가 이렇게 저장됩니다. [응답 기록](https://docs.rooquiz.com/ko/results/records)과 [인사이트](https://docs.rooquiz.com/ko/results/insights)에서 유입 경로별로 구분하고 분석할 수 있습니다.

<Callout type="info">
  채널마다 **명확하고 일관된 이름 규칙**(예: 모두 소문자, 하이픈으로 구분)을 사용하면 이후 분석이 깔끔해집니다.
</Callout>

## URL 매개변수(숨은 필드)

UTM은 유입 채널을 다룹니다. 그 밖의 정보(어느 **파트너**, 어떤 **캠페인 ID**, 어느 **랜딩 페이지**에서 왔는지)를 링크에서 기록하려면 직접 URL 매개변수를 선언하세요.

값은 보통 외부에서 들어옵니다. 이메일 도구의 병합 태그(`?crm_id={{contact.id}}` 등), 퀴즈를 임베드한 페이지 주소, 파트너마다 나눠 주는 전용 링크 같은 것들입니다. 유입 채널만 구분하려면 대신 [배포 계획](https://docs.rooquiz.com/ko/publish/promotion)을 사용하세요. UTM을 자동으로 붙이고 채널별 수치도 보여 줍니다.

<Steps>
  ### 매개변수 선언

  퀴즈에서 **공유** → **URL 매개변수**를 열고 `partner`, `campaign_id` 같은 이름을 추가합니다. 영문 소문자, 숫자, 밑줄만 쓸 수 있으며 퀴즈당 최대 10개입니다. `utm_*`와 `email`, `name`, `lang`, `ref` 같은 시스템 이름은 사용할 수 없습니다.

  ### 링크에 추가

  퀴즈 링크 뒤에 값을 붙입니다: `https://YOUR_QUIZ_LINK?partner=acme&campaign_id=spring`.
</Steps>

값은 응답마다 저장되며 [응답 기록](https://docs.rooquiz.com/ko/results/records) 상세, 내보내기(매개변수마다 한 열), Webhook과 Zapier의 `metadata.params`에 나타납니다. 선언한 매개변수만 저장되고 링크의 다른 매개변수는 무시됩니다. 값은 최대 256자입니다. 모든 요금제에서 사용할 수 있습니다.

<Callout type="info">
  결과 페이지에서 공유한 링크에는 이 매개변수가 포함되지 않으므로, 친구의 응답이 원래 파트너나 캠페인으로 집계되지 않습니다.
</Callout>

## 링크로 리드 양식 미리 채우기

퀴즈 링크에 `?email=`(필요하면 `?name=`도)을 붙이면(예: 뉴스레터) 리포트 전 리드 양식이 미리 채워집니다. 입력만 줄여 줄 뿐 응답자는 평소처럼 이메일 인증을 거칩니다. 값은 페이지가 로드되자마자 주소창에서 제거되어 Google Analytics나 광고 픽셀에 전달되지 않습니다.

<Callout type="warning">
  이메일 주소가 링크 자체에 들어가므로 서버 로그, 브라우저 기록, 링크가 전달된 곳 어디에든 남을 수 있습니다. 미리 채우기 링크는 본인에게 보내는 이메일처럼 1:1 채널에서만 사용하고, 공개 페이지나 광고에는 쓰지 마세요.
</Callout>
