> 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/ja/settings/site/parameter-settings.md).

# パラメータ設定

gelatto および genser への流入経路を計測できるよう、URLにUTMパラメータおよびカスタムパラメータを設定するページです。保有する権限によって表示される項目が異なる場合があります。

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

***

## **1. gelatto**

{% hint style="info" %}
gelattoのパラメータ設定は、サイトIDの登録を前提条件とします。\
`[基本設定 > サイトID]`でサイトIDの登録状態を先にご確認ください。
{% endhint %}

### **1-1. UTMパラメータ**

Web解析ツールで汎用的に認識される標準パラメータです。デフォルト値を使用するか、値を直接設定できます。

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

#### **使用有無の選択**

Switchをオンにすると、パラメータの適用方法を選択できます。

* デフォルト値：gelattoが自動生成したUTM値を使用します。
* 直接設定：UTMパラメータの値を直接登録します。

#### **デフォルト値**

自動生成されたUTM値が読み取り専用で表示され、別途登録・変更する必要はありません。

| Key          | Value                |
| ------------ | -------------------- |
| `utm_source` | `gelatto.jp`に固定されます。 |
| `utm_medium` | `referral`に固定されます。   |

#### **直接設定 > パラメータ登録**

**\[登録]**&#x3092;クリックする&#x3068;**\[UTMパラメータ登録]**&#x30E2;ーダルが開きます。

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

| 項目        | 説明                                                                                                                                                                                                                           |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Key       | <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> |
| Value（必須） | スペースを含め最大200文字まで入力できます。日本語、スペース、特殊文字などはURLエンコードされて適用されます。                                                                                                                                                                    |
| 詳細説明      | スペースを含め最大45文字まで入力できます。先頭にスペースは入力できません。                                                                                                                                                                                       |

<figure><img src="/files/5N1O3gX0u0Vhi6OLNIKc" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
UTMパラメータは最大5個まで登録できます。
{% endhint %}

UTMパラメータの設定を変更した後は、**\[保存]**&#x30DC;タンをクリックすると反映されます。

***

## **2. genser**

{% hint style="info" %}
genserのパラメータ設定は、ドメインの正常な接続を前提条件とします。\
`[基本設定 > genser]`でドメインの接続状態を先にご確認ください。
{% endhint %}

### **2-1. UTMパラメータ**

Web解析ツールで汎用的に認識される標準パラメータです。デフォルト値を使用するか、値を直接設定できます。

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

#### **使用有無の選択**

Switchをオンにすると、パラメータの適用方法を選択できます。

* デフォルト値：自動生成されたUTM値を使用します。
* 直接設定：UTMパラメータの値を直接登録します。

#### **デフォルト値**

自動生成されたUTM値が読み取り専用で表示され、別途登録・変更する必要はありません。

| Key          | Value                                                         |
| ------------ | ------------------------------------------------------------- |
| `utm_source` | `[基本設定 > genser]`に登録したドメイン値が自動設定されます。（例：`aishop.example.com`） |
| `utm_medium` | `referral`に固定されます。                                            |

#### **直接設定 > パラメータ登録**

**\[登録]**&#x3092;クリックする&#x3068;**\[UTMパラメータ登録]**&#x30E2;ーダルが開きます。

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

| 項目        | 説明                                                                                                                                                                                                                           |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Key       | <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> |
| Value（必須） | スペースを含め最大200文字まで入力できます。日本語、スペース、特殊文字などはURLエンコードされて適用されます。                                                                                                                                                                    |
| 詳細説明      | スペースを含め最大45文字まで入力できます。先頭にスペースは入力できません。                                                                                                                                                                                       |

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

{% hint style="warning" %}
UTMパラメータは最大5個まで登録できます。
{% endhint %}

### **2-2. カスタムパラメータ**

UTM以外に必要なパラメータを、KeyとValueの形式で登録できます。

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

#### **パラメータ登録**

**\[登録]**&#x3092;クリックする&#x3068;**\[カスタムパラメータ登録]**&#x30E2;ーダルが開きます。

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

| 項目        | 説明                                                                                        |
| --------- | ----------------------------------------------------------------------------------------- |
| Key（必須）   | テキストを直接入力する方式です。英数字、ハイフン（`-`）、アンダースコア（`_`）のみ入力可能で、最大50文字です。日本語、スペース、その他の特殊文字・絵文字は入力できません。 |
| Value（必須） | スペースを含め最大200文字まで入力できます。日本語、スペース、特殊文字などはURLエンコードされて適用されます。                                 |
| 詳細説明      | スペースを含め最大45文字まで入力できます。先頭にスペースは入力できません。                                                    |

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

{% hint style="warning" %}
カスタムパラメータは最大10個まで登録できます。
{% endhint %}

UTMパラメータとカスタムパラメータは、1つ&#x306E;**\[保存]**&#x30DC;タンでまとめて保存されます。

***

## **よくある質問**

<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. genserでパラメータ設定が表示されません。</strong></summary>

genserのパラメータ設定は、ドメインが正常に接続されている場合にのみ使用できます。`[基本設定 > genser]`でドメインの接続状態を先にご確認ください。

</details>

<details>

<summary><strong>Q. Valueに日本語やスペースを入力するとどうなりますか？</strong></summary>

入力自体は可能ですが、実際のURLには自動的にエンコードされて反映されます。例えば、スペースは`%20`に、日本語はUTF-8基準のパーセントエンコード値に変換されます。

</details>