# 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] → Participants**.
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] → 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. 次の *インポートタイプを選択*で、 **ユーザーを削除**.
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 | ブール値                                                    | ユーザーのアカウントにユーザーが 1 人も残らない場合、デフォルトではそのアカウントは削除されます。設定すると、このフィールドにより空のアカウントが保持されます。これはグローバルな `空のアカウントを保持` 設定を、この行に対するインポートジョブについてのみ上書きします。 |
| doNotTrack           | ブール値                                                    | 指定してください `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] → Reporting →** [**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 プログラムの Reporting セクションに表示される統計に影響します。
{% endtab %}

{% tab title="プラットフォーム" %}
削除された参加者は、もはや **参加者** ページに表示されません。削除された参加者が紹介の一部であった場合、他の参加者のプロフィール上の紹介テーブルには紹介が存在することは表示されますが、それが削除された参加者からのものであることが示されます。紹介の一部として報酬が付与されていた場合、報酬テーブルでも同様に、その紹介が削除された参加者に関連付けられていることが示されます。
{% endtab %}
{% endtabs %}