> 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/delete-participants-from-your-advocate-program.md).

# Advocate参加者削除の解説

{% hint style="danger" %}
**警告**：削除は取り消せません。また、共有リンク、紹介、分析に影響する可能性があります。
{% endhint %}

当社の削除機能は、GDPRで定められたユーザー削除の要件に完全に準拠しています。参加者を削除すると、当社のシステムおよび再委託先のシステムに保存されている、その参加者のすべての個人を特定できる情報（PII）が30日以内に削除されます。特定の参加者について保存されているPIIの全リストは、次のメソッドを使用して取得できます。 [ユーザーのPIIを照会する](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) APIメソッド。参加者は、プログラムから個別に、または一括で削除できます。

#### 削除オプション

{% tabs %}
{% tab title="追跡しない" %}
削除時の設定は、次の *追跡しない* オプションで設定できます。このオプションを選択すると、削除された参加者はシステムに再登録できなくなり、参加者を再作成しようとしても失敗します。
{% endtab %}

{% tab title="空のアカウントを保持" %}
空のアカウントの保持は、REST APIまたはGraphQLを使用して参加者を一括削除する際に利用できる設定オプションです。空のアカウントを保持するには、削除用ファイルに次の `preserveEmptyAccount` フィールドを含めるか、呼び出し時に指定してください。
{% endtab %}
{% endtabs %}

#### 削除方法

{% tabs %}
{% tab title="APIを使用" %}
Advocate REST APIには、参加者を削除するためのメソッドが2つあります。

* [**アカウントを削除**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/account-overview/account)**:** このメソッドを使用すると、アカウントと、そのアカウントに属するすべての参加者を削除できます。
* [**参加者を削除**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user)**:** このメソッドを使用すると、アカウント自体は削除せずに、そのアカウントの参加者を削除できます。
  {% endtab %}

{% tab title="個別に削除する" %}

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] → Participants**.
2. 削除する参加者を検索します。
3. 参加者の名前を選択して、プロフィールを開きます。
4. 名前の下にある **削除** ボタンを選択します。
5. 参加者を *追跡しない* リストに追加するかどうかを選択します。
6. 参加者を削除してよいことを確認したら、最後の削除ボタンを選択します。
   {% endtab %}

{% tab title="一括削除" %}
{% hint style="warning" %}
**警告**：この処理を行うと、選択したすべての参加者とその履歴データ（紹介、報酬、イベントなど）が完全に削除されます。このデータは復元できません。続行する前に、ファイル内の参加者を削除してよいことを確認してください。
{% endhint %}

**ファイルを準備する**

Advocateでは、次の形式で送信されたインポートを受け付けています。 `.csv` または `.jsonl` 形式のファイルです。必要なファイル構造については、次のサンプルをご覧ください。 [CSVインポートファイルのサンプル](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) および [JSONLインポートファイルのサンプル](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) 最良の結果を得るには、各ファイルのエントリ数が500,000件を超えないようにしてください。

* 必須フィールド： `id` および `accountId`.
* 任意のフィールド：削除方法をカスタマイズするために、ほかの任意フィールドを含めることができます。

すべてのフィールドで大文字と小文字が区別されます。詳細については、 *フィールドリファレンス* 詳しくは、以下の表を参照してください。

**参加者を削除**

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] → Reporting → Imports & Exports**.
2. 選択 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media) **インポート**.
3. 「Under」で *インポートタイプを選択*を選択し、 **ユーザーを削除**.
4. ファイルをアップロードするには、 **ファイルを選択**.
5. 選択 **プレビューを実行** して、テストインポートを実行し、ファイルを検証します。

プレビューでは、ファイルにエラーがないか確認します。最終的なインポートでは、エラーのある行はスキップされます。

6. （任意）削除処理のオプションを設定します。

* **空のアカウントを保持：** 関連付けられたユーザーがすべて削除されても、アカウントが削除されないようにするには、このオプションを選択します。
* **削除したユーザーの再作成を防止：** 削除されたユーザーに *Do Not Track* フラグを適用するには、このオプションを選択します。

7. プレビューが正常に完了したら、 **一括削除**.

削除処理が完了すると、システムから確認メールが送信されます。キューやファイルサイズによっては、処理に最大30分かかる場合があります。

<details>

<summary>フィールドの説明</summary>

| 項目                   | 種類                                                      | 説明                                                                                                                     |
| -------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| accountId            | <p>文字列</p><p><mark style="color:$danger;">必須</mark></p> | このユーザーが所属するアカウントの一意の識別子。                                                                                               |
| id                   | <p>文字列</p><p><mark style="color:$danger;">必須</mark></p> | このユーザーに指定された一意の識別子。                                                                                                    |
| preserveEmptyAccount | boolean                                                 | ユーザーがいなくなった場合、デフォルトではそのアカウントは削除されます。このフィールドを設定すると、空のアカウントが保持されます。この行に限り、インポートジョブのグローバルな `空のアカウントを保持` 設定よりもこの設定が優先されます。 |
| doNotTrack           | boolean                                                 | このユーザーを `true` に設定された `Do Not Track` 設定で削除する場合は、 `Do Not Track` を指定します。この行に限り、インポートジョブのグローバル設定よりもこの設定が優先されます。          |

</details>
{% endtab %}
{% endtabs %}

**結果**

インポートが完了すると、メールでお知らせします。結果は次の場所からダウンロードできます。 ![](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] → レポート →** [**インポートとエクスポート**](https://app.impact.com/secure/advertiser/engage/advocate/p/6846ce09cf529b17c4549c95/t/live/jobs).

{% hint style="success" icon="memo" %}
**注**：ダウンロードリンクの有効期限は30日です。
{% endhint %}

{% tabs %}
{% tab title="アップロード成功時" %}
インポートが正常に完了すると、削除された参加者のアカウントIDとユーザーIDを記載したファイルが生成され、メールで送信されます。
{% endtab %}

{% tab title="エラー" %}
**インポートエラー：** インポートファイルにエラーが含まれている場合、システムは別のエラーファイルを生成します。このファイルには、エラーごとに元のファイルの該当行番号と詳細なエラーメッセージが記載されます。

**システムエラー：** システムエラーによってインポートが中断されると、ステータスは次のように変わります： *aborted*。この処理は復旧できません。その場合は、 [サポート](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) にお問い合わせください。
{% endtab %}
{% endtabs %}

#### システムへの影響

参加者を削除すると、システムの複数の領域に影響が及ぶ可能性があります。

{% tabs %}
{% tab title="共有リンク" %}
参加者を削除すると、その参加者の個人を特定できる情報（PII）は、紹介コードを含めすべて削除されます。共有リンクの動作は異なり、リンク自体は削除されませんが、特定の参加者との関連付けは解除されます。削除された参加者の共有リンクからの紹介は、その参加者によるものとして記録されなくなりますが、新たに紹介された参加者は引き続きそのリンクからプログラムのランディングページにアクセスできます。
{% endtab %}

{% tab title="紹介" %}
削除された参加者が他の参加者を紹介した、または他の参加者から紹介されたことがある場合、他の参加者のウィジェットやマイクロサイトに表示される紹介履歴が変わります。この場合、紹介は引き続き報酬の対象としてカウントされますが、画面上では匿名の参加者からの紹介として表示されます。
{% endtab %}

{% tab title="分析データ" %}
分析データは、参加者がウィジェットの読み込み、リンクの共有、紹介などのアクションを行う際に収集されます。参加者を削除すると、その参加者に紐づく分析データはすべて削除されるため、impact.comのAdvocateプログラムのレポートセクションに表示される統計に影響します。
{% endtab %}

{% tab title="プラットフォーム" %}
削除された参加者は、 **参加者** ページに表示されなくなります。削除された参加者が紹介に関わっていた場合、相手の参加者のプロフィールにある紹介テーブルには、紹介が存在することと、その相手が削除された参加者であることが表示されます。その紹介に対して報酬が付与されていた場合、報酬テーブルにも同様に、紹介が削除された参加者に紐づいていることが表示されます。
{% 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/delete-participants-from-your-advocate-program.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.
