> 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 | 布尔值 | 如果该用户的账户中没有用户，默认情况下该账户将被删除。如果设置了此字段，则会保留空账户。这将覆盖全局 `保留空账户` 设置，仅针对该行的导入任务。 |
| 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 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=&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.