> 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. 左側のナビゲーションメニューから、次を選択します  **\[Engage] → 参加者**.
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. 左側のナビゲーションメニューから、次を選択します  **\[Engage] → レポート → インポートとエクスポート**.
2. 選択  **インポート**.
3. 「 *インポートタイプを選択*で、 **ユーザーを削除**.
4. ファイルをアップロードするには、 **ファイルを選択**.
5. 選択 **プレビューを実行** を選択してテストインポートを実行し、ファイルを検証します。
プレビューではファイル内のエラーをチェックします。システムは最終インポート時に、エラーのある行をすべてスキップします。
6. （任意）削除処理オプションを設定します：
* **空のアカウントを保持：** このオプションを選択すると、関連するユーザーがすべて削除されてもアカウントが削除されないようにできます。
* **削除されたユーザーが再作成されるのを防ぐ：** このオプションを選択すると、次を適用します： *追跡しない* 削除されたユーザーにフラグを付けます。
7. プレビューが成功したら、 **一括削除**.
削除処理が完了すると、システムから確認メールが送信されます。処理には、キューとファイルサイズによって最大30分かかる場合があります。
項目参照
| フィールド | 費用の種類 | 説明 |
| -------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| accountId | 文字列
必須
| このユーザーが所属するアカウントの一意の識別子。 |
| id | 文字列
必須
| このユーザーに付与された一意の識別子。 |
| preserveEmptyAccount | ブール値 | ユーザーのアカウントにユーザーが残っていない場合、既定ではアカウントは削除されます。設定すると、このフィールドにより空のアカウントが保持されます。これはグローバルな `空のアカウントを保持` インポートジョブの設定を、この行に対して個別に上書きします。 |
| doNotTrack | ブール値 | 指定 `true` このユーザーを次の設定で削除したい場合は、 `追跡しない` 設定を有効にしてください。これはグローバルな `追跡しない` インポートジョブの設定を、この行に対して個別に上書きします。 |
{% endtab %}
{% endtabs %}
**結果**
インポートが完了すると、メールでお知らせします。結果は次からダウンロードできます：  **\[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="エラー" %}
**インポートエラー：** インポートファイルにエラーが含まれている場合、システムは別のエラーファイルを生成します。このファイルには、元のファイルの該当行番号と詳細なエラーメッセージ付きで、各エラーが一覧表示されます。
**システムエラー：** システムエラーによってインポートが中断された場合、ステータスは次のように変わります： *中断済み*。この処理は元に戻せません。この場合、 [サポートにお問い合わせください](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=&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.