> 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 maneira 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 uma relação direta com os usuários finais cadastrados no seu programa Advocate. Pagamentos em dinheiro são uma exceção porque os usuários fornecem suas informações bancárias e fiscais à impact.com para facilitar o pagamento de suas 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

Dados diretos vêm diretamente da fonte, normalmente inseridos pelo usuário final ou fornecidos diretamente.

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

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

Você pode incluir os seguintes pontos de dados do usuário ao enviar dados do usuário para o Advocate.

<details>

<summary>Pontos de dados diretos do usuário</summary>

* ID do usuário (obrigatório)
  * Recomendamos usar o endereço de e-mail de um usuário, armazenado como um `SHA1` hash.
* ID da conta (obrigatório)
  * Recomendamos usar o endereço de e-mail de um usuário, armazenado como um `SHA1` hash.
* Nome (opcional)
* Sobrenome (opcional)
* Endereço de e-mail (obrigatório se você quiser enviar e-mails aos seus 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 contendo o link de compartilhamento usado, a expiração do cookie e o código exclusivo de indicação do referenciador.
* Segmentos (opcional)
* Campos personalizados (opcional)
  * Campos livres que podem ser usados para armazenar dados adicionais sobre o usuário, por exemplo, endereço de correspondência, 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 pagamentos em dinheiro, o Advocate também capturará e armazenará os dados bancários e fiscais fornecidos pelo usuário diretamente na impact.com 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, recompensando com um cartão-presente ou código de desconto em vez disso, então o usuário final não tem um relacionamento com a impact.com.
* **Integração de recompensas do Tango Card:** Se você estiver usando nossa integração com o Tango Card para recompensar cartões-presente, o nome, sobrenome e endereço de e-mail do usuário são enviados ao Tango Card para facilitar o cumprimento da recompensa.

#### Dados indiretos

Um usuário final não insere dados indiretos diretamente; em vez disso, eles são coletados de outras fontes para nos dar insights mais profundos.

Os seguintes pontos de dados são rastreados e armazenados para o usuário, mas não são Informações Pessoais Identificáveis (PII).

<details>

<summary>Pontos de dados indiretos do usuário</summary>

* Carregamentos do widget
* Tráfego (quanto tráfego de indicação os links de compartilhamento de um usuário geraram)
* Recompensas ganhas pelo usuário
* Endereço IP (se você estiver usando JavaScript na sua implementação)
  * O endereço IP de um 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 maneiras:

* **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, sobrenome e e-mail de um usuário para facilitar que nossa plataforma envie e-mails aos usuários finais sobre suas indicações e forneça conteúdo personalizado no widget e nos e-mails (por exemplo, “Seu amigo Bob acabou de concluir uma compra, sua recompensa está a caminho!”)
* **Detecção de fraude:** O nome, endereço de e-mail e endereço IP do usuário são usados por nossas ferramentas de gerenciamento de fraudes para detectar indicações potencialmente fraudulentas.
* **Internacionalização:** O país e a localidade do usuário são usados para internacionalização.
* **Pagamentos e cadastro fiscal:** O usuário final fornecerá suas informações bancárias e fiscais para:
  * Receber pagamentos por suas recompensas.
  * Indicar quando um formulário fiscal US W-9 é 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.
