# 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) **\[Engage] → データソース → セグメント**.
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) **\[Engage] → 参加者**.
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) **\[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. 左側のナビゲーションメニューで、 ![](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) **\[Engage] → 参加者**.
2. ユーザーセグメントに追加したい特定の参加者を見つけます。
3. 名前を選択して、参加者プロフィールを読み込みます。
4. ユーザー概要の左下で、 ![](/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746) **\[キャンセル]** 参加者が属さなくなるべきセグメントの右側にある
   {% endstep %}
   {% endstepper %}

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

Advocate REST API と UTT JavaScript ライブラリは、参加者がどのセグメントのメンバーであるかをプログラムで管理するためにも使用できます。

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

これらの Operations の使用方法の詳細は、UTT JavaScript ライブラリおよび API メソッドの [ユーザー API ドキュメント](https://integrations.impact.com/impact-brand/reference/user).

{% tabs %}
{% tab title="演算子" %}
以下の演算子はユーザーセグメンテーションの基礎であり *オペレーション*、参加者がどのセグメントのメンバーであるかを管理するために使用されます。

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

{% tab title="オペレーション" %}
利用可能な *演算子*を使用して作成された以下の 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: 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=<question>
```

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.
