> 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（可选）
* Cookies（可选）
  * 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 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/getting-started-with-advocate/data-requirements-for-advocate-users.md?ask=<question>&goal=<endgoal>
```

`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.
