> 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 完整列表： [查询用户 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 提供两种删除参与者的方法：
* [**删除账户**](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. 选择 **删除** 其姓名下方的按钮。
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 | boolean | 如果用户的账户中不再有任何用户，默认情况下该账户将被删除。如果设置了此字段，则会保留空账户。这将覆盖全局 `保留空账户` 设置，且仅针对该行的导入任务生效。 |
| doNotTrack | boolean | 指定 `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 的文件，并通过电子邮件发送给您。
{% 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/zh/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.