> 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で定められたユーザー削除要件に完全に準拠しています。参加者を削除すると、当社のシステムは30日以内に、当社システムおよびそのサブプロセッサー内でその参加者について保存されているすべてのPIIを削除します。特定の参加者について保存されている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] → 参加者**.
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] → レポート → インポートとエクスポート**.
2. 選択 ![](/files/13cccf72e7bffda0ccdbcbaccef663ee74d618f0) **インポート**.
3. 下に *インポートタイプを選択*、選択します **ユーザーを削除**.
4. ファイルをアップロードするには、次を選択します **ファイルを選択**.
5. 選択 **プレビューを実行** を実行してテストインポートを行い、ファイルを検証します。

プレビューではファイルのエラーを確認します。システムは最終インポート時に、エラーのある行をスキップします。

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

* **空のアカウントを保持：** 関連ユーザーがすべて削除されても、アカウントが削除されないようにするには、このオプションを選択します。
* **削除されたユーザーの再作成を防ぐ：** このオプションを選択して、次を適用します *追跡拒否* フラグを削除済みユーザーに設定します。

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` このユーザーを以下で削除したい場合は `追跡拒否` 設定を有効にしてください。これにより、全体の `追跡拒否` 設定がこの行のインポートジョブに対して個別に上書きされます。                         |

</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] → レポート →** [**Imports & Exports**](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=<question>&goal=<endgoal>
```

`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.
