> 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/zh/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](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) API 方法，获取特定参与者所存储的全部 PII。您可以从计划中单独删除参与者，也可以批量删除。

#### 删除选项

{% tabs %}
{% tab title="请勿跟踪" %}
您可以使用 *请勿跟踪* 选项配置删除行为。选中后，被删除的参与者无法在系统中重新注册，任何重新创建该参与者的尝试都会失败。
{% endtab %}

{% tab title="保留空账户" %}
批量删除参与者时，您可以通过 REST API 或 GraphQL 使用保留空账户这一配置选项。要保留空账户，请在删除文件或调用中包含 `preserveEmptyAccount` 字段。
{% endtab %}
{% endtabs %}

#### 删除方式

{% tabs %}
{% tab title="通过 API" %}
Advocate REST API 提供两种删除参与者的方法：

* [**删除账户**](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] → Participants**.
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] → Reporting → Imports & Exports**.
2. 选择 ![](https://1186853034-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 | 布尔值                                                     | 如果删除该用户后，其账户中将不再有任何用户，则默认情况下会删除该账户。设置此字段后，将保留空账户。对于此行，此设置将覆盖导入作业的全局 `Preserve Empty Accounts` 设置。 |
| 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] → 报告 →** [**导入与导出**](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/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/delete-participants-from-your-advocate-program.md?ask=<question>&goal=<user_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.
