> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/settings/site/parameter-settings.md).

# 파라미터 설정

젤라또 및 젠서 디스커버리에 유입되는 방문자의 출처를 추적할 수 있도록, URL에 UTM 파라미터와 커스텀 파라미터를 설정하는 페이지입니다. 보유한 권한에 따라 표시되는 항목이 다를 수 있습니다.

<figure><img src="/files/y23meprjhVpSljHx1jgA" alt=""><figcaption></figcaption></figure>

***

## **1. 젤라또**

### **1-1. UTM 파라미터**

웹 분석 도구에서 범용으로 인식되는 표준 파라미터입니다. 기본값을 사용하거나, 직접 값을 설정할 수 있습니다.

<figure><img src="/files/Jee0wxemplCL0maEKy2t" alt=""><figcaption></figcaption></figure>

#### **적용 방식**

기본값이 적용된 상태로 시작합니다. 필요하면 직접 설정으로 바꿀 수 있습니다.

* 기본값: 젤라또에서 자동으로 생성한 UTM 값을 사용합니다.
* 직접 설정: UTM 파라미터 값을 직접 등록합니다.

#### **기본값**

자동으로 생성된 UTM 값이 읽기 전용으로 표시되며, 별도로 등록하거나 수정할 필요가 없습니다.

<table><thead><tr><th width="160.3519287109375">Key</th><th>Value</th></tr></thead><tbody><tr><td><code>utm_source</code></td><td><code>gelatto.ai</code>로 고정됩니다.</td></tr><tr><td><code>utm_medium</code></td><td><code>referral</code>로 고정됩니다.</td></tr></tbody></table>

#### **직접 설정 > 파라미터 등록**

**\[등록]** 클릭 시 **\[UTM 파라미터 등록]** 모달이 열립니다.

<figure><img src="/files/zHwhr0OH4oSSA74BixBh" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.0758056640625">항목</th><th>설명</th></tr></thead><tbody><tr><td>Key</td><td><p>파라미터 항목당 1개만 등록 가능하며, 선택 가능한 Key는 다음과 같습니다.</p><ul><li><code>utm_source</code></li><li><code>utm_medium</code></li><li><code>utm_campaign</code></li><li><code>utm_term</code></li><li><code>utm_content</code></li></ul></td></tr><tr><td>Value (필수)</td><td>공백 포함 최대 200자 입력 가능합니다. 한글, 공백, 특수문자 등은 URL 인코딩되어 적용됩니다.</td></tr><tr><td>상세 설명</td><td>공백 포함 최대 45자 입력 가능하며, 맨 앞에는 공백을 입력할 수 없습니다.</td></tr></tbody></table>

<figure><img src="/files/1mASnTF7CbrZQMcQzgAO" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
UTM 파라미터는 최대 5개까지 등록할 수 있습니다.
{% endhint %}

UTM 파라미터 설정을 변경한 후에는 **\[저장]** 버튼을 클릭해야 반영됩니다.

***

## **2. 젠서 디스커버리**

### **2-1. UTM 파라미터**

웹 분석 도구에서 범용으로 인식되는 표준 파라미터입니다. 기본값을 사용하거나, 직접 값을 설정할 수 있습니다.

<figure><img src="/files/VfiFHIc88nz6ZsuiOUbI" alt=""><figcaption></figcaption></figure>

#### **적용 방식**

기본값이 적용된 상태로 시작합니다. 필요하면 직접 설정으로 바꿀 수 있습니다.

* 기본값: 자동으로 생성한 UTM 값을 사용합니다.
* 직접 설정: UTM 파라미터 값을 직접 등록합니다.

#### **기본값**

자동으로 생성된 UTM 값이 읽기 전용으로 표시되며, 별도로 등록하거나 수정할 필요가 없습니다.

<table><thead><tr><th width="159.7423095703125">Key</th><th>Value</th></tr></thead><tbody><tr><td><code>utm_source</code></td><td><code>[기본 설정 > 젠서 디스커버리]</code>에 연결한 커스텀 도메인이 값으로 들어갑니다. (예: <code>aishop.example.com</code>)</td></tr><tr><td><code>utm_medium</code></td><td><code>referral</code>로 고정됩니다.</td></tr></tbody></table>

{% hint style="info" %}
도메인 연결이 완료되기 전에는 `utm_source` 값이 대시(`-`)로 표시됩니다. 이 상태에서도 설정을 저장할 수 있으며, `[기본 설정 > 젠서 디스커버리]`에서 도메인 연결을 완료하면 값이 자동으로 표시됩니다.
{% endhint %}

#### **직접 설정 > 파라미터 등록**

**\[등록]** 클릭 시 **\[UTM 파라미터 등록]** 모달이 열립니다.

<figure><img src="/files/o6ydGmMUyknJ97hA6z0b" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.1798095703125">항목</th><th>설명</th></tr></thead><tbody><tr><td>Key</td><td><p>파라미터 항목당 1개만 등록 가능하며, 선택 가능한 Key는 다음과 같습니다.</p><ul><li><code>utm_source</code></li><li><code>utm_medium</code></li><li><code>utm_campaign</code></li><li><code>utm_term</code></li><li><code>utm_content</code></li></ul></td></tr><tr><td>Value (필수)</td><td>공백 포함 최대 200자 입력 가능합니다. 한글, 공백, 특수문자 등은 URL 인코딩되어 적용됩니다.</td></tr><tr><td>상세 설명</td><td>공백 포함 최대 45자 입력 가능하며, 맨 앞에는 공백을 입력할 수 없습니다.</td></tr></tbody></table>

<figure><img src="/files/zRNJzD4ngNu4uLTNgoWf" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
UTM 파라미터는 최대 5개까지 등록할 수 있습니다.
{% endhint %}

### **2-2. 커스텀 파라미터**

UTM 외에 필요한 파라미터를 key와 value 형태로 등록할 수 있습니다. Switch를 켜면 파라미터를 등록할 수 있습니다.

<figure><img src="/files/nO9Qv3qAT65rFanYya0K" alt=""><figcaption></figcaption></figure>

#### **파라미터 등록**

**\[등록]** 클릭 시 **\[커스텀 파라미터 등록]** 모달이 열립니다.

<figure><img src="/files/fxJVlNEiZrWC2lq3VvTb" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="159.97802734375">항목</th><th>설명</th></tr></thead><tbody><tr><td>Key (필수)</td><td>텍스트 직접 입력 방식입니다. 영문, 숫자, 하이픈(<code>-</code>), 언더스코어(<code>_</code>)만 입력 가능하며 최대 50자입니다. 한글, 공백, 그 외 특수문자·이모지는 입력할 수 없습니다.</td></tr><tr><td>Value (필수)</td><td>공백 포함 최대 200자 입력 가능합니다. 한글, 공백, 특수문자 등은 URL 인코딩되어 적용됩니다.</td></tr><tr><td>상세 설명</td><td>공백 포함 최대 45자 입력 가능하며, 맨 앞에는 공백을 입력할 수 없습니다.</td></tr></tbody></table>

<figure><img src="/files/9mDH8KAsuZVoZ2nsBCkO" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
커스텀 파라미터는 최대 10개까지 등록할 수 있습니다.
{% endhint %}

UTM 파라미터와 커스텀 파라미터는 하나의 **\[저장]** 버튼으로 함께 저장됩니다.

***

## **자주 묻는 질문**

<details>

<summary><strong>Q. UTM 파라미터와 커스텀 파라미터는 몇 개까지 등록할 수 있나요?</strong></summary>

UTM 파라미터는 최대 5개(`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`), 커스텀 파라미터는 최대 10개까지 등록할 수 있습니다.

</details>

<details>

<summary><strong>Q. 커스텀 파라미터 Key에 한글이나 특수문자를 사용할 수 있나요?</strong></summary>

아니요. 커스텀 파라미터 Key는 영문, 숫자, 하이픈(-), 언더스코어(\_)만 입력할 수 있습니다. 한글, 공백, 그 외 특수문자와 이모지는 입력되지 않습니다.

</details>

<details>

<summary><strong>Q. 커스텀 파라미터 Key로 utm_source 같은 이름을 등록할 수 있나요?</strong></summary>

등록할 수 없습니다. UTM 파라미터 전용 Key(utm\_source, utm\_medium, utm\_campaign, utm\_term, utm\_content)와 대소문자 구분 없이 일치하는 값은 예약어로 간주되어 에러 처리됩니다.

</details>

<details>

<summary><strong>Q. 젠서 디스커버리 utm_source 값이 대시(-)로 표시됩니다.</strong></summary>

기본값의 `utm_source`에는 연결한 커스텀 도메인이 들어갑니다. `[기본 설정 > 젠서 디스커버리]`에서 도메인 연결을 완료하면 값이 자동으로 표시됩니다. 도메인 연결 전에도 파라미터 설정을 저장할 수 있습니다.

</details>

<details>

<summary><strong>Q. Value에 한글이나 공백을 입력하면 어떻게 되나요?</strong></summary>

입력 자체는 가능하지만, 실제 URL에는 자동으로 인코딩되어 반영됩니다. 예를 들어 공백은 `%20`으로, 한글은 UTF-8 기준 퍼센트 인코딩 값으로 변환됩니다.

</details>