# Advocate参加者削除の解説

{% hint style="danger" %}
**警告**：削除は永久的なものであり、共有リンク、紹介、分析に影響が及ぶ場合があります。
{% endhint %}

当社の削除機能は、GDPRで定められたユーザー削除要件に完全に準拠しています。参加者を削除すると、当社のシステムおよびそのサブプロセッサ内に保存されているその参加者に関するすべてのPIIを、30日以内に削除します。特定の参加者について保存されているPIIの完全な一覧は、次の方法で取得できます。 [ユーザーPIIを検索](https://integrations.impact.com/impact-brand/reference/getuserpii) APIメソッド。参加者は、個別または一括でプログラムから削除できます。

#### 削除オプション

{% tabs %}
{% tab title="Do Not Track" %}
削除は次の設定で構成できます。 *Do Not Track* オプション。選択すると、削除された参加者はシステムに再登録できず、その参加者を再作成しようとすると失敗します。
{% endtab %}

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

#### 削除方法

{% tabs %}
{% tab title="API経由" %}
Advocate REST APIには、参加者を削除するための2つの方法があります。

* [**アカウントを削除**](https://integrations.impact.com/impact-brand/reference/opendeleteaccount)**:** この方法を使用して、アカウントとその上のすべての参加者を削除します。
* [**参加者を削除**](https://integrations.impact.com/impact-brand/reference/opendeleteuser)**:** この方法を使用して、アカウント自体を削除せずに、そのアカウント上の参加者を削除します。
  {% 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. 参加者を次に追加するかどうかを選択します。 *Do Not Track* リスト。
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. （任意）削除処理オプションを設定：

* **空のアカウントを保持：** 関連付けられたすべてのユーザーが削除された場合に、そのアカウントが削除されるのを防ぐには、このオプションを選択します。
* **削除されたユーザーが再作成されないようにする：** このオプションを選択して、削除されたユーザーに *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="エラー" %}
**インポートエラー：** インポートファイルにエラーが含まれている場合、システムは別のエラーファイルを生成します。このファイルには、元のファイルの該当行番号と詳細なエラーメッセージを含む各エラーが一覧表示されます。

**システムエラー：** システムエラーによりインポートが中断された場合、そのステータスは *中止済み*に変わります。このプロセスは回復できません。この場合、 [サポートに問い合わせる](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: 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/delete-participants-from-your-advocate-program.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.
