> 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. 左側のナビゲーションメニューで、次を選択します。 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[エンゲージ] → データソース → セグメント**.
2. 次を選択します。 **セグメントを追加**.
3. 「 **名前** 」フィールドに、セグメントの内容がわかる名前を入力します。
4. を選択します。 **追加**.
   {% endstep %}

{% step %}
**ステップ2：ユーザーセグメントに参加者を1人追加する**

1. 左側のナビゲーションメニューで、次を選択します。 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[エンゲージ] → 参加者**.
2. ユーザーセグメントに追加する参加者を検索します。
3. 参加者の名前を選択して、参加者プロフィールを開きます。
4. 「 *セグメント* 」カードで、次を選択します。 **セグメントを追加**.
5. この参加者を追加するユーザーセグメントを選択します。
   {% endstep %}

{% step %}
**ステップ3：ユーザーセグメントに参加者を一括追加する**

1. 左側のナビゲーションメニューで、次を選択します。 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[エンゲージ] → データソース→ セグメント**.
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. 左側のナビゲーションメニューで、次を選択します。 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[エンゲージ] → 参加者**.
2. ユーザーセグメントに追加する特定の参加者を見つけます。
3. 参加者の名前を選択して、参加者プロフィールを開きます。
4. ユーザー概要の左下で、次を選択します。 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d05e21635c52fff94d35ca4c6b05c1deecc699ef%2F768d04f4d7e1b5b745577812f7d67db99d988bfc34749b6e575a04438d6cee36.svg?alt=media) **\[キャンセル]** 参加者をセグメントから削除するには、そのセグメントの右側にある
   {% endstep %}
   {% endstepper %}

#### Advocate API と UTT によるセグメンテーション

Advocate REST API と UTT Javascript ライブラリを使用して、参加者が所属するセグメントをプログラムから管理することもできます。

この機能を使用するには、API 呼び出しまたは UTT メソッドの user オブジェクトに、次の「operations」（セグメント名と演算子の組み合わせ）を1つ以上含めます。

これらの Operations の使用方法について詳しくは、UTT Javascript ライブラリと API メソッドに関する [ユーザー API ドキュメント](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user).

{% tabs %}
{% tab title="演算子" %}
以下の演算子は、ユーザーセグメントの *Operations*の基本となるもので、参加者が所属するセグメントの管理に使用します。

| 演算子          | 説明                                                                                             | 例               |
| ------------ | ---------------------------------------------------------------------------------------------- | --------------- |
| 追加           | セグメントキーのみを指定すると、参加者をそのセグメントに追加しようとします。参加者がすでにそのセグメントに所属している場合、何も行われません。                        | `mySegmentKey`  |
| 削除           | その前に *セグメントキー* を付けると、 `~` 参加者をセグメントから削除するよう Advocate に指示します。参加者がすでにそのセグメントに所属していない場合、何も行われません。 | `~mySegmentKey` |
| クリア          | キーの前に *を付けると*、 `~` 参加者が現在所属しているすべてのセグメントから削除するよう Advocate に指示します。                              | `~`             |
| {% endtab %} |                                                                                                |                 |

{% tab title="Operations" %}
使用可能な *演算子*を使って以下の Operations を指定すると、ユーザーが所属するセグメントを管理できます。

| Operation     | 説明                                                                                                                                              | 例                                                   |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| 追加            | 参加者をセグメントに追加します。既存の他のセグメントはそのまま保持されます。                                                                                                          | `{ "id" : "abc_123", ... "segments" : ["A"] }`      |
| 設定            | <p>参加者のセグメントを設定します。既存の他のセグメントはすべて削除されます。</p><p><strong>重要:</strong> 順序が重要です。set 操作を実行するには、最初に clear <em>演算子</em> <em>(\~)</em> を含める必要があります。</p> | `{ "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=<question>&goal=<user_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.
