# Relatórios do Programa Advocate Explicados

<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 seu programa e dados de participantes. Todos os relatórios possuem opções de filtragem para permitir maior controle sobre os dados que você baixa. Cada relatório pode ser baixado como .CSV ou arquivo Excel.

Este artigo explica os diferentes relatórios e que tipo de dados cada um inclui. Consulte [Executar um Relatório de Programa Advocate](https://help.impact.com/brand/pt-br/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report) para 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 em todos os seus programas. Exporte uma lista de todos os participantes para manter seus registros atualizados com os links de compartilhamento e códigos de indicação do Advocate.

<details>

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

Por padrão, o relatório incluirá informações do participante como:

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

Ao gerar o relatório, você pode opcionalmente incluir:

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

Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de amostra](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 de colunas do relatório**

| Coluna                                                   | Descrição                                                                                                                                                                                                                             |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do usuário**                               |                                                                                                                                                                                                                                       |
| ID                                                       | O identificador único do participante dentro do sistema Advocate.                                                                                                                                                                     |
| ID da conta                                              | O identificador único da conta do participante (usado em vários programas, se aplicável).                                                                                                                                             |
| E-mail                                                   | O endereço de e-mail do participante.                                                                                                                                                                                                 |
| Nome                                                     | O primeiro nome do participante.                                                                                                                                                                                                      |
| Sobrenome                                                | O sobrenome do participante.                                                                                                                                                                                                          |
| Hash do e-mail                                           | Uma versão com hash (criptografada) do e-mail do participante, útil para correspondência compatível com privacidade em outros sistemas.                                                                                               |
| **Informações de indicação e compartilhamento**          |                                                                                                                                                                                                                                       |
| Código de indicação                                      | O código único vinculado ao participante, usado para rastrear as indicações que ele gera.                                                                                                                                             |
| Link de compartilhamento                                 | O link de indicação único associado ao participante.                                                                                                                                                                                  |
| Link de compartilhamento do Facebook                     | Um link pré-gerado para compartilhar a indicação no Facebook.                                                                                                                                                                         |
| Link de compartilhamento do Twitter                      | Um link pré-gerado para compartilhar a indicação no Twitter.                                                                                                                                                                          |
| Link de compartilhamento por e-mail                      | Um link pré-gerado para compartilhar a indicação por e-mail.                                                                                                                                                                          |
| Link de compartilhamento do LinkedIn                     | Um link pré-gerado para compartilhar a indicação no LinkedIn.                                                                                                                                                                         |
| Link de compartilhamento limpo                           | Uma versão do link de indicação sem parâmetros de rastreamento; mais neutra para certas plataformas ou casos de uso.                                                                                                                  |
| **Geolocalização e localidade**                          |                                                                                                                                                                                                                                       |
| IP visto pela primeira vez                               | O endereço IP a partir do qual o participante foi registrado pela primeira vez.                                                                                                                                                       |
| IP visto por último                                      | O endereço IP mais recente observado para este participante.                                                                                                                                                                          |
| Localidade                                               | O idioma preferido e configurações regionais do 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).                                                                                                                                                |
| **Carimbos de data/hora**                                |                                                                                                                                                                                                                                       |
| Data de criação                                          | A data e hora 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 conformidade ou processamento de recompensa.                                                                                                               |
| **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, cadastros) resultantes dessas indicações.                                                                                                                                           |
| stats.goals                                              | Número de conclusões de objetivos específicos associadas à atividade de indicação do participante (definidos como personalizados 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 interface de compartilhamento foi carregado por este participante.                                                                                                                       |
| stats.revenue                                            | Receita total gerada por usuários que foram indicados por este participante.                                                                                                                                                          |
| stats.generated Revenue                                  | Sinônimo de stats.revenue; alguns relatórios podem diferenciar se a receita vem de múltiplas fontes.                                                                                                                                  |
| stats.referred Revenue                                   | Receita atribuída especificamente a participantes que se inscreveram ou compraram através do link de indicação deste participante.                                                                                                    |
| **Dados personalizados**                                 |                                                                                                                                                                                                                                       |
| custom Fields.example                                    | Um espaço reservado para quaisquer campos personalizados definidos pelo seu programa (por exemplo, *ID de fidelidade*, *notas internas*, *tag de região*). Cada campo aparecerá como sua própria coluna, com o prefixo custom Fields. |
| **Outros**                                               |                                                                                                                                                                                                                                       |
| Fonte da indicação                                       | A fonte ou canal original que levou o participante ao seu programa (por exemplo, *orgânico*, *e-mail*, *site parceiro*).                                                                                                              |

</details>

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

O *Exportação de eventos do usuário* o relatório fornece um registro de todos os eventos de usuário que recebemos da sua organização para o seu programa Advocate. Você pode aplicar filtros para restringir um intervalo de tempo, chave de evento, ID do usuário e 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 acionada
* Data recebida
* Data processada

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

| Coluna                                                               | Descrição                                                                                                                                                                                      |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do evento e do usuário**                               |                                                                                                                                                                                                |
| ID do evento                                                         | Um ID único gerado para cada evento recebido. Útil para rastreamento, depuração ou auditoria das submissões de evento.                                                                         |
| Chave do evento                                                      | O tipo ou rótulo do evento, como `compra`, `cadastro`, ou qualquer chave definida como personalizada que seu sistema envie.                                                                    |
| ID do usuário                                                        | O identificador único 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 onde usuários podem pertencer a diferentes estruturas de conta.                                                       |
| **Carimbos de data/hora do evento**                                  |                                                                                                                                                                                                |
| Data do evento acionada – AAAA-MM-DD                                 | A data em que o evento realmente ocorreu (conforme relatado pelo seu sistema). Por exemplo, a data em que uma compra ou cadastro ocorreu.                                                      |
| Data do evento recebida – AAAA-MM-DD                                 | A data em que o Advocate recebeu o evento do seu sistema. Pode diferir da data acionada devido a agrupamentos ou atrasos do sistema.                                                           |
| Data do evento processada – AAAA-MM-DD                               | A data em que o evento foi processado com sucesso e armazenado no Advocate. Marca quando o evento se tornou utilizável para rastreamento, recompensas ou relatórios.                           |
| **Campos de dados do evento (se incluídos na carga útil do evento)** |                                                                                                                                                                                                |
| 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 gatilhos de promoções específicas.                   |
| fields.revenue                                                       | O valor de receita associado ao evento. Tipicamente usado em eventos de compra para calcular desempenho, recompensas ou ROI.                                                                   |
| fields.currency                                                      | O código da moeda (por exemplo, *USD*, *ZAR*, *EUR*) vinculado ao valor da receita. Importante ao reportar entre regiões ou calcular recompensas ajustadas por câmbio.                         |
| fields.lead Created Date                                             | A data original em que o lead (usuário) foi criado no seu sistema, se submetida como parte do evento. Ajuda a conectar eventos de usuário às datas de aquisição originais ou registros de CRM. |

</details>

#### Histórico de recompensas

O *Histórico de recompensas* o relatório fornece um registro detalhado de cada uma de suas recompensas e das relações com participantes e indicações. Essas informações podem ser úteis na criação de balancetes, bem como para obter o status de todas as suas recompensas em um determinado momento.

<details>

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

Por padrão, o relatório incluirá **campos de recompensa** 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 amostra](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel de amostra](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 amostra](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) dos relatórios de detalhes da recompensa.

Ao gerar o relatório, você pode opcionalmente 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 da indicação, campos do cliente defensor, campos do amigo indicado e mais.

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

| Coluna                                                                                                             | Descrição                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações da recompensa**                                                                                      |                                                                                                                                                                            |
| ID                                                                                                                 | ID único da instância de recompensa (gerado pelo Advocate).                                                                                                                |
| Tipo                                                                                                               | A categoria ou tipo de recompensa (por exemplo, *Dinheiro*, *Cartão presente*, *Cupom*, *Personalizado*).                                                                  |
| 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/advocate-program/advocate-rewards/create-a-reward)). |
| Fonte da recompensa                                                                                                | Descreve o que acionou a recompensa (por exemplo, *Indicação*, *Meta*, *Manual*, *API*).                                                                                   |
| Tipo de Fuel Tank                                                                                                  | O tipo de fundo de recompensa usado (se estiver usando integração com FuelTank). Ex.: *Pré-pago*, *Cartão presente*.                                                       |
| Código do Fuel Tank                                                                                                | O código associado ao atendimento externo (por exemplo, código de voucher ou cartão presente).                                                                             |
| ID do programa                                                                                                     | ID do programa Advocate sob o qual a recompensa foi emitida.                                                                                                               |
| Chave de recompensa do programa                                                                                    | Identificador interno para a configuração específica de recompensa usada dentro do programa.                                                                               |
| Chave global da recompensa                                                                                         | Identificador entre programas para recompensas configuradas em nível global (se aplicável).                                                                                |
| **Carimbos de data/hora da recompensa**                                                                            |                                                                                                                                                                            |
| Data de criação                                                                                                    | Quando o registro da recompensa foi criado no sistema.                                                                                                                     |
| Data agendada para                                                                                                 | Quando a recompensa foi programada para ser emitida (por exemplo, após um atraso ou período de espera).                                                                    |
| Data concedida                                                                                                     | Quando a recompensa foi efetivamente emitida ao participante.                                                                                                              |
| Data de expiração                                                                                                  | A data de expiração da recompensa (se aplicável).                                                                                                                          |
| Data cancelada                                                                                                     | A data em que a recompensa foi anulada ou cancelada.                                                                                                                       |
| Data resgatada                                                                                                     | A data em que o participante resgatou a recompensa (se aplicável).                                                                                                         |
| Data modificada                                                                                                    | A data em que a atualização mais recente no registro da recompensa foi feita.                                                                                              |
| **Rastreamento de crédito e valor**                                                                                |                                                                                                                                                                            |
| Crédito atribuído                                                                                                  | A quantia de crédito atribuída a esta recompensa (pode diferir do valor em alguns modelos).                                                                                |
| Crédito resgatado                                                                                                  | A quantia de crédito que foi resgatada da recompensa.                                                                                                                      |
| Valor disponível                                                                                                   | A porção restante não utilizada ou não resgatada da recompensa.                                                                                                            |
| **Status e mensagens da recompensa**                                                                               |                                                                                                                                                                            |
| Status                                                                                                             | Status atual da recompensa (por exemplo, *Pendente*, *Agendado*, *Concedido*, *Expirado*, *Cancelado*).                                                                    |
| meta.status                                                                                                        | Status técnico ou em nível de sistema (útil para diagnóstico ou tratamento de erros).                                                                                      |
| meta.message                                                                                                       | Mensagem vinculada à entrega da recompensa (por exemplo, “Recompensa entregue com sucesso”).                                                                               |
| meta.internal Message                                                                                              | Observações internas apenas para administradores (por exemplo, explicações de falha ou sinalizações).                                                                      |
| meta.date Modified                                                                                                 | Última vez em que os metadados relacionados à recompensa foram atualizados.                                                                                                |
| meta.customMeta.testMeta                                                                                           | Um espaço reservado para quaisquer campos de metadados personalizados que seu programa envie (neste caso, testMeta é um exemplo).                                          |
| **Informações do participante (usuário)**                                                                          |                                                                                                                                                                            |
| user.id                                                                                                            | ID do usuário que recebe a recompensa.                                                                                                                                     |
| user.account Id                                                                                                    | O 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 CRM.                                                                                  |
| **Contexto da indicação (se a recompensa for baseada em indicação)**                                               |                                                                                                                                                                            |
| referral.id                                                                                                        | O ID da indicação que acionou esta recompensa.                                                                                                                             |
| referral.date Referral Started                                                                                     | Quando a ação de indicação começou (por exemplo, evento de 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 inscrever ou agir.                                                                                                            |
| **Informações do usuário indicado (amigo)**                                                                        |                                                                                                                                                                            |
| referral.referred User.id                                                                                          | ID da pessoa que foi indicada (o “amigo”).                                                                                                                                 |
| referral.referred User.account Id                                                                                  | O ID de conta único do indicado.                                                                                                                                           |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Os detalhes de contato básicos do indicado.                                                                                                                                |
| **Informações do indicante (Advocate)**                                                                            |                                                                                                                                                                            |
| referral.referrer User.id                                                                                          | ID da pessoa que fez a indicação (o “advogado/indicador”).                                                                                                                 |
| referral.referrer User.account Id                                                                                  | O ID de conta único do indicado.                                                                                                                                           |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Os detalhes de contato básicos do indicado.                                                                                                                                |
| referral.date Converted                                                                                            | A data em que a indicação foi oficialmente convertida (por exemplo, cadastro ou compra concluída), acionando a recompensa.                                                 |

</details>

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

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

<details>

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

Por padrão, o relatório inclui:

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

Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de amostra](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) relatório de atividade de indicação.

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

| Coluna                                                                                                           | Descrição                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Metadados da indicação**                                                                                       |                                                                                                                            |
| ID                                                                                                               | Identificador único do registro de indicação no Advocate.                                                                  |
| Data modificada                                                                                                  | A data mais recente em que qualquer parte do registro da indicação foi atualizada.                                         |
| Data em que a indicação começou                                                                                  | Quando a indicação foi iniciada pela primeira vez (por exemplo, quando o usuário indicado clicou em um link de indicação). |
| Data convertida                                                                                                  | Quando a indicação converteu, normalmente quando o usuário indicado completou a ação exigida (como um cadastro ou compra). |
| Data em que o usuário foi modificado                                                                             | A última vez em que os dados do usuário envolvidos nesta indicação (indicante ou indicado) foram atualizados.              |
| ID do programa                                                                                                   | O ID do programa de indicação do Advocate ao qual esta indicação pertence.                                                 |
| Nome do programa                                                                                                 | O nome do programa de indicação, útil se estiver gerenciando vários programas.                                             |
| **Informações do amigo indicado (novo cliente)**                                                                 |                                                                                                                            |
| <p>E-mail do usuário indicado</p><p>Primeiro nome do usuário indicado</p><p>Sobrenome do usuário indicado</p>    | Informações básicas de identidade 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 outros depois).                         |
| <p>IP visto pela primeira vez do usuário indicado</p><p>IP visto por último 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 avatar, se capturado ou atribuído 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 indicada                                                                                                   | ID de conta interno vinculado ao usuário indicado (usado em programas com múltiplas contas).                               |
| **Informações do indicante (cliente indicador)**                                                                 |                                                                                                                            |
| <p>E-mail do usuário indicante</p><p>Primeiro nome do usuário indicante</p><p>Sobrenome do usuário indicante</p> | Informações básicas de identidade do participante que indicou.                                                             |
| Código de indicação do usuário indicante                                                                         | O código de indicação pertencente ao indicante, o código que o usuário indicado provavelmente usou.                        |
| <p>IP visto pela primeira vez do usuário indicante</p><p>IP visto por último do usuário indicante</p>            | Endereços IP registrados na primeira e na atividade mais recente do indicante.                                             |
| URL da imagem do usuário indicante                                                                               | A URL da imagem ou avatar do indicante.                                                                                    |
| Localidade do usuário indicante                                                                                  | Configuração de localidade do indicante.                                                                                   |
| Data de criação do usuário indicante                                                                             | Quando o indicante se juntou ou foi registrado no sistema pela primeira vez.                                               |
| Usuário indicante                                                                                                | ID interno do indicante no Advocate.                                                                                       |
| Conta do indicante                                                                                               | ID da conta associada ao indicante.                                                                                        |
| **Moderação e status**                                                                                           |                                                                                                                            |
| Status da moderação                                                                                              | Status geral de moderação da indicação. (Por exemplo, *Aprovado*, *Rejeitado*, *Pendente*.)                                |
| Data de 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 foi paga pela indicação.                                                              |
| Data de término da indicação                                                                                     | Quando o registro da indicação foi oficialmente encerrado (por exemplo, devido a expiração ou conclusão).                  |
| Status de moderação do indicado                                                                                  | Status de moderação específico à parte do usuário indicado na indicação.                                                   |
| Status de moderação do indicante                                                                                 | Status de moderação específico à parte do indicante na indicação.                                                          |
| **Referências de recompensa**                                                                                    |                                                                                                                            |
| Recompensa do indicado                                                                                           | O ID ou referência da recompensa emitida ao usuário indicado (se aplicável).                                               |
| Recompensa do indicante                                                                                          | O ID ou referência da recompensa emitida ao indicante (se aplicável).                                                      |

</details>

#### Saldos de recompensa por usuário

O *Saldos de recompensa por usuário* o relatório fornece um registro de recompensas pendentes, incluindo o valor e o destinatário pretendido, que foram geradas através do seu programa de indicação. Este relatório é frequentemente usado como parte do cumprimento manual de recompensas, ou como parte de um processo em lote para um sistema como o Tango Card. Também pode ser útil para rastrear quanto seu programa de indicação pagou em um determinado período.

<details>

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

Por padrão, o relatório inclui:

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

Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de amostra](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) relatório de saldos de recompensa.

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

| Coluna                          | Descrição                                                                                                                                                                                          |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do participante** |                                                                                                                                                                                                    |
| ID do usuário                   | O identificador único do participante dentro do Advocate. Usado para vincular o saldo da recompensa ao usuário individual.                                                                         |
| ID da conta                     | O ID de conta interno associado ao participante. Especialmente relevante se os usuários pertencerem a organizações ou grupos de contas segmentados.                                                |
| E-mail                          | O endereço de e-mail do participante. Frequentemente usado para cumprimento manual da recompensa ou sincronização com sistemas externos.                                                           |
| <p>Nome</p><p>Sobrenome</p>     | O primeiro e o último nome do participante. Útil para personalização ou filtragem durante o processamento de recompensas.                                                                          |
| Código de indicação             | O código de indicação atribuído ao participante. É o que eles compartilham para indicar outros e rastrear a elegibilidade para recompensas.                                                        |
| **Informações da recompensa**   |                                                                                                                                                                                                    |
| Tipo                            | A categoria ou método da recompensa (por exemplo, *Dinheiro*, *Cartão presente*, *Pontos*, *Personalizado*). Ajuda a determinar como as recompensas devem ser cumpridas ou agrupadas.              |
| Unidade                         | A unidade do valor da recompensa (por exemplo, *USD*, *ZAR*, *Pontos*, *%*). Importante para calcular saldos e para tratamento regional de pagamentos.                                             |
| Quantia                         | O saldo disponível total de recompensas pendentes para este usuário. Esta é a figura central usada ao preparar pagamentos ou exportações.                                                          |
| Crédito total atribuído         | O montante total de crédito que já foi atribuído a este usuário (independentemente do resgate). Reflete o custo total do programa alocado a este participante.                                     |
| Crédito total resgatado         | A parte total de recompensas que este participante já resgatou. Útil para auditoria de custos reais versus passivos.                                                                               |
| Crédito total expirado          | Total de recompensas que foram atribuídas ao usuário, mas expiraram antes de serem resgatadas. Ajuda a rastrear recompensas não reclamadas ou oportunidades de atendimento perdidas.               |
| **Metadados do usuário**        |                                                                                                                                                                                                    |
| URL da imagem                   | URL da imagem de perfil ou avatar do participante (se coletada). Principalmente estética ou usada em painéis voltados ao usuário, se aplicável.                                                    |
| IP visto pela primeira vez      | O primeiro endereço IP registrado quando o participante foi adicionado ou tornou-se ativo. Útil para conformidade, marcação de localização ou análise de fraude.                                   |
| IP visto por último             | O endereço IP mais recente associado ao participante. Ajuda a determinar se o usuário ainda está ativo ou engajado.                                                                                |
| Data de criação                 | A data em que a conta do participante foi criada no Advocate. Útil para análise de coorte ou comportamento de recompensa ao longo do tempo.                                                        |
| Fonte da indicação              | A fonte original ou canal através do 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                      | A configuração de idioma e regional do participante (por exemplo, *en-US*, *fr-FR*). Importante para comunicações personalizadas ou opções regionais de recompensa.                                |

</details>

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

O *Saldos de recompensa disponíveis por usuário* o relatório fornece uma lista de recompensas não resgatadas. Este tipo de relatório destina-se a ser usado como parte do cumprimento de recompensas através do [processo de resgate em massa de recompensas](https://help.impact.com/brand/pt-br/advocate-program/advocate-rewards/redeem-rewards-in-bulk) .

<details>

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

Por padrão, o relatório inclui:

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

Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de amostra](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 recompensa disponíveis.

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

**Referência de 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 da recompensa.                                                                                                                                                                                                 |
| Sobrenome                             | O sobrenome do participante.                                                                                                                                                                                                                                                                                       |
| E-mail                                | O endereço de e-mail do participante, usado para enviar recompensas ou combinar com sistemas externos como um CRM ou provedor de recompensas.                                                                                                                                                                      |
| ID do usuário                         | O identificador único atribuído ao participante dentro do Advocate.                                                                                                                                                                                                                                                |
| ID da conta                           | O ID interno da conta vinculado ao participante.                                                                                                                                                                                                                                                                   |
| Segmentos                             | Tags ou categorias usadas para [agrupar participantes](https://help.impact.com/brand/pt-br/advocate-program/manage-advocate-participants/manage-advocate-user-segments) (por exemplo, *por região*, *estágio do ciclo de vida*, *tipo de cliente*). Útil para filtrar ou aplicar diferentes regras de cumprimento. |
| **Status e Cronograma de Recompensa** |                                                                                                                                                                                                                                                                                                                    |
| Data Bloqueada                        | A data em que o usuário foi bloqueado de receber recompensas, se aplicável. Um status de bloqueado pode impedir a resgate; este campo indica quando esse bloqueio foi aplicado.                                                                                                                                    |
| **Dados da Recompensa**               |                                                                                                                                                                                                                                                                                                                    |
| Nome da Unidade                       | O rótulo ou nome exibido da unidade de recompensa (por exemplo, *Dinheiro por Indicação*, *Crédito na Loja*). Isso ajuda a distinguir entre 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 ao cumprir recompensas, especialmente entre países ou sistemas de pagamento.                                                                                                                                               |
| Valor disponível                      | A quantidade de recompensa não resgatada atualmente disponível para este participante. Este é o valor principal usado ao determinar o que pagar.                                                                                                                                                                   |
| Valor a Resgatar                      | O valor atualmente enfileirado para resgate (por exemplo, pendente em um cumprimento em massa ou aguardando processamento). Útil para evitar resgates duplos ou garantir que não haja sobreposição nos resgates.                                                                                                   |
| Valor Total Resgatado                 | O valor total de recompensas que este participante já resgatou. Fornece informações sobre resgates passados e pode ser útil para acompanhamento de 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 lógica interna durante o cumprimento.                                                                                                                                       |

</details>

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

O relatório fiscal US W-9 mostra o status fiscal W-9 dos participantes e recompensas ganhas ou pendentes por ano.

<details>

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

Por padrão, o relatório inclui:

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

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

| Coluna                                                             | Descrição                                                                                                                                                                                                                      |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Informações do participante**                                    |                                                                                                                                                                                                                                |
| ID do usuário                                                      | O identificador exclusivo do participante no Advocate.                                                                                                                                                                         |
| ID da conta                                                        | ID interno da conta associado ao participante.                                                                                                                                                                                 |
| E-mail                                                             | O endereço de e-mail do participante.                                                                                                                                                                                          |
| Nome                                                               | O primeiro nome do participante.                                                                                                                                                                                               |
| Sobrenome                                                          | O sobrenome do participante.                                                                                                                                                                                                   |
| **Informações fiscais 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 conformidade com o IRS e verificação do status da documentação fiscal.                                         |
| **Resumo do Ano Fiscal**                                           |                                                                                                                                                                                                                                |
| Ano                                                                | O ano fiscal em que o participante ganhou recompensas. Usado para agrupar ganhos por ano civil para processamento do 1099.                                                                                                     |
| Valor Tributável nos EUA em Centavos                               | Valor total de recompensas tributáveis nos EUA ganhas por este participante no ano fiscal especificado, expresso em centavos (por exemplo, 2500 = $25,00). Ajuda em cálculos brutos ou integrações onde é necessária precisão. |
| Valor Tributável nos EUA em Dólares                                | Mesmo que acima, mas exibido no formato padrão em dólares (por exemplo, 25,00). Mais fácil para revisão ou inclusão em resumos oficiais.                                                                                       |
| Contagem de Recompensas                                            | Número total de ocorrências individuais de recompensa ganhas pelo participante no ano fiscal especificado. Útil para trilhas de auditoria ou para entender a frequência de recompensas e o engajamento no programa.            |

</details>

#### Pagamentos e impostos

O *Pagamento e imposto* relatório mostra o status fiscal dos participantes e recompensas ganhas ou pendentes por ano.

Se seu programa fornece pagamentos em dinheiro aos participantes, certos campos relacionados ao status do formulário fiscal do participante estarão disponíveis.

<details>

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

Por padrão, o relatório inclui:

* Detalhes do participante como nome, ID do usuário e da conta, endereço de e-mail e mais
* 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 ganhas por ano fiscal
* Número total de recompensas ganhas pelo participante no ano fiscal
* O status do formulário fiscal, por exemplo, *válido*, *em espera*, ou *pendente*. As razões de retenção de pagamento também estão incluídas no relatório

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

| Coluna                                                             | Descrição                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Informações do participante**                                    |                                                                                                                                                                                                                                            |
| ID do usuário                                                      | O identificador exclusivo do participante no Advocate.                                                                                                                                                                                     |
| ID da conta                                                        | O ID da conta do participante, usado para agrupamento ou relatórios organizacionais.                                                                                                                                                       |
| E-mail                                                             | O endereço de e-mail do participante.                                                                                                                                                                                                      |
| Nome                                                               | O primeiro nome do participante.                                                                                                                                                                                                           |
| Sobrenome                                                          | O sobrenome do participante.                                                                                                                                                                                                               |
| **Informações fiscais 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 seu W-9 (ou formulário fiscal dos EUA relevante). Importante para verificar a elegibilidade fiscal antes de emitir pagamentos em dinheiro.                                                             |
| **Resumo do Ano de Pagamento**                                     |                                                                                                                                                                                                                                            |
| Ano                                                                | O ano civil em que o participante ganhou as recompensas.                                                                                                                                                                                   |
| Valor                                                              | Valor total de pagamento em unidades menores (por exemplo, centavos) ganhas ou pendentes para este participante durante o ano. Por exemplo, 1750 = $17,50.                                                                                 |
| Valor em Dólares                                                   | Mesmo valor, exibido no formato padrão de moeda para fácil revisão (por exemplo, 17,50).                                                                                                                                                   |
| Contagem                                                           | Número total de ocorrências individuais de recompensas de pagamento para o participante no ano especificado. Útil para entender com que frequência um participante recebeu pagamentos.                                                     |
| **Elegibilidade e Status de Pagamento**                            |                                                                                                                                                                                                                                            |
| Retenção de Pagamento                                              | Indica se os pagamentos do participante estão atualmente retidos (Sim ou Não). Os pagamentos podem ser retidos devido à falta de formulários fiscais ou configuração incompleta.                                                           |
| Razões de Retenção de Pagamento                                    | Explica por que o participante está em retenção de pagamento (se aplicável). Exemplos de razões: *Formulário fiscal ausente*, *Informações bancárias não fornecidas*, *Revisão de conformidade*.                                           |
| Moeda de Pagamento                                                 | A moeda em que os pagamentos do participante estão ou serão processados (por exemplo, *USD*, *EUR*, *ZAR*). Importante para sistemas de pagamento globais e contabilidade.                                                                 |
| Iniciou Configuração de Pagamento                                  | Indica se o participante começou a configurar seu método de pagamento (por exemplo, via integração com um provedor de pagamentos). Ajuda a rastrear o progresso de integração ou necessidades de acompanhamento para pagamentos pendentes. |

</details>
