> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# セグメントツール

> オーディエンスセグメントを作成および編集するMCPツールです。

セグメントツールは、キャンペーンのターゲットを定義します。セグメントは、デバイス、ロケーション、カスタムデータなどのビジターの条件の集合です。セグメントを使用するすべてのキャンペーンは、その条件に一致するビジターだけをターゲットにします。

## ツール

| ツール | 説明 | プロンプトの例 |
| - | - | - |
| `segment_list` | サイト上のセグメントを、使用数とあわせて一覧表示します。 | "List segments for site `d1alzzxd7k`." |
| `segment_get` | セグメントの条件ツリーを確認します（生のJSONと、人が読める形式の要約）。 | "Show segment `200604`." |
| `segment_create` | 条件ツリーから、オーディエンスセグメントを作成します。セグメントビルダーのすべての条件タイプを受け付けます（ジオロケーション、デバイス、ブラウザー、カスタムデータ、ビジターコード、Cookie、コンバージョンなど）。ツリーは最大 2 階層です。 | "Create a segment for desktop visitors in France." |
| `segment_update` | セグメントの名前、説明、条件を変更します。セグメントビルダーのすべての条件タイプを使用できます。そのセグメントを使用するすべてのキャンペーンは、すぐに新しいオーディエンスをターゲットにします。draftの実験以外で使用されているセグメント、または別のセグメントが参照しているセグメントの条件を変更するには、確認が必要です。 | "Add Belgium to segment `200604`." |
| `segment_delete` | セグメントを削除します。セグメントが使用中の場合（別のセグメントから使われている場合を含む）、ツールはデフォルトで削除をブロックします。`force` で上書きできます。 | "Delete segment `200604`." |

> [!NOTE]
>
> セグメントの条件は最大 2 階層です。トップレベルの `AND` または `OR` で結合された条件のグループです。ツールは、より深い条件ツリーを平坦化せずに、理由を説明して拒否します。平坦化するとオーディエンスが広がる可能性があるためです。AIアシスタントに、ツリーを 2 階層に書き直すよう依頼してください。

## 条件の種類

`segment_create` と `segment_update` は、セグメントビルダーのすべての条件タイプを受け付けます。ジオロケーション、デバイスタイプ、ブラウザー、カスタムデータなどの既存の条件もそのまま使えます。次のグループも利用できます。

* ビジターコード（`VISITOR_CODE`）、Cookie（`COOKIE`）、JSコード（`JS_CODE`）、広告ブロッカー（`AD_BLOCKER`）。
* SDKの言語とアプリのバージョン（`SDK_LANGUAGE`、`APPLICATION_VERSION`）。
* コンバージョン（`CONVERSIONS`）。
* AI Targeting（`HEAT_SLICE`）。
* ターゲット実験、パーソナライゼーション、またはフィーチャーフラグ（`TARGET_EXPERIMENT`、`TARGET_PERSONALIZATION`、`TARGET_FEATURE_FLAG`）。
* 排他的な実験（`EXCLUSIVE_EXPERIMENT`）。
* 別のセグメント（`SEGMENT`）。
* Tealiumのオーディエンスとバッジ（`TEALIUM_AUDIENCE`、`TEALIUM_BADGE`）。

除外できない条件（つまり、排他的な実験、新規または再訪問のビジター、イベント）は、`include` に切り替える代わりに、`include=false` を拒否します。別のセグメントが使用しているセグメントを削除するには `force` が必要です。そのセグメントの条件を変更するには、`confirm` で確認が必要です。ツールは、別のサイトのゴール、実験、フィーチャーフラグ、セグメントへの参照を拒否します。

## パラメータ

`tools/list` が返す正確なパラメータ名を使用してください。

| ツール | 必須パラメータ | オプションのパラメータ |
| - | - | - |
| `segment_list` | なし | `siteCode`、`query`、`page`、`perPage` |
| `segment_get` | `segmentId` | なし |
| `segment_create` | `name`、`siteCode` | `conditionDataTree`（セグメントビルダーの任意の条件タイプ）、`description` |
| `segment_update` | `segmentId` | `name`、`description`、`conditionDataTree`（ツリー全体を置き換えます。セグメントビルダーの任意の条件タイプ）、`confirm`（draftの実験以外、または別のセグメントが使用しているセグメントの条件を変更する場合に必須） |
| `segment_delete` | `segmentId` | `force`（実験、パーソナライゼーション、フィーチャーフラグ、または別のセグメントがそのセグメントを使用している場合に必須） |