> 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. impact.com にデータを送るために使用する **削除** 名前の下のボタン。
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 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/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 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.