# Advocateユーザーセグメントを管理する
セグメンテーションとは、Advocateプログラムの参加者を共通の特性に基づくユーザーセグメント（グループ）に分割するプロセスです。参加者をセグメント化することで、彼らの興味をよりよく理解し、活動を追跡し、ニーズに合った価値をより正確に提供できます。
{% tabs %}
{% tab title="人口統計学的要因" %}
一般的なセグメンテーション基準には、次のような人口統計学的要因が含まれます：
* 年齢
* 性別
* 居住地
* 職種・業界
* 就業先
* 収入
{% endtab %}
{% tab title="関係性に関する要因" %}
ユーザーを、ビジネスとの関係に関連する次のような特性に基づいてセグメント化することもあります：
* 会員ステータス
* サブスクリプションプランの階層
* 最終購入日
* サインアップ日
* デバイス
{% endtab %}
{% endtabs %}
#### ユーザーセグメントの管理
Advocateプログラムでは、新しいユーザーセグメントを作成したり、個別の参加者をセグメントに追加したり、参加者を一括でセグメントに追加したり、セグメントから参加者を削除したりできます。
{% stepper %}
{% step %}
#### **ステップ1：ユーザーセグメントを作成する**
1. 左側のナビゲーションメニューで、次を選択します  **\[Engage] → Data Sources → Segments**.
2. を選択します **セグメントを追加**.
3. の **名前** 欄に、そのセグメントの説明的な名前を入力します。
4. を選択します **追加**.
{% endstep %}
{% step %}
#### **ステップ2：単一の参加者をユーザーセグメントに追加する**
1. 左側のナビゲーションメニューで、次を選択します  **\[Engage] → Participants**.
2. ユーザーセグメントに追加したい特定の参加者を検索します。
3. 参加者の名前を選択してその参加者プロファイルを読み込みます。
4. の *セグメント* カードで、次を選択します **セグメントを追加**.
5. この参加者を含めたいユーザーセグメントを選択します。
{% endstep %}
{% step %}
#### **ステップ3：参加者をユーザーセグメントに一括追加する**
1. 左側のナビゲーションメニューで、次を選択します  **\[Engage] → Data Sources→ Segments**.
2. ユーザーを追加したいセグメントの名前を見つけます。
3. 参加者を追加したいセグメント名にカーソルを合わせて、次を選択します **ユーザーを追加**.
4. インポートタイプを選択します **ユーザー**.
5. 次の [サンプルCSV](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv)を使用して、特定のユーザーセグメントに含めたいすべての参加者のリストを作成します。
6. を選択します **ファイルを選択** を選択して、準備したCSVファイルを指定します。
7. ドロップダウンリストを使用して、これらの参加者を追加したいセグメントを選択します。
8. を選択します **インポートを開始**.
{% endstep %}
{% step %}
#### **ステップ4：参加者をユーザーセグメントから削除する**
1. 左側のナビゲーションメニューで、次を選択します  **\[Engage] → Participants**.
2. ユーザーセグメントに追加したい特定の参加者を見つけます。
3. 参加者の名前を選択してその参加者プロファイルを読み込みます。
4. ユーザー概要の左下で、次を選択します  **\[キャンセル]** 参加者がもはや所属すべきでないセグメントの右側にあるボタンを押してください。
{% endstep %}
{% endstepper %}
#### Advocate APIとUTTによるセグメンテーション
Advocate REST APIとUTT Javascriptライブラリを使用して、参加者がどのセグメントのメンバーであるかをプログラムから管理することもできます。
この機能には、API呼び出しまたはUTTメソッドのユーザーオブジェクトに、次のいずれかまたは複数の「操作」（セグメント名と演算子の組み合わせ）を含めることでアクセスできます。
これらの操作を使用する詳細は、UTT JavascriptライブラリおよびAPIメソッドの [ユーザーAPIドキュメント](https://integrations.impact.com/impact-brand/reference/user).
{% tabs %}
{% tab title="演算子" %}
次の演算子は、ユーザーセグメンテーションの基礎となる *操作*であり、参加者がどのセグメントのメンバーであるかを管理するために使用されます。
| 演算子 | 説明 | 例 |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------- | -------------- |
| 追加 | セグメントキーだけを指定すると、参加者をそのセグメントに追加しようとします。参加者がすでにそのセグメントの一部である場合は、何も行われません。 | `mySegmentKey` |
| 削除 | セグメントキーを *前に* を付けて含めると、Advocateに対して参加者をそのセグメントから削除するよう指示します。参加者がすでにそのセグメントに所属していない場合は、何も行われません。 `~` 〜mySegmentKey | `クリア` |
| キーを | 前に *を付けて含めると、Advocateに対して参加者が現在属しているすべてのセグメントから参加者を削除するよう指示します。*次の `~` 演算子を使用して構築された操作により、ユーザーがどのセグメントに属しているかを管理できます。 | `~` |
| {% endtab %} | | |
{% tab title="操作" %}
次の操作は、利用可能な *演算子*を使用して構築され、ユーザーがどのセグメントに属しているかを管理できるようにします。
| 操作 | 説明 | 例 |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
| 追加 | 参加者をセグメントに追加します。他の既存のセグメントは保持されます。 | `{ "id" : "abc_123", ... "segments" : ["A"] }` |
| 設定 | 参加者のセグメントを設定します。他の既存のセグメントはすべて削除されます。
重要： 順序が重要です！ セット操作を行うには、クリア 演算子 (\~) を最初に含める必要があります。
| `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| 削除する | 参加者をセグメントから削除します。他の既存のセグメントは保持されます。 | `{ "id" : "abc_123", ... "segments" : ["~A"] }` |
| キーを | 参加者に設定されているすべてのセグメントをクリアします。 | `{ "id" : "abc_123", ... "segments" : ["~*"] }` |
| {% endtab %} | | |
| {% endtabs %} | | |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.