> 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] → 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. 从左侧导航菜单中选择  **\[Engage] → Reporting → Imports & Exports**.
2. 选择  **导入**.
3. 在 *选择导入类型*下，选择 **删除用户**.
4. 要上传文件，请选择 **选择文件**.
5. 选择 **运行预览** 以执行测试导入并验证你的文件。
预览会检查文件中的错误。系统会在最终导入期间跳过任何有错误的行。
6. （可选）配置删除处理选项：
* **保留空账户：** 选择此选项可在其所有关联用户都被删除时，防止账户被删除。
* **防止已删除用户再次被创建：** 选择此选项可将 *不跟踪* 标记应用到已删除用户。
7. 预览成功后，选择 **批量删除**.
删除过程完成后，系统会发送确认电子邮件。根据队列和文件大小不同，该过程最多可能需要 30 分钟。
字段参考
| 字段 | 类型 | 说明 |
| -------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------- |
| accountId | 字符串
必填
| 该用户所属账户的唯一标识符。 |
| id | 字符串
必填
| 为该用户提供的唯一标识符。 |
| preserveEmptyAccount | 布尔值 | 如果该用户的账户在删除后没有任何用户，默认情况下该账户将被删除。如果设置了此字段，则会保留空账户。这将覆盖该行导入任务的全局 `保留空账户` 设置。 |
| doNotTrack | 布尔值 | 指定 `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.