> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md).
# Advocateユーザーセグメントを管理する
セグメンテーションとは、Advocateプログラムの参加者を、共通の特性に基づいてユーザーセグメント、つまりグループに分けるプロセスです。参加者をセグメント化することで、興味をよりよく理解し、アクティビティを追跡し、ニーズに合った価値をより正確に提供できます。
{% tabs %}
{% tab title="人口統計学的要因" %}
一般的なセグメンテーション基準には、次のような人口統計学的要因が含まれます：
* 年齢
* 性別
* 所在地
* 業界
* 勤務先
* 収入
{% endtab %}
{% tab title="関係性要因" %}
また、ビジネスとの関係に関連する次のような特性に基づいてユーザーをセグメント化することもできます：
* 会員ステータス
* サブスクリプションプランの階層
* 最後の購入日
* 登録日
* デバイス
{% endtab %}
{% endtabs %}
#### ユーザーセグメントを管理する
Advocateプログラムでは、新しいユーザーセグメントの作成、個々の参加者のユーザーセグメントへの追加、参加者のユーザーセグメントへの一括追加、ユーザーセグメントからの参加者の削除ができます。
{% stepper %}
{% step %}
**ステップ1: ユーザーセグメントを作成する**
1. 左側のナビゲーションメニューで、次を選択します  **\[Engage] → データソース → セグメント**.
2. 選択してください **セグメントを追加**.
3. の **名前** フィールドに、セグメントの説明的な名前を入力します。
4. 選択してください **追加**.
{% endstep %}
{% step %}
**ステップ2: 単一の参加者をユーザーセグメントに追加する**
1. 左側のナビゲーションメニューで、次を選択します  **\[Engage] → 参加者**.
2. ユーザーセグメントに追加したい特定の参加者を検索します。
3. 名前を選択して、参加者プロフィールを読み込みます。
4. 次の *セグメント* カードで、 **セグメントを追加**.
5. この参加者を含めたいユーザーセグメントを選択します。
{% endstep %}
{% step %}
**ステップ3: 参加者をユーザーセグメントに一括追加する**
1. 左側のナビゲーションメニューで、次を選択します  **\[Engage] → データソース→ セグメント**.
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] → 参加者**.
2. ユーザーセグメントに追加したい特定の参加者を見つけます。
3. 名前を選択して、参加者プロフィールを読み込みます。
4. ユーザー概要の左下で、  **\[キャンセル]** を、参加者がもう所属しないようにするセグメントの右側で選択します。
{% endstep %}
{% endstepper %}
#### Advocate API と UTT のセグメンテーション
Advocate REST API と UTT JavaScript ライブラリは、参加者がどのセグメントのメンバーであるかをプログラムで管理するためにも使用できます。
この機能は、API呼び出しまたはUTTメソッドのユーザーオブジェクトに、次の「操作」（セグメント名と演算子の組み合わせ）のいずれか1つ以上を含めることで利用できます。
これらの操作の使用方法の詳細は、UTT JavaScript ライブラリおよび API メソッドに関する [ユーザー API ドキュメント](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.