> 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. 从左侧导航菜单中，选择  **\[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.