> 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.