> 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/getting-started-with-advocate/data-requirements-for-advocate-users.md).

# Advocate 用户的数据要求

Advocate 收集数据的方式很独特，因为 Advocate 没有像 Creator 和 Performance 那样的合作伙伴市场，而且 impact.com 与注册到你的 Advocate 计划中的最终用户没有直接关系。现金支付是个例外，因为用户会向 impact.com 提供他们的银行和税务信息，以便发放奖励。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-dceec20685c4f1335a1f645dff448f862fcaf7f2%2F3c95b14a395878b4e7c83a88a16a3648e83a0ba22005d07e284b229583aaa425.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### 直接数据

直接数据直接来自源头，通常由最终用户输入或直接提供。

如果你为用户使用唯一 ID，则可以在没有任何直接用户数据的情况下运行一个计划。仅使用唯一 ID 运行计划意味着你 *不会* 能够使用以下 Advocate 功能：

* 发送电子邮件
* 通过我们的 Tango Card 集成发送礼品卡奖励
* 欺诈管理

在向 Advocate 发送用户数据时，你可以包含以下用户数据点。

<details>

<summary>直接用户数据点</summary>

* 用户 ID（必填）
  * 我们建议使用用户的电子邮件地址，并将其存储为 `SHA1` 哈希值。
* 账户 ID（必填）
  * 我们建议使用用户的电子邮件地址，并将其存储为 `SHA1` 哈希值。
* 名（可选）
* 姓氏（可选）
* 电子邮件地址（如果你想向用户发送电子邮件则为必填，否则可选）
* 用户的区域设置（可选）
* 用户的国家/地区（可选）
* dateUsTaxFormSubmitted（可选）
* Cookie（可选）
  * Advocate 计划 Cookie： `Base64URL` 编码对象，包含所使用的分享链接、Cookie 到期时间以及推荐人的唯一推荐代码。
* 细分（可选）
* 自定义字段（可选）
  * 可用于存储关于用户的其他数据的自由格式字段，例如邮寄地址、订阅等级、电话号码等。
* 用户创建日期（在 Advocate 中）（可选）
* 用户最后更新日期（在 Advocate 中）（可选）

</details>

#### 交易和付款数据

* **现金奖励：** 如果你使用现金支付系统，Advocate 还会在付款流程中将用户提供的银行和税务详情直接收集并存储到 impact.com。用户还需要接受与付款相关的条款和条件。如果你 *不* 使用现金支付系统，例如改为奖励礼品卡或折扣码，那么最终用户与 impact.com 就没有关系。
* **Tango Card 奖励集成：** 如果你使用我们的 Tango Card 集成来奖励礼品卡，用户的名字、姓氏和电子邮件地址会传递给 Tango Card，以便完成奖励发放。

#### 间接数据

最终用户不会直接输入间接数据；相反，它是从其他来源收集的，以便为我们提供更深入的洞察。

以下数据点会被跟踪并存储到用户中，但它们并不是个人可识别信息（PII）。

<details>

<summary>间接用户数据点</summary>

* 组件加载次数
* 流量（用户的分享链接产生了多少推荐流量）
* 用户获得的奖励
* IP 地址（如果你在实现中使用 JavaScript）
  * 当用户加载小组件和/或成为被推荐用户时，平台会检索并存储用户的 IP 地址。

</details>

#### 用户数据的使用

用户数据可通过以下方式使用：

* **用户识别：** 用户 ID 和账户 ID 用于识别用户。
* **定制内容：** 你可以向我们提供用户的名字、姓氏和电子邮件，以帮助我们的平台能够向最终用户发送有关其推荐的电子邮件，并在小组件和电子邮件中提供定制内容（例如，“你的朋友 Bob 刚刚完成了一次购买，你的奖励即将到账！”）
* **欺诈检测：** 用户的姓名、电子邮件地址和 IP 地址会被我们的欺诈管理工具用于检测潜在的欺诈性推荐。
* **国际化：** 用户的国家/地区和区域设置用于国际化。
* **付款和税务登记：** 最终用户将向以下对象提供其银行和税务信息：
  * 接收其奖励的付款。
  * 表明何时提交了美国 W-9 税务表格。


---

# 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/getting-started-with-advocate/data-requirements-for-advocate-users.md?ask=<question>&goal=<user_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.
