> 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/impact-brand/reference/getuserpii) API 方法。参与者可以单独或批量从您的项目中删除。
#### 删除选项
{% tabs %}
{% tab title="不跟踪" %}
您可以通过 *不跟踪* 选项配置删除。如果选择此项，被删除的参与者将无法在系统中重新注册，且任何尝试重新创建该参与者的操作都将失败。
{% endtab %}
{% tab title="保留空账户" %}
保留空账户是一项配置选项，您可以在通过 REST API 或 GraphQL 批量删除参与者时使用。若要保留空账户，请在 `preserveEmptyAccount` 字段中包含您的删除文件或调用。
{% endtab %}
{% endtabs %}
#### 删除方法
{% tabs %}
{% tab title="通过 API" %}
Advocate REST API 提供两种删除参与者的方法：
* [**删除账户**](https://integrations.impact.com/impact-brand/reference/opendeleteaccount)**:** 使用此方法删除一个账户及其上的所有参与者。
* [**删除参与者**](https://integrations.impact.com/impact-brand/reference/opendeleteuser)**:** 使用此方法删除账户上的某个参与者，而不删除账户本身。
{% 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 | 布尔值 | 如果用户账户中没有任何用户，默认情况下该账户将被删除。如果设置了此字段，则会保留空账户。这将覆盖全局 `保留空账户` 设置，仅对导入作业中的此行生效。 |
| 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.