> 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/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/data-requirements-for-advocate-users.md).

# Requisitos de dados para usuários do Advocate

A forma como o Advocate coleta dados é única porque o Advocate não tem um marketplace de parceiros como o Creator e o Performance, e a impact.com não tem um relacionamento direto com os usuários finais cadastrados no seu programa Advocate. Pagamentos em dinheiro são uma exceção, pois os usuários fornecem suas informações bancárias e fiscais à impact.com para viabilizar o pagamento das recompensas.

<div data-with-frame="true"><figure><img src="https://526234278-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>

#### Dados diretos

Os dados diretos vêm diretamente da fonte, geralmente são inseridos pelo usuário final ou fornecidos diretamente por ele.

É possível executar um programa sem nenhum dado direto do usuário, desde que você use um ID exclusivo para seus usuários. Ao executar um programa usando apenas um ID exclusivo, você *não* poderá usar os seguintes recursos do Advocate:

* Enviar e-mails
* Enviar recompensas em cartões-presente por meio da nossa integração com o Tango Card
* Gerenciamento de fraude

Você pode incluir os seguintes dados do usuário ao enviá-los ao Advocate.

<details>

<summary>Dados diretos do usuário</summary>

* ID do usuário (obrigatório)
  * Recomendamos usar o endereço de e-mail do usuário, armazenado como um hash `SHA1` .
* ID da conta (obrigatório)
  * Recomendamos usar o endereço de e-mail do usuário, armazenado como um hash `SHA1` .
* Nome (opcional)
* Sobrenome (opcional)
* Endereço de e-mail (obrigatório se você quiser enviar e-mails aos usuários; caso contrário, opcional)
* Localidade do usuário (opcional)
* País do usuário (opcional)
* dateUsTaxFormSubmitted (opcional)
* Cookies (opcional)
  * Cookie do programa Advocate: `Base64URL` objeto codificado que contém o link de compartilhamento usado, a expiração do cookie e o código de indicação exclusivo de quem fez a indicação.
* Segmentos (opcional)
* Campos personalizados (opcional)
  * Campos de texto livre que podem ser usados para armazenar dados adicionais sobre o usuário, como endereço postal, nível de assinatura, número de telefone etc.
* Data de criação do usuário (no Advocate) (opcional)
* Data da última atualização do usuário (no Advocate) (opcional)

</details>

#### Dados transacionais e de pagamento

* **Recompensas em dinheiro:** Se você estiver usando o sistema de pagamento em dinheiro, o Advocate também coletará e armazenará diretamente na impact.com os dados bancários e fiscais fornecidos pelo usuário, como parte do processo de pagamento. Os usuários também precisarão aceitar os termos e condições associados ao pagamento. Se você *não* usar o sistema de pagamentos em dinheiro — por exemplo, se oferecer um cartão-presente ou um código de desconto —, o usuário final não terá um relacionamento com a impact.com.
* **Integração de recompensas do Tango Card:** Se você usar nossa integração com o Tango Card para oferecer cartões-presente como recompensa, o nome, o sobrenome e o endereço de e-mail do usuário serão enviados ao Tango Card para viabilizar a entrega da recompensa.

#### Dados indiretos

O usuário final não insere dados indiretos diretamente; em vez disso, eles são coletados de outras fontes para nos fornecer informações mais detalhadas.

Os dados a seguir são rastreados e armazenados para o usuário, mas não são informações de identificação pessoal (PII).

<details>

<summary>Dados indiretos do usuário</summary>

* Carregamentos do widget
* Tráfego (volume de tráfego de indicação gerado pelos links de compartilhamento do usuário)
* Recompensas recebidas pelo usuário
* Endereço IP (se você estiver usando JavaScript na implementação)
  * O endereço IP do usuário é recuperado e armazenado pela plataforma quando ele carrega o widget e/ou se torna um usuário indicado.

</details>

#### Uso dos dados do usuário

Os dados do usuário podem ser usados das seguintes formas:

* **Identificação do usuário:** Os IDs de usuário e de conta são usados para identificar o usuário.
* **Conteúdo personalizado:** Você pode nos fornecer o nome, o sobrenome e o e-mail de um usuário para que nossa plataforma possa enviar e-mails aos usuários finais sobre suas indicações e oferecer conteúdo personalizado no widget e nos e-mails (por exemplo: “Seu amigo Bob acabou de fazer uma compra; sua recompensa está a caminho!”)
* **Detecção de fraudes:** O nome, o endereço de e-mail e o endereço IP do usuário são usados por nossas ferramentas de gerenciamento de fraudes para detectar possíveis indicações fraudulentas.
* **Internacionalização:** O país e a localidade do usuário são usados para a internacionalização.
* **Pagamentos e cadastro fiscal:** O usuário final fornecerá suas informações bancárias e fiscais para:
  * Receber pagamentos pelas recompensas.
  * Indicar quando um formulário fiscal W-9 dos EUA for enviado.


---

# 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/pt-br/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.
