> 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).
# Relatórios do programa Advocate explicados
Faça o curso PXA
O Advocate oferece vários relatórios para download do seu programa e dos dados dos participantes. Todos os relatórios têm opções de filtro para permitir maior controle sobre os dados que você baixa. Cada relatório pode ser baixado como arquivo .CSV ou Excel.
Este artigo explica os diferentes relatórios e que tipo de dados cada um inclui. Consulte [Executar um relatório do programa Advocate](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) para instruções sobre como gerar um relatório.
#### Relatório de detalhes do usuário
O *Detalhes do usuário* relató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.
Detalhes do relatório
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 indicação (se aplicável)
Ao gerar o relatório, você pode incluir opcionalmente:
* **Estatísticas do usuário**, incluindo informações analíticas sobre o 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 registros de contato no seu CMS ou sistema de e-mail e incluir os links e códigos de compartilhamento do Advocate de cada participante.
Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv)  relatório de detalhes do usuário.
**Referência das colunas do relatório**
| Coluna | Descrição |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do usuário** | |
| ID | O identificador exclusivo do participante dentro do sistema Advocate. |
| ID da Conta | O identificador exclusivo 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 em conformidade com a privacidade com outros sistemas. |
| **Informações de indicação e compartilhamento** | |
| Código de indicação | O código exclusivo vinculado ao participante, usado para rastrear as indicações que ele gera. |
| Link de compartilhamento | O link de indicação exclusivo 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 determinadas 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. |
| Último IP visto | O endereço IP mais recente visto para este participante. |
| Localidade | O idioma preferido e as 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 a 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 da recompensa. |
| **Estatísticas do usuário (se incluídas na exportação)** | |
| stats.date Modificado | A última data em que as estatísticas do participante foram atualizadas. |
| stats.tráfego | Número total de visitas geradas pela atividade de indicação do participante. |
| stats.indicações | Número total de indicações bem-sucedidas feitas pelo participante. |
| stats.conversões | Número total de conversões (por exemplo, compras, cadastros) resultantes dessas indicações. |
| stats.metas | Número de conclusões de metas específicas associadas à atividade de indicação do participante (definidas de forma personalizada no programa). |
| stats.recompensas | Número total de recompensas que o participante ganhou. |
| stats.aberturas do widget | Número de vezes que o widget de indicação ou a interface de compartilhamento foi carregado por este participante. |
| stats.receita | Receita total gerada por usuários indicados por este participante. |
| stats.receita gerada | Sinônimo de stats.revenue; alguns relatórios podem diferenciar se a receita vem de várias fontes. |
| stats.receita indicada | Receita atribuída especificamente aos participantes que se cadastraram ou compraram por meio do link de indicação deste participante. |
| **Dados personalizados** | |
| custom Fields.exemplo | Um placeholder 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, prefixado com custom Fields. |
| **Outros** | |
| Origem da indicação | A fonte ou canal original que levou o participante ao seu programa (por exemplo, *orgânico*, *e-mail*, *site parceiro*). |
#### Exportação de eventos do usuário
O *Exportação de evento do usuário* 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 do evento, ID do usuário e muito mais.
Detalhes do relatório
Por padrão, o relatório inclui:
* ID do evento
* Chave do evento
* ID do usuário e da conta
* Data de disparo
* Data de recebimento
* Data de 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 rastreamento, depuração ou auditoria dos envios de eventos. |
| Chave do evento | O tipo ou rótulo do evento, como `purchase`, `cadastro`, ou qualquer chave definida de forma personalizada que seu sistema envie. |
| 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 em que os usuários podem pertencer a diferentes estruturas de conta. |
| **Carimbos de data/hora do evento** | |
| Data de disparo do evento – YYYY-MM-DD | A data em que o evento realmente aconteceu (conforme informado pelo seu sistema). Por exemplo, a data em que ocorreu uma compra ou cadastro. |
| 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 de disparo devido ao processamento em lote ou a atrasos do 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 estar disponível para rastreamento, recompensas ou relatórios. |
| **Campos de dados do evento (se incluídos nos payloads do seu evento)** | |
| fields.cupom | 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 acionadores de promoções específicas. |
| fields.receita | O valor da receita associada ao evento. Normalmente usado em eventos de compra para calcular desempenho, recompensas ou ROI. |
| fields.moeda | O código da moeda (por exemplo, *USD*, *ZAR*, *EUR*) vinculado ao valor da receita. Importante ao relatar entre regiões ou calcular recompensas ajustadas à taxa de câmbio. |
| fields.data de criação do lead | A data original em que o lead (usuário) foi criado no seu sistema, se enviada como parte do evento. Ajuda a relacionar eventos do usuário com datas originais de aquisição ou registros do CRM. |
#### Histórico de recompensas
O *Histórico de recompensas* relatório 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, além de obter o status de todas as suas recompensas em um determinado momento.
Detalhes do relatório
Por padrão, o relatório incluirá **campos da 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 exemplo](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)  ou [JSONL de amostra](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl)  relatórios de detalhes da recompensa.
Ao gerar o relatório, você pode incluir opcionalmente:
* **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 customer advocate, campos do amigo indicado e muito mais.
**Referência das colunas do relatório**
| Coluna | Descrição |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações da recompensa** | |
| ID | ID exclusivo da instância da recompensa (gerado pelo Advocate). |
| Tipo | A categoria ou tipo da 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 exibido da recompensa (conforme definido na [configuração da recompensa](/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 Fuel Tank | O tipo de fundo de recompensa usado (se estiver usando a integração FuelTank). Ex.: *Pré-pago*, *Cartão-presente*. |
| Código do Fuel Tank | O código associado ao atendimento externo (por exemplo, voucher ou código de cartão-presente). |
| ID do programa | ID do programa Advocate sob o qual a recompensa foi emitida. |
| Chave da recompensa do programa | Identificador interno da configuração específica da 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 agendada para ser emitida (por exemplo, após um atraso ou período de espera). |
| Data Concedida | Quando a recompensa foi realmente emitida para o 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 Resgatada | A data em que o participante resgatou a recompensa (se aplicável). |
| Data da modificação | A data em que a atualização mais recente do registro da recompensa foi feita. |
| **Rastreamento de crédito e valor** | |
| Crédito atribuído | A quantidade de crédito atribuída a esta recompensa (pode diferir do valor em alguns modelos). |
| Crédito resgatado | A quantidade de crédito que foi resgatada da recompensa. |
| Valor disponível | A parte restante da recompensa que não foi usada nem resgatada. |
| **Status e mensagens da recompensa** | |
| Status | Status atual da recompensa (por exemplo, *Pendente*, *Agendada*, *Concedida*, *Expirada*, *Cancelado*). |
| meta.status | Status técnico ou em nível de sistema (útil para diagnósticos ou tratamento de erros). |
| meta.mensagem | Mensagem vinculada à entrega da recompensa (por exemplo, “Recompensa entregue com sucesso”). |
| meta.mensagem interna | Observações internas apenas para administradores (por exemplo, explicações de falhas ou sinalizações). |
| meta.data Modificada | Última vez em que os metadados relacionados à recompensa foram atualizados. |
| meta.customMeta.testMeta | Um placeholder para quaisquer campos personalizados de metadados enviados pelo seu programa (neste caso, testMeta é um exemplo). |
| **Informações do participante (usuário)** | |
| user.id | ID do usuário que está recebendo a recompensa. |
| user.id da conta | O ID da conta associada do usuário no Advocate. |
| user.primeiro Nome
user.último Nome
user.e-mail
| 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 | O ID da indicação que acionou esta recompensa. |
| referral.data de início da indicação | Quando a ação de indicação começou (por exemplo, clique ou evento de compartilhamento). |
| referral.data Modificada | Quando o registro da indicação foi atualizado pela última vez. |
| referral.código de indicação usado | O código que o usuário indicado usou para entrar ou realizar uma ação. |
| **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 exclusivo do indicador. |
| referral.referred User.first Name
referral.referred User.last Name
referral.referred User.email
| Os detalhes básicos de contato do indicador. |
| **Informações do indicador (Customer Advocate)** | |
| referral.referrer User.id | ID da pessoa que fez a indicação (o “advogado”). |
| referral.referrer User.account Id | O ID de conta exclusivo do indicador. |
| referral.referrer User.first Name
referral.referrer User.last Name
referral.referrer User.email
| Os detalhes básicos de contato do indicador. |
| referral.data de conversão | A data em que a indicação converteu oficialmente (por exemplo, cadastro ou compra concluídos), acionando a recompensa. |
#### 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 seu programa e acompanhar o número de novos clientes que ele trouxe.
Detalhes do relatório
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 customer advocate, 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 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)  relatório de atividade de indicação.
**Referência das colunas do relatório**
| Coluna | Descrição |
| ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Metadados da indicação** | |
| ID | Identificador exclusivo do registro de indicação no Advocate. |
| Data da modificação | A data mais recente em que qualquer parte do registro de indicação foi atualizada. |
| Data de início da indicação | Quando a indicação foi iniciada pela primeira vez (por exemplo, quando o usuário indicado clicou em um link de indicação). |
| Data da conversão | Quando a indicação converteu, normalmente quando o usuário indicado concluiu a ação exigida (como um cadastro ou compra). |
| Data de modificação do usuário | A última vez em que os dados do usuário envolvidos nesta indicação (indicador 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)** | |
| E-mail do usuário indicado
Primeiro nome do usuário indicado
Sobrenome do usuário indicado
| 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 outras pessoas depois). |
| IP visto pela primeira vez do usuário indicado
Último IP visto do usuário indicado
| 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 interno da conta vinculado ao usuário indicado (usado em programas com várias contas). |
| **Informações do indicador (Customer Advocate)** | |
| E-mail do usuário indicador
Primeiro nome do usuário indicador
Sobrenome do usuário indicador
| Informações básicas de identidade do participante indicador. |
| Código de indicação do usuário indicador | O código de indicação pertencente ao indicador, o código que o usuário indicado provavelmente usou. |
| IP visto pela primeira vez do usuário indicador
Último IP visto do usuário indicador
| Endereços IP registrados na primeira e na atividade mais recente do indicador. |
| URL da imagem do usuário indicador | A URL da imagem ou 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 associado ao indicador. |
| **Moderação e status** | |
| Status de moderação | Status geral de moderação da indicação. (Ex.: *Aprovada*, *Rejeitada*, *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 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 da parte do usuário indicado na indicação. |
| Status de moderação de quem indicou | Status de moderação específico da parte de quem indicou na indicação. |
| **Referências da recompensa** | |
| Recompensa do indicado | O ID ou a referência da recompensa atribuída ao usuário indicado (se aplicável). |
| Recompensa de quem indicou | O ID ou a referência da recompensa atribuída a quem indicou (se aplicável). |
#### 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, que foram geradas por meio do seu programa de indicações. 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 acompanhar quanto seu programa de indicações pagou em um determinado período de tempo.
Detalhes do relatório
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 muito mais
* 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)  relatório de saldos de recompensas.
**Referência das colunas do relatório**
| Coluna | Descrição |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Informações do participante** | |
| ID do Usuário | O identificador exclusivo do participante no Advocate. Usado para vincular o saldo da recompensa ao usuário individual. |
| ID da Conta | O ID interno da conta 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 concessão manual de recompensas ou sincronização com sistemas externos. |
| Nome
Sobrenome
| O nome e sobrenome do participante. Útil para personalização ou filtragem durante o processamento da recompensa. |
| Código de indicação | O código de indicação atribuído ao participante. É o que ele compartilha para indicar outras pessoas e acompanhar a elegibilidade à recompensa. |
| **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 processadas ou agrupadas. |
| Unidade | A unidade do valor da recompensa (por exemplo, *USD*, *ZAR*, *Pontos*, *%*). Importante para calcular saldos e para o tratamento de pagamentos por região. |
| Amount | O saldo total disponível de recompensas pendentes para este usuário. Este é o valor principal usado ao preparar pagamentos ou exportações. |
| Crédito total atribuído | O valor 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 das recompensas que este participante já resgatou. Útil para auditar os custos reais versus os passivos. |
| Crédito total expirado | Total de recompensas atribuídas ao usuário, mas que expiraram antes de serem resgatadas. Ajuda a acompanhar recompensas não resgatadas ou oportunidades de cumprimento perdidas. |
| **Metadados do usuário** | |
| URL da imagem | URL da imagem de perfil ou avatar do participante (se coletada). Principalmente estético ou usado 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 se tornou ativo. Útil para conformidade, marcação de localização ou análise de fraude. |
| Último IP visto | 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 coortes ou do comportamento de recompensas ao longo do tempo. |
| Origem da indicação | A fonte original ou o canal por meio 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ções por canal. |
| Localidade | O idioma e a configuração regional do participante (por exemplo, *en-US*, *fr-FR*). Importante para comunicações personalizadas ou opções regionais de recompensa. |
#### Saldos de prêmios disponíveis por usuário
O *Saldos de prêmios disponíveis por usuário* relatório fornece uma lista de recompensas não resgatadas. Esse tipo de relatório destina-se a ser usado como parte do cumprimento de recompensas por meio do [resgate em massa de recompensas](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) processo.
Detalhes do relatório
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 muito mais
* Unidade da recompensa
* Moeda da recompensa
* Valor disponível
Uma lista completa dos campos pode ser encontrada ao [baixar nosso CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv)  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 *Saldos de recompensas por usuário* relatório para mais detalhes sobre esses tipos de recompensas.
{% 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 da recompensa. |
| Sobrenome | O sobrenome do participante. |
| E-mail | O endereço de e-mail do participante, usado para enviar recompensas ou sincronizar 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 vinculado ao participante. |
| Segmentos | Tags ou categorias usadas para [agrupar participantes](/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*). Útil para filtrar ou aplicar diferentes regras de cumprimento. |
| **Status e momento da recompensa** | |
| Data de bloqueio | A data em que o usuário foi bloqueado de receber recompensas, se aplicável. Um status bloqueado pode impedir o resgate; este campo indica quando esse bloqueio foi aplicado. |
| **Dados da recompensa** | |
| Nome da unidade | O rótulo ou nome de exibição da unidade da recompensa (por exemplo, *Dinheiro de 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 de moeda do valor da recompensa (por exemplo, *USD*, *ZAR*, *EUR*). Necessário ao conceder 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 ao determinar o que pagar. |
| Valor a resgatar | O valor atualmente na fila para resgate (por exemplo, pendente em um processamento em lote ou aguardando processamento). Útil para evitar resgate duplo ou garantir que não haja sobreposição nos resgates. |
| Valor total resgatado | O valor total de recompensas que este participante já resgatou. Oferece insights sobre resgates anteriores e pode ser útil para acompanhamento de limites de recompensa |
| Unidade | O código interno ou do sistema para a unidade da recompensa (por exemplo, *USD*, *pontos*, etc.). Pode ser usado em chamadas de API ou na lógica interna durante o cumprimento. |
#### relatório fiscal W-9 dos EUA
O relatório fiscal W-9 dos EUA mostra o status fiscal W-9 dos participantes e as recompensas obtidas ou pendentes por ano.
Detalhes do relatório
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 muito mais
* Data em que o formulário W-9 do participante foi marcado como coletado
* Valor tributável nos EUA das recompensas obtidas por ano fiscal
* Quantidade total de recompensas obtidas por cada participante no ano fiscal
**Referência das 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 do W-9** | |
| Data de envio do formulário fiscal dos EUA
AAAA-MM-DD
| 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 para verificar o status da documentação fiscal. |
| **Resumo do ano fiscal** | |
| Ano | O ano fiscal em que o participante obteve recompensas. Usado para agrupar ganhos por ano-calendário para processamento do 1099. |
| Valor tributável nos EUA em centavos | Valor total de recompensas tributáveis nos EUA obtidas por este participante no ano fiscal especificado, expresso em centavos (por exemplo, 2500 = US$ 25,00). Ajuda com cálculos brutos ou integrações em que a precisão é necessária. |
| Valor tributável nos EUA em dólares | Mesmo valor, exibido no formato padrão de dólares para facilitar a revisão ou inclusão em resumos oficiais (por exemplo, 25,00). |
| Quantidade de recompensas | Número total de ocorrências individuais de recompensas obtidas pelo participante no ano fiscal especificado. Útil para trilhas de auditoria ou para entender a frequência de recompensas e o engajamento no programa. |
#### Pagamentos e impostos
O *Pagamento e imposto* relatório mostra o status fiscal dos participantes e as recompensas obtidas ou pendentes por ano.
Se o seu programa fornecer pagamentos em dinheiro aos participantes, certos campos relacionados ao status do formulário fiscal do participante ficarão disponíveis.
Detalhes do relatório
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 muito 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 obtidas por ano fiscal
* Quantidade total de recompensas obtidas por cada participante no ano fiscal
* O status do formulário fiscal, por exemplo, *válido*, *em espera*, ou *pendente*. Os motivos da retenção do pagamento também estão incluídos no relatório
**Referência das 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 do W-9** | |
| Data de envio do formulário fiscal dos EUA
AAAA-MM-DD
| A data em que o participante enviou seu formulário W-9 (ou o 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-calendário em que o participante obteve as recompensas. |
| Valor | Valor total de pagamento em unidades menores (por exemplo, centavos) obtido ou pendente para este participante durante o ano. Por exemplo, 1750 = US$ 17,50. |
| Valor em dólares | Mesmo valor, exibido no formato padrão de moeda para facilitar a revisão (por exemplo, 17,50). |
| Contagem | Número total de ocorrências individuais de recompensa de pagamento para o participante no ano especificado. Útil para entender com que frequência um participante obteve pagamentos. |
| **Elegibilidade e status do pagamento** | |
| Retenção de pagamento | Indica se os pagamentos do participante estão atualmente retidos (Sim ou Não). Os pagamentos podem ser retidos por falta de formulários fiscais ou configuração incompleta. |
| Motivos da retenção do pagamento | Explica por que o participante está com retenção de pagamento (se aplicável). Exemplos de motivos: *Formulário fiscal ausente*, *Informações bancárias não fornecidas*, *Revisão de conformidade*. |
| Moeda do pagamento | A moeda na qual os pagamentos do participante estão ou serão processados (por exemplo, *USD*, *EUR*, *ZAR*). Importante para sistemas globais de pagamento e contabilidade. |
| Iniciou a configuração do pagamento | Indica se o participante começou a configurar seu método de pagamento (por exemplo, por meio de uma integração com provedor de pagamentos). Ajuda a acompanhar o progresso de onboarding ou a necessidade de acompanhamento para pagamentos pendentes. |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.