> 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/advocate-reporting-and-analytics/advocate-program-reports-explained.md).

# Explicação sobre relatórios do programa Advocate

<a href="https://pxa.impact.com/student/activity/1687872?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

O Advocate oferece vários relatórios para download sobre os dados do seu programa e dos participantes. Todos os relatórios têm opções de filtragem que permitem controlar melhor os dados baixados. Cada relatório pode ser baixado como arquivo .CSV ou Excel.

Este artigo explica os diferentes relatórios e os tipos de dados incluídos em cada um. Consulte [Gerar um relatório do programa Advocate](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) para ver instruções sobre como gerar um relatório.

#### Relatório de detalhes do usuário

O *relatório de detalhes do usuário* contém informações detalhadas sobre cada participante de todos os seus programas. Exporte uma lista de todos os participantes para manter seus registros atualizados com os links de compartilhamento e os códigos de indicação do Advocate.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório inclui informações dos participantes, como:

* Nome
* ID do usuário e da conta
* Endereço de e-mail
* Campos personalizados
* Segmentos
* Informações de indicação (se aplicável)

Ao gerar o relatório, você também pode incluir:

* **Estatísticas do usuário**, incluindo dados analíticos do participante, como tráfego, receita e muito mais.
* **Links e códigos de compartilhamento de indicação**, se aplicável. Essas informações podem ser úteis para atualizar os registros de contato no seu CMS ou sistema de e-mail, incluindo os links e códigos de compartilhamento do Advocate de cada participante.

A lista completa dos campos pode ser consultada ao [baixar nosso arquivo CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) do relatório de detalhes do usuário.

**Referência das colunas do relatório**

| Coluna                                                   | Descrição                                                                                                                                                                                                                                    |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do usuário**                               |                                                                                                                                                                                                                                              |
| ID                                                       | Identificador exclusivo do participante no sistema Advocate.                                                                                                                                                                                 |
| ID da conta                                              | Identificador exclusivo da conta do participante (usado em vários programas, se aplicável).                                                                                                                                                  |
| E-mail                                                   | Endereço de e-mail do participante.                                                                                                                                                                                                          |
| Nome                                                     | Nome do participante.                                                                                                                                                                                                                        |
| Sobrenome                                                | Sobrenome do participante.                                                                                                                                                                                                                   |
| Hash do e-mail                                           | Versão com hash (criptografada) do e-mail do participante, útil para correspondência com outros sistemas em conformidade com as normas de privacidade.                                                                                       |
| **Informações de indicação e compartilhamento**          |                                                                                                                                                                                                                                              |
| Código de indicação                                      | Código exclusivo associado ao participante, usado para rastrear as indicações que ele gera.                                                                                                                                                  |
| Link de compartilhamento                                 | Link de indicação exclusivo associado ao participante.                                                                                                                                                                                       |
| Link de compartilhamento do Facebook                     | Link pré-gerado para compartilhar a indicação no Facebook.                                                                                                                                                                                   |
| Link de compartilhamento do Twitter                      | Link pré-gerado para compartilhar a indicação no Twitter.                                                                                                                                                                                    |
| Link de compartilhamento por e-mail                      | Link pré-gerado para compartilhar a indicação por e-mail.                                                                                                                                                                                    |
| Link de compartilhamento do LinkedIn                     | Link pré-gerado para compartilhar a indicação no LinkedIn.                                                                                                                                                                                   |
| Link de compartilhamento limpo                           | Versão do link de indicação sem parâmetros de rastreamento; mais neutra para determinadas plataformas ou casos de uso.                                                                                                                       |
| **Geolocalização e localidade**                          |                                                                                                                                                                                                                                              |
| Primeiro IP detectado                                    | O endereço IP a partir do qual o participante foi registrado pela primeira vez.                                                                                                                                                              |
| Último IP registrado                                     | O endereço IP mais recente registrado para este participante.                                                                                                                                                                                |
| Localidade                                               | O idioma e as configurações regionais preferidos pelo participante (por exemplo, en-US).                                                                                                                                                     |
| Código do país                                           | O país do participante, com base na localidade ou no endereço IP (por exemplo, ZA, US).                                                                                                                                                      |
| **Datas e horários**                                     |                                                                                                                                                                                                                                              |
| Data de criação                                          | A data e o horário em que a conta do participante foi criada no Advocate.                                                                                                                                                                    |
| Data de envio do formulário fiscal dos EUA               | (Se aplicável) A data em que um formulário fiscal dos EUA foi enviado para fins de conformidade ou processamento de recompensas.                                                                                                             |
| **Estatísticas do usuário (se incluídas na exportação)** |                                                                                                                                                                                                                                              |
| stats.date Modified                                      | A última data em que as estatísticas do participante foram atualizadas.                                                                                                                                                                      |
| stats.traffic                                            | Número total de visitas geradas pela atividade de indicação do participante.                                                                                                                                                                 |
| stats.referrals                                          | Número total de indicações bem-sucedidas feitas pelo participante.                                                                                                                                                                           |
| stats.conversions                                        | Número total de conversões (por exemplo, compras e inscrições) resultantes dessas indicações.                                                                                                                                                |
| stats.goals                                              | Número de metas específicas concluídas associadas à atividade de indicação do participante (definidas de forma personalizada no programa).                                                                                                   |
| stats.rewards                                            | Número total de recompensas que o participante ganhou.                                                                                                                                                                                       |
| stats.widget Loads                                       | Número de vezes que o widget de indicação ou a interface de compartilhamento foi carregado por este participante.                                                                                                                            |
| stats.revenue                                            | Receita total gerada pelos usuários indicados por este participante.                                                                                                                                                                         |
| stats.generated Revenue                                  | Sinônimo de stats.revenue; alguns relatórios podem diferenciar a receita quando ela vem de várias fontes.                                                                                                                                    |
| stats.referred Revenue                                   | Receita atribuída especificamente aos participantes que se inscreveram ou fizeram uma compra pelo link de indicação deste participante.                                                                                                      |
| **Dados personalizados**                                 |                                                                                                                                                                                                                                              |
| custom Fields.example                                    | Um espaço reservado para quaisquer campos personalizados definidos no seu programa (por exemplo, *ID de fidelidade*, *observações internas*, *marcador de região*). Cada campo aparecerá em uma coluna própria, com o prefixo custom Fields. |
| **Outros**                                               |                                                                                                                                                                                                                                              |
| Origem da indicação                                      | A origem ou o canal inicial que levou o participante ao seu programa (por exemplo, *orgânico*, *e-mail*, *site de parceiro*).                                                                                                                |

</details>

#### Exportação de eventos do usuário

O *relatório de exportação de eventos do usuário* fornece um registro de todos os eventos do usuário que recebemos da sua organização para o seu programa Advocate. Você pode aplicar filtros para restringir um período, uma chave de evento, um ID de usuário e muito mais.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório inclui:

* ID do evento
* Chave do evento
* ID do usuário e da conta
* Data do acionamento
* Data do recebimento
* Data do processamento

**Referência das colunas do relatório**

| Coluna                                                                | Descrição                                                                                                                                                                                             |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do evento e do usuário**                                |                                                                                                                                                                                                       |
| ID do evento                                                          | Um ID exclusivo gerado para cada evento recebido. Útil para rastrear, depurar ou auditar envios de eventos.                                                                                           |
| Chave do evento                                                       | O tipo ou rótulo do evento, como `purchase`, `signup`, ou qualquer chave personalizada definida pelo seu sistema.                                                                                     |
| ID do usuário                                                         | O identificador exclusivo do participante no Advocate ao qual o evento está associado.                                                                                                                |
| ID da conta                                                           | O ID da conta vinculado ao usuário, especialmente relevante em programas nos quais os usuários podem pertencer a diferentes estruturas de conta.                                                      |
| **Registros de data e hora do evento**                                |                                                                                                                                                                                                       |
| Data do acionamento do evento – YYYY-MM-DD                            | A data em que o evento realmente aconteceu (conforme informado pelo seu sistema). Por exemplo, a data em que uma compra foi realizada ou uma inscrição foi feita.                                     |
| Data de recebimento do evento – YYYY-MM-DD                            | A data em que o Advocate recebeu o evento do seu sistema. Pode ser diferente da data do acionamento devido ao processamento em lote ou a atrasos no sistema.                                          |
| Data de processamento do evento – YYYY-MM-DD                          | A data em que o evento foi processado e armazenado com sucesso no Advocate. Indica quando o evento passou a poder ser usado para rastreamento, recompensas ou relatórios.                             |
| **Campos de dados do evento (se incluídos nos payloads dos eventos)** |                                                                                                                                                                                                       |
| fields.coupon                                                         | Qualquer cupom ou código de desconto aplicado durante o evento, se enviado nos dados do evento. Útil para rastrear o uso de incentivos ou acionamentos de promoções específicas.                      |
| fields.revenue                                                        | O valor da receita associada ao evento. Normalmente usado em eventos de compra para calcular desempenho, recompensas ou ROI.                                                                          |
| fields.currency                                                       | O código da moeda (por exemplo, *USD*, *ZAR*, *EUR*) associado ao valor da receita. Importante para gerar relatórios de várias regiões ou calcular recompensas ajustadas pela taxa de câmbio.         |
| fields.lead Created Date                                              | A data original em que o lead (usuário) foi criado no seu sistema, se enviada como parte do evento. Ajuda a relacionar os eventos do usuário às datas de aquisição originais ou aos registros do CRM. |

</details>

#### Histórico de recompensas

O *histórico de recompensas* fornece um registro detalhado de cada uma das suas recompensas e das relações com participantes e indicações. Essas informações podem ser úteis para criar balanços e consultar o status de todas as suas recompensas em determinado momento.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório incluirá **campos de recompensa** com informações como:

* ID da recompensa
* Tipo de recompensa
* Valor da recompensa

Uma lista completa dos campos incluídos pode ser encontrada ao [baixar nosso CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) ou [JSONL de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) nos relatórios de detalhes das recompensas.

Ao gerar o relatório, você também pode incluir:

* **Detalhes do participante** como nome, ID do usuário e da conta, endereço de e-mail, campos personalizados, segmentos e informações de indicação (se aplicável).
* **Campos de indicação** como ID de indicação, campos do cliente indicador, campos do amigo indicado e muito mais.

**Referência das colunas do relatório**

| Coluna                                                                                                             | Descrição                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações sobre a recompensa**                                                                                 |                                                                                                                                                                                                                  |
| ID                                                                                                                 | ID exclusivo da instância da recompensa (gerado pelo Advocate).                                                                                                                                                  |
| Tipo                                                                                                               | A categoria ou o tipo da recompensa (por exemplo, *Dinheiro*, *Cartão-presente*, *Cupom*, *Personalizada*).                                                                                                      |
| Valor                                                                                                              | O valor numérico da recompensa (por exemplo, 10, 100 etc.).                                                                                                                                                      |
| Unidade                                                                                                            | A unidade associada ao valor (por exemplo, *USD*, *pontos*, *ZAR*, *%*).                                                                                                                                         |
| Nome                                                                                                               | Nome de exibição da recompensa (conforme definido na [configuração da recompensa](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Origem da recompensa                                                                                               | Descreve o que acionou a recompensa (por exemplo, *Indicação*, *Meta*, *Manual*, *API*).                                                                                                                         |
| Tipo de fundo Fuel Tank                                                                                            | O tipo de fundo de recompensa usado (se a integração com o Fuel Tank estiver em uso). Por exemplo, *Pré-pago*, *Cartão-presente*.                                                                                |
| Código do Fuel Tank                                                                                                | O código associado ao resgate externo (por exemplo, o código de um voucher ou cartão-presente).                                                                                                                  |
| ID do programa                                                                                                     | ID do programa Advocate pelo qual a recompensa foi emitida.                                                                                                                                                      |
| Chave da recompensa do programa                                                                                    | Identificador interno da configuração específica da recompensa usada no programa.                                                                                                                                |
| Chave global da recompensa                                                                                         | Identificador de recompensas entre programas configuradas globalmente (se aplicável).                                                                                                                            |
| **Datas e horários da recompensa**                                                                                 |                                                                                                                                                                                                                  |
| Data de criação                                                                                                    | Quando o registro da recompensa foi criado no sistema.                                                                                                                                                           |
| Data prevista                                                                                                      | Quando a recompensa foi programada para ser emitida (por exemplo, após um atraso ou período de espera).                                                                                                          |
| Data de concessão                                                                                                  | Quando a recompensa foi efetivamente emitida ao participante.                                                                                                                                                    |
| Data de expiração                                                                                                  | A data de expiração da recompensa (se aplicável).                                                                                                                                                                |
| Data de cancelamento                                                                                               | A data em que a recompensa foi anulada ou cancelada.                                                                                                                                                             |
| Data de resgate                                                                                                    | A data em que o participante resgatou a recompensa (se aplicável).                                                                                                                                               |
| Data de modificação                                                                                                | A data em que foi feita a atualização mais recente do registro da recompensa.                                                                                                                                    |
| **Acompanhamento de créditos e valores**                                                                           |                                                                                                                                                                                                                  |
| Crédito atribuído                                                                                                  | A quantidade de crédito atribuída a esta recompensa (pode ser diferente do valor em alguns modelos).                                                                                                             |
| Crédito resgatado                                                                                                  | A quantidade de crédito resgatada desta recompensa.                                                                                                                                                              |
| Valor disponível                                                                                                   | A parte restante não utilizada ou não resgatada da recompensa.                                                                                                                                                   |
| **Status e mensagens da recompensa**                                                                               |                                                                                                                                                                                                                  |
| Status                                                                                                             | Status atual da recompensa (por exemplo, *Pendente*, *Agendada*, *Concedida*, *Expirada*, *Cancelada*).                                                                                                          |
| meta.status                                                                                                        | Status técnico ou do sistema (útil para diagnósticos ou tratamento de erros).                                                                                                                                    |
| meta.message                                                                                                       | Mensagem relacionada à entrega da recompensa (por exemplo, “Recompensa entregue com sucesso”).                                                                                                                   |
| meta.internal Message                                                                                              | Observações internas visíveis apenas para administradores (por exemplo, explicações de falhas ou sinalizadores).                                                                                                 |
| meta.date Modified                                                                                                 | Última vez que os metadados relacionados à recompensa foram atualizados.                                                                                                                                         |
| meta.customMeta.testMeta                                                                                           | Um espaço reservado para quaisquer campos de metadados personalizados enviados pelo seu programa (neste caso, testMeta é um exemplo).                                                                            |
| **Informações do participante (usuário)**                                                                          |                                                                                                                                                                                                                  |
| user.id                                                                                                            | ID do usuário que recebe a recompensa.                                                                                                                                                                           |
| user.account Id                                                                                                    | ID da conta associada ao usuário no Advocate.                                                                                                                                                                    |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | Informações básicas do participante incluídas para referência ou correspondência com o CRM.                                                                                                                      |
| **Contexto da indicação (se a recompensa for baseada em indicação)**                                               |                                                                                                                                                                                                                  |
| referral.id                                                                                                        | ID da indicação que acionou esta recompensa.                                                                                                                                                                     |
| referral.date Referral Started                                                                                     | Quando a ação de indicação começou (por exemplo, clique ou compartilhamento).                                                                                                                                    |
| referral.date Modified                                                                                             | Quando o registro da indicação foi atualizado pela última vez.                                                                                                                                                   |
| referral.referral Code Used                                                                                        | O código que o usuário indicado usou para se cadastrar ou realizar uma ação.                                                                                                                                     |
| **Informações do usuário indicado (amigo)**                                                                        |                                                                                                                                                                                                                  |
| referral.referred User.id                                                                                          | ID da pessoa indicada (o “amigo”).                                                                                                                                                                               |
| referral.referred User.account Id                                                                                  | ID exclusivo da conta de quem fez a indicação.                                                                                                                                                                   |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Dados básicos de contato de quem fez a indicação.                                                                                                                                                                |
| **Informações do indicador (advocate)**                                                                            |                                                                                                                                                                                                                  |
| referral.referrer User.id                                                                                          | ID da pessoa que fez a indicação (o “indicador”).                                                                                                                                                                |
| referral.referrer User.account Id                                                                                  | ID exclusivo da conta de quem fez a indicação.                                                                                                                                                                   |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Dados básicos de contato de quem fez a indicação.                                                                                                                                                                |
| referral.date Converted                                                                                            | A data em que a indicação foi oficialmente convertida (por exemplo, quando o cadastro ou a compra foi concluído), acionando a recompensa.                                                                        |

</details>

#### Histórico de indicações

O *Histórico de indicações* relatório fornece um registro do status de cada conexão de indicação feita no seu programa de indicações. Essas informações podem ser úteis para verificar o sucesso do programa e acompanhar o número de novos clientes que ele trouxe.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório inclui:

* Detalhes do amigo indicado, como nome, ID de usuário e da conta, endereço de e-mail e muito mais
* Detalhes do cliente indicador, como nome, ID de usuário e da conta, endereço de e-mail e muito mais
* Status da indicação
* Status de moderação
* IDs das recompensas

Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) do relatório de atividade de indicações.

**Referência das colunas do relatório**

| Coluna                                                                                                                     | Descrição                                                                                                                            |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Metadados da indicação**                                                                                                 |                                                                                                                                      |
| ID                                                                                                                         | Identificador exclusivo do registro da indicação no Advocate.                                                                        |
| Data de modificação                                                                                                        | A data mais recente em que qualquer parte do registro da indicação foi atualizada.                                                   |
| Data de início da indicação                                                                                                | Quando a indicação foi iniciada (por exemplo, quando o usuário indicado clicou em um link de indicação).                             |
| Data de conversão                                                                                                          | Quando a indicação foi convertida, geralmente quando o usuário indicado concluiu a ação necessária (como um cadastro ou uma compra). |
| Data de modificação do usuário                                                                                             | A última vez que os dados do usuário envolvidos nesta indicação (indicador ou indicado) foram atualizados.                           |
| ID do programa                                                                                                             | O ID do programa de indicações do Advocate ao qual esta indicação pertence.                                                          |
| Nome do programa                                                                                                           | O nome do programa de indicações, útil para quem gerencia vários programas.                                                          |
| **Informações do amigo indicado (novo cliente)**                                                                           |                                                                                                                                      |
| <p>E-mail do usuário indicado</p><p>Nome do usuário indicado</p><p>Sobrenome do usuário indicado</p>                       | Informações básicas de identificação do usuário indicado.                                                                            |
| Código de indicação do usuário indicado                                                                                    | O código de indicação atribuído ao usuário indicado (caso ele também possa indicar outras pessoas no futuro).                        |
| <p>IP registrado na primeira atividade do usuário indicado</p><p>IP registrado na última atividade do usuário indicado</p> | Endereços IP registrados na primeira e na atividade mais recente do usuário indicado.                                                |
| URL da imagem do usuário indicado                                                                                          | URL da imagem ou do avatar, caso tenha sido capturada ou atribuída ao usuário indicado.                                              |
| Localidade do usuário indicado                                                                                             | Configuração de idioma/região (por exemplo, *en-US*, *fr-FR*) do usuário indicado.                                                   |
| Data de criação do usuário indicado                                                                                        | A data em que a conta do usuário indicado foi criada no Advocate.                                                                    |
| Usuário indicado                                                                                                           | ID interno do usuário indicado no sistema Advocate.                                                                                  |
| Conta do indicado                                                                                                          | ID interno da conta vinculada ao usuário indicado (usado em programas com várias contas).                                            |
| **Informações do indicador (cliente defensor)**                                                                            |                                                                                                                                      |
| <p>E-mail do usuário indicador</p><p>Nome do usuário indicador</p><p>Sobrenome do usuário indicador</p>                    | Informações básicas de identificação do participante que fez a indicação.                                                            |
| Código de indicação do usuário indicador                                                                                   | Código de indicação do indicador, que provavelmente foi usado pelo usuário indicado.                                                 |
| <p>IP visto pela primeira vez do usuário indicador</p><p>IP visto pela última vez do usuário indicador</p>                 | Endereços IP registrados na primeira e na atividade mais recente do indicador.                                                       |
| URL da imagem do usuário indicador                                                                                         | URL da imagem ou do avatar do indicador.                                                                                             |
| Localidade do usuário indicador                                                                                            | Configuração de localidade do indicador.                                                                                             |
| Data de criação do usuário indicador                                                                                       | Quando o indicador entrou pela primeira vez ou foi registrado no sistema.                                                            |
| Usuário indicador                                                                                                          | ID interno do indicador no Advocate.                                                                                                 |
| Conta do indicador                                                                                                         | ID da conta associada ao indicador.                                                                                                  |
| **Moderação e status**                                                                                                     |                                                                                                                                      |
| Status da moderação                                                                                                        | Status geral da moderação da indicação. (Por exemplo, *Aprovado*, *Rejeitado*, *Pendente*.)                                          |
| Data da moderação                                                                                                          | A data em que a decisão de moderação (aprovação/rejeição) foi tomada.                                                                |
| Data de pagamento da indicação                                                                                             | Quando qualquer recompensa associada à indicação foi paga.                                                                           |
| Data de encerramento da indicação                                                                                          | Quando o registro da indicação foi oficialmente encerrado (por exemplo, por expiração ou conclusão).                                 |
| Status da moderação do indicado                                                                                            | Status da moderação específico à parte do usuário indicado na indicação.                                                             |
| Status da moderação do indicador                                                                                           | Status da moderação específico à parte do indicador na indicação.                                                                    |
| **Referências de recompensa**                                                                                              |                                                                                                                                      |
| Recompensa do indicado                                                                                                     | ID ou referência da recompensa concedida ao usuário indicado (se aplicável).                                                         |
| Recompensa do indicador                                                                                                    | ID ou referência da recompensa concedida ao indicador (se aplicável).                                                                |

</details>

#### Saldos de recompensas por usuário

O *Saldos de recompensas por usuário* relatório fornece um registro das recompensas pendentes, incluindo o valor e o destinatário pretendido, geradas pelo seu programa de indicação. Esse relatório costuma ser usado como parte do processo de entrega manual de recompensas ou em um processo em lote para um sistema como o Tango Card. Ele também pode ser útil para acompanhar quanto o seu programa de indicação pagou em determinado período.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório inclui:

* Detalhes do participante, como nome, ID de usuário e da conta, endereço de e-mail e outros
* Tipo de recompensa
* Unidade da recompensa
* Valor da recompensa

Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) do relatório de saldos de recompensas.

**Referência das colunas do relatório**

| Coluna                             | Descrição                                                                                                                                                                                  |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Informações do participante**    |                                                                                                                                                                                            |
| ID do usuário                      | Identificador exclusivo do participante no Advocate. Usado para vincular o saldo de recompensas ao usuário correspondente.                                                                 |
| ID da conta                        | ID interno da conta associado ao participante. É especialmente relevante quando os usuários pertencem a organizações ou grupos de contas segmentados.                                      |
| E-mail                             | Endereço de e-mail do participante. Geralmente usado para a entrega manual de recompensas ou para sincronização com sistemas externos.                                                     |
| <p>Nome</p><p>Sobrenome</p>        | Nome e sobrenome do participante. Útil para personalização ou filtragem durante o processamento de recompensas.                                                                            |
| Código de indicação                | Código de indicação atribuído ao participante. É o código que ele compartilha para indicar outras pessoas e acompanhar a elegibilidade às recompensas.                                     |
| **Informações sobre a recompensa** |                                                                                                                                                                                            |
| Tipo                               | Categoria ou método da recompensa (por exemplo, *Dinheiro*, *Cartão-presente*, *Pontos*, *Personalizado*). Ajuda a determinar como as recompensas devem ser entregues ou agrupadas.        |
| Unidade                            | Unidade do valor da recompensa (por exemplo, *USD*, *ZAR*, *Pontos*, *%*). Importante para calcular saldos e processar pagamentos regionais.                                               |
| Valor                              | Saldo total disponível de recompensas pendentes para esse usuário. Esse é o valor principal usado no preparo de pagamentos ou exportações.                                                 |
| Crédito total atribuído            | Valor total de crédito já atribuído a esse usuário (independentemente de resgates). Representa o custo geral do programa alocado a esse participante.                                      |
| Crédito total resgatado            | Parcela total das recompensas que esse participante já resgatou. Útil para auditar os custos efetivos em comparação com os passivos.                                                       |
| Crédito total expirado             | Total de recompensas atribuídas ao usuário que expiraram antes de serem resgatadas. Ajuda a acompanhar recompensas não resgatadas ou oportunidades de entrega perdidas.                    |
| **Metadados do usuário**           |                                                                                                                                                                                            |
| URL da imagem                      | URL da imagem de perfil ou do avatar do participante (se coletada). Usada principalmente para fins estéticos ou em painéis voltados aos usuários, quando aplicável.                        |
| Primeiro IP detectado              | Primeiro endereço IP registrado quando o participante foi adicionado ou se tornou ativo. Útil para conformidade, identificação de localização ou análise de fraudes.                       |
| Último IP registrado               | Endereço IP mais recente associado ao participante. Ajuda a determinar se o usuário ainda está ativo ou engajado.                                                                          |
| Data de criação                    | Data de criação da conta do participante no Advocate. Útil para análises de coortes ou para acompanhar o comportamento em relação às recompensas ao longo do tempo.                        |
| Origem da indicação                | Fonte ou canal original pelo qual o participante foi adquirido (por exemplo, *e-mail*, *orgânico*, *parceiro*). Ajuda a avaliar o alcance e a eficácia do programa de indicação por canal. |
| Localidade                         | Idioma e configuração regional do participante (por exemplo, *en-US*, *fr-FR*). Importante para comunicações personalizadas ou opções regionais de recompensa.                             |

</details>

#### Saldos de recompensas disponíveis por usuário

O *Saldos de recompensas disponíveis por usuário* relatório fornece uma lista de recompensas não resgatadas. Este tipo de relatório deve ser usado como parte do processo de resgate de recompensas em lote [resgate de recompensas em lote](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) processo.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório inclui:

* Detalhes do participante, como nome, ID de usuário e da conta, endereço de e-mail e outros
* Unidade da recompensa
* Moeda da recompensa
* Valor disponível

A lista completa dos campos pode ser encontrada ao [baixar nosso arquivo CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) no relatório de saldos de recompensas disponíveis.

{% hint style="info" %}
**Observação**: Este relatório não inclui detalhes sobre recompensas de Desconto Percentual, Tanque de Combustível ou Cartão-presente. Use o relatório *Saldos de recompensas por usuário* para obter mais detalhes sobre esses tipos de recompensa.
{% endhint %}

**Referência das colunas do relatório**

| Coluna                             | Descrição                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do participante**    |                                                                                                                                                                                                                                                                                                                                                       |
| Nome                               | O primeiro nome do participante, usado para identificação ou personalização durante o processamento das recompensas.                                                                                                                                                                                                                                  |
| Sobrenome                          | Sobrenome do participante.                                                                                                                                                                                                                                                                                                                            |
| E-mail                             | O endereço de e-mail do participante, usado para enviar recompensas ou fazer correspondência com sistemas externos, como um CRM ou provedor de recompensas.                                                                                                                                                                                           |
| ID do usuário                      | O identificador exclusivo atribuído ao participante no Advocate.                                                                                                                                                                                                                                                                                      |
| ID da conta                        | O ID interno da conta associado ao participante.                                                                                                                                                                                                                                                                                                      |
| Segmentos                          | Tags ou categorias usadas para [agrupar participantes](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (por exemplo, *por região*, *estágio do ciclo de vida*, *tipo de cliente*). Úteis para filtrar ou aplicar diferentes regras de resgate. |
| **Status e prazo das recompensas** |                                                                                                                                                                                                                                                                                                                                                       |
| Data do bloqueio                   | A data em que o usuário foi impedido de receber recompensas, se aplicável. O status de bloqueado pode impedir o resgate; este campo indica quando o bloqueio foi aplicado.                                                                                                                                                                            |
| **Dados da recompensa**            |                                                                                                                                                                                                                                                                                                                                                       |
| Nome da unidade                    | O rótulo ou nome de exibição da unidade de recompensa (por exemplo, *Dinheiro por indicação*, *Crédito na loja*). Isso ajuda a diferenciar os vários tipos de recompensa que um programa pode oferecer.                                                                                                                                               |
| Moeda                              | O código da moeda do valor da recompensa (por exemplo, *USD*, *ZAR*, *EUR*). Necessário para resgatar recompensas, especialmente entre países ou sistemas de pagamento.                                                                                                                                                                               |
| Valor disponível                   | O valor da recompensa não resgatada atualmente disponível para este participante. Este é o valor principal usado para determinar quanto será pago.                                                                                                                                                                                                    |
| Valor a resgatar                   | O valor atualmente na fila para resgate (por exemplo, pendente em um resgate em lote ou aguardando processamento). Útil para evitar resgates duplicados ou garantir que não haja sobreposição entre resgates.                                                                                                                                         |
| Valor total resgatado              | O valor total das recompensas que este participante já resgatou. Oferece uma visão dos resgates anteriores e pode ser útil para acompanhar os limites de recompensa                                                                                                                                                                                   |
| Unidade                            | O código interno ou do sistema para a unidade de recompensa (por exemplo, *USD*, *pontos*, etc.). Pode ser usado em chamadas de API ou na lógica interna durante o resgate.                                                                                                                                                                           |

</details>

#### Relatório fiscal W-9 dos EUA

O relatório fiscal W-9 dos EUA mostra o status do formulário W-9 dos participantes nos EUA e as recompensas recebidas ou pendentes por ano.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório inclui:

* Detalhes do participante, como nome, ID de usuário e da conta, endereço de e-mail e outros
* Data em que o formulário W-9 do participante foi marcado como coletado
* Valor tributável nos EUA das recompensas recebidas por ano fiscal
* Número total de recompensas recebidas por cada participante no ano fiscal

**Referência das colunas do relatório**

| Coluna                                                             | Descrição                                                                                                                                                                                                                       |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do participante**                                    |                                                                                                                                                                                                                                 |
| ID do usuário                                                      | Identificador exclusivo do participante no Advocate.                                                                                                                                                                            |
| ID da conta                                                        | ID interno da conta associado ao participante.                                                                                                                                                                                  |
| E-mail                                                             | Endereço de e-mail do participante.                                                                                                                                                                                             |
| Nome                                                               | Nome do participante.                                                                                                                                                                                                           |
| Sobrenome                                                          | Sobrenome do participante.                                                                                                                                                                                                      |
| **Informações fiscais do W-9**                                     |                                                                                                                                                                                                                                 |
| <p>Data de envio do formulário fiscal dos EUA</p><p>AAAA-MM-DD</p> | A data em que o formulário W-9 do participante foi marcado como enviado e coletado no Advocate. É importante para a conformidade com o IRS e para verificar a situação da documentação fiscal.                                  |
| **Resumo do ano fiscal**                                           |                                                                                                                                                                                                                                 |
| Ano                                                                | O ano fiscal em que o participante recebeu recompensas. Usado para agrupar os ganhos por ano-calendário para o processamento do formulário 1099.                                                                                |
| Valor tributável nos EUA em centavos                               | Valor total das recompensas tributáveis nos EUA recebidas por este participante no ano fiscal especificado, expresso em centavos (por exemplo, 2500 = US$ 25,00). Útil para cálculos brutos ou integrações que exigem precisão. |
| Valor tributável nos EUA em dólares                                | Mesmo valor acima, mas exibido no formato monetário padrão (por exemplo, 25,00). Facilita a revisão ou a inclusão em resumos oficiais.                                                                                          |
| Quantidade de recompensas                                          | Número total de recompensas individuais recebidas pelo participante no ano fiscal especificado. Útil para trilhas de auditoria ou para entender a frequência das recompensas e o engajamento no programa.                       |

</details>

#### Pagamentos e impostos

O relatório de *pagamentos e impostos* mostra a situação fiscal dos participantes e as recompensas recebidas ou pendentes por ano.

Se o seu programa oferecer pagamentos em dinheiro aos participantes, alguns campos relacionados à situação dos formulários fiscais dos participantes serão disponibilizados.

<details>

<summary>Detalhes do relatório</summary>

Por padrão, o relatório inclui:

* Detalhes do participante, como nome, ID de usuário e da conta, endereço de e-mail e outros
* Data em que o formulário fiscal do participante — como um W-8 ou W-9 — foi marcado como enviado
* Valor tributável nos EUA das recompensas recebidas por ano fiscal
* Número total de recompensas recebidas por cada participante no ano fiscal
* A situação do formulário fiscal, por exemplo, *válido*, *retido*ou *pendente*. Os motivos da retenção do pagamento também são incluídos no relatório

**Referência das colunas do relatório**

| Coluna                                                             | Descrição                                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do participante**                                    |                                                                                                                                                                                                                                                                       |
| ID do usuário                                                      | Identificador exclusivo do participante no Advocate.                                                                                                                                                                                                                  |
| ID da conta                                                        | O ID da conta do participante, usado para agrupamento ou relatórios organizacionais.                                                                                                                                                                                  |
| E-mail                                                             | Endereço de e-mail do participante.                                                                                                                                                                                                                                   |
| Nome                                                               | Nome do participante.                                                                                                                                                                                                                                                 |
| Sobrenome                                                          | Sobrenome do participante.                                                                                                                                                                                                                                            |
| **Informações fiscais do W-9**                                     |                                                                                                                                                                                                                                                                       |
| <p>Data de envio do formulário fiscal dos EUA</p><p>AAAA-MM-DD</p> | A data em que o participante enviou o formulário W-9 (ou o formulário fiscal pertinente dos EUA). É importante para verificar a elegibilidade fiscal antes de emitir pagamentos em dinheiro.                                                                          |
| **Resumo do ano de pagamento**                                     |                                                                                                                                                                                                                                                                       |
| Ano                                                                | O ano-calendário em que o participante recebeu as recompensas.                                                                                                                                                                                                        |
| Valor                                                              | Valor total dos pagamentos em unidades menores (por exemplo, centavos) recebidos ou pendentes para este participante durante o ano. Por exemplo, 1750 = US$ 17,50.                                                                                                    |
| Valor em dólares                                                   | O mesmo valor, exibido no formato monetário padrão para facilitar a revisão (por exemplo, 17,50).                                                                                                                                                                     |
| Quantidade                                                         | Número total de recompensas individuais de pagamento do participante no ano especificado. Útil para entender com que frequência um participante recebeu pagamentos.                                                                                                   |
| **Elegibilidade e situação dos pagamentos**                        |                                                                                                                                                                                                                                                                       |
| Pagamento retido                                                   | Indica se os pagamentos do participante estão retidos no momento (Sim ou Não). Os pagamentos podem ser retidos devido à falta de formulários fiscais ou à configuração incompleta.                                                                                    |
| Motivos da retenção do pagamento                                   | Explica por que o pagamento do participante está retido (se aplicável). Exemplos de motivos: *Formulário fiscal não enviado*, *Dados bancários não fornecidos*, *Análise de conformidade*.                                                                            |
| Moeda do pagamento                                                 | A moeda em que os pagamentos do participante são ou serão processados (por exemplo, *USD*, *EUR*, *ZAR*). Importante para sistemas globais de pagamento e contabilidade.                                                                                              |
| Configuração de pagamentos iniciada                                | Indica se o participante começou a configurar o método de pagamento (por exemplo, por meio de uma integração com um provedor de pagamentos). Ajuda a acompanhar o progresso da integração ou a identificar a necessidade de acompanhamento para pagamentos pendentes. |

</details>


---

# 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/advocate-reporting-and-analytics/advocate-program-reports-explained.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.
