> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
# Explicação sobre relatórios do programa Advocate
Faça o curso PXA
O Advocate oferece vários relatórios para download para os dados do seu programa e 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 um 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* 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 os 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 como parte da atualização dos registros de contato no seu CMS ou sistema de e-mail para 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 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. |
| Último IP visto | O endereço IP mais recente registrado para este participante. |
| Localidade | O idioma e as configurações regionais preferidos 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 e hora** | |
| Data de criação | A data e a hora em que a conta do participante foi criada no Advocate. |
| Data em que o formulário fiscal dos EUA foi enviado | (Se aplicável) A data em que um formulário fiscal dos EUA foi enviado para fins de conformidade ou processamento de recompensas. |
| **Estatísticas do usuário (se incluídas na exportação)** | |
| stats.data modificada | 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) que resultaram dessas indicações. |
| stats.objetivos | Número de conclusões de objetivos específicos associadas à atividade de indicação do participante (definidos de forma personalizada no programa). |
| stats.recompensas | Número total de recompensas que o participante ganhou. |
| stats.carregamentos 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.receita; 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** | |
| campos personalizados.exemplo | 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, prefixada com campos personalizados. |
| **Outros** | |
| Origem da indicação | A fonte ou o 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 eventos do usuário* o relatório fornece um registro de todos os eventos do usuário que recebemos da sua organização para o seu programa Advocate. Você pode aplicar filtros para restringir um 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 de envios de eventos. |
| Chave do evento | O tipo ou rótulo do evento, como `compra`, `cadastro`, ou qualquer chave 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 e hora do evento** | |
| Data do evento disparado – AAAA-MM-DD | A data em que o evento realmente aconteceu (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 ser diferente da data de disparo devido a processamento em lote ou atrasos no sistema. |
| Data do evento processada – AAAA-MM-DD | A data em que o evento foi processado e armazenado com sucesso no Advocate. Indica quando o evento passou a poder ser usado para rastreamento, recompensas ou relatórios. |
| **Campos de dados do evento (se incluídos nas suas cargas úteis de 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 gatilhos de promoção específicos. |
| fields.receita | O valor da receita associado 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 em várias regiões ou calcular recompensas ajustadas pela 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 enviado como parte do evento. Ajuda a conectar eventos do usuário às datas originais de aquisição ou aos registros do CRM. |
#### Histórico de recompensas
O *Histórico de recompensas* o 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 na criação de balanços, bem como para obter o status de todas as suas recompensas em um determinado momento.
Detalhes do relatório
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 exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx)  ou [JSONL de exemplo](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 defensor do cliente, 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 de exibição 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 disparou a recompensa (por exemplo, *Indicação*, *Objetivo*, *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 tanque de combustível | 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 da recompensa do programa | Identificador interno da 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 e 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 de concessão | 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 de resgate | A data em que o participante resgatou a recompensa (se aplicável). |
| Data de modificação | A data em que a atualização mais recente foi feita no registro da recompensa. |
| **Acompanhamento de crédito e valor** | |
| Crédito atribuído | O valor de crédito atribuído a esta recompensa (pode ser diferente do valor em alguns modelos). |
| Crédito resgatado | O valor de crédito que foi resgatado da recompensa. |
| Valor disponível | A parte restante da recompensa que ainda não foi usada ou resgatada. |
| **Status e mensagens da recompensa** | |
| Status | Status atual da recompensa (por exemplo, *Pendente*, *Agendada*, *Concedida*, *Expirado*, *Cancelado*). |
| meta.status | Status técnico ou do sistema (útil para diagnóstico ou tratamento de erros). |
| meta.mensagem | Mensagem vinculada à entrega da recompensa (por exemplo, “Recompensa entregue com sucesso”). |
| meta.mensagem interna | Notas internas apenas para administradores (por exemplo, explicações de falha ou sinalizações). |
| meta.data modificada | Última vez que os metadados relacionados à recompensa foram atualizados. |
| meta.customMeta.testMeta | Um espaço reservado para quaisquer campos de metadados personalizados enviados pelo seu programa (neste caso, testMeta é um exemplo). |
| **Informações do participante (usuário)** | |
| user.id | ID do usuário que recebe a recompensa. |
| user.ID da conta | O ID da conta associada do usuário no Advocate. |
| user.nome
user.sobrenome
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 disparou esta recompensa. |
| referral.data de início da indicação | Quando a ação de indicação começou (por exemplo, evento de clique ou compartilhamento). |
| referral.data de modificação | 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 se juntar ou executar 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 (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 foi oficialmente convertida (por exemplo, cadastro ou compra concluídos), acionando a recompensa. |
#### 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 no 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 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 muito mais
* Detalhes do defensor do cliente, como nome, ID do usuário e da conta, endereço de e-mail e muito mais
* Status da indicação
* Status de moderação
* IDs da recompensa
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 de modificação | A data mais recente em que qualquer parte do registro da indicação foi atualizada. |
| Data de início da indicação | Quando a indicação foi iniciada pela primeira vez (por exemplo, quando o usuário indicado clicou em um link de indicação). |
| Data de conversão | Quando a indicação foi convertida, normalmente quando o usuário indicado concluiu a ação exigida (como um cadastro ou compra). |
| Data da 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 ao gerenciar vários programas. |
| **Informações do amigo indicado (novo cliente)** | |
| E-mail do usuário indicado
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 vinculada ao usuário indicado (usado em programas com várias contas). |
| **Informações do indicador (defensor do cliente)** | |
| E-mail do usuário indicador
Nome do usuário indicador
Sobrenome do usuário indicador
| Informações básicas de identidade do participante que fez a indicação. |
| Código de indicação do usuário indicador | O código de indicação pertencente ao indicador, o código que provavelmente o usuário indicado 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 associada ao indicador. |
| **Moderação e status** | |
| Status da moderação | Status geral da moderação da indicação. (Ex., *Aprovado*, *Rejeitado*, *Pendente*.) |
| Data da moderação | A data em que a decisão de moderação (aprovação/rejeição) foi tomada. |
| Data de pagamento da indicação | Quando qualquer recompensa associada foi paga pela indicação. |
| Data de encerramento 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 de recompensa** | |
| Recompensa do indicado | O ID ou referência da recompensa emitida para o usuário indicado (se aplicável). |
| Recompensa de quem indicou | O ID ou referência da recompensa emitida para quem indicou (se aplicável). |
#### Saldos de recompensas por usuário
O *Saldos de recompensas por usuário* o 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. Esse relatório é frequentemente usado como parte do pagamento manual de recompensas ou como parte de um processo em lote para um sistema como o Tango Card. Ele também pode ser útil para acompanhar quanto seu programa de indicações pagou em um determinado período.
Detalhes do relatório
Por padrão, o relatório inclui:
* Detalhes do participante, como nome, usuário e ID da conta, endereço de e-mail e 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 segmentados de contas. |
| E-mail | O endereço de e-mail do participante. Frequentemente usado para pagamento manual de recompensas ou sincronização com sistemas externos. |
| Nome
Sobrenome
| O nome e o sobrenome 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 ele compartilha para indicar outras pessoas e acompanhar 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 pagas ou agrupadas. |
| Unidade | A unidade do valor da recompensa (por exemplo, *USD*, *ZAR*, *Pontos*, *%*). Importante para calcular saldos e para o processamento regional de pagamentos. |
| Valor | 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 custos reais versus passivos. |
| Crédito total expirado | O total de recompensas atribuídas ao usuário, mas que expiraram antes de serem resgatadas. Ajuda a acompanhar recompensas não reivindicadas ou oportunidades perdidas de pagamento. |
| **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 ficou 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 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*, *partner*). 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 recompensas disponíveis por usuário
O *Saldos de recompensas disponíveis por usuário* o relatório fornece uma lista de recompensas não resgatadas. Esse tipo de relatório foi criado para ser usado como parte do pagamento 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, usuário e ID da conta, endereço de e-mail e 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, Fuel Tank ou Vale-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 corresponder 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 | Etiquetas 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) (ex., *por região*, *estágio do ciclo de vida*, *tipo de cliente*). Úteis para filtragem ou aplicação de regras diferentes de pagamento. |
| **Status e tempo da recompensa** | |
| Data de bloqueio | A data em que o usuário foi bloqueado de receber recompensas, se aplicável. Um status de bloqueio 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 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 de moeda do valor da recompensa (por exemplo, *USD*, *ZAR*, *EUR*). Necessário ao pagar recompensas, especialmente entre países ou sistemas de pagamento. |
| Valor disponível | O valor de recompensa não resgatado atualmente disponível para este participante. Este é o valor principal usado ao determinar o que será pago. |
| Valor a resgatar | O valor atualmente na fila para resgate (por exemplo, pendente em um pagamento em massa ou aguardando processamento). Útil para evitar resgates duplicados ou garantir que não haja sobreposição nos resgates. |
| Valor total resgatado | O valor total das recompensas que este participante já resgatou. Fornece visão sobre resgates anteriores e pode ser útil para acompanhar 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 pagamento. |
#### 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 ganhas ou pendentes por ano.
Detalhes do relatório
Por padrão, o relatório inclui:
* Detalhes do participante, como nome, usuário e ID 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 obtidas por ano fiscal
* Número 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 associada 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 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-calendário para processamento de 1099. |
| Valor tributável nos EUA em centavos | Valor total das 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 (por exemplo, 25,00). Mais fácil para revisão ou inclusão em resumos oficiais. |
| Contagem de recompensas | Número total de instâncias individuais de recompensa obtidas pelo participante no ano fiscal especificado. Útil para trilhas de auditoria ou para entender a frequência de recompensas e o engajamento com o programa. |
#### Pagamentos e impostos
O *Pagamento e impostos* relatório mostra o status fiscal dos participantes e as recompensas ganhas ou pendentes por ano.
Se o seu programa fornece pagamentos em dinheiro aos participantes, alguns 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, usuário e ID 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 obtidas por ano fiscal
* Número total de recompensas obtidas por cada participante no ano fiscal
* O status do formulário fiscal, por exemplo, *válido*, *em espera*, ou *pendentes*. Os motivos de 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 americano relevante). Importante para verificar a elegibilidade fiscal antes de emitir pagamentos em dinheiro. |
| **Resumo do ano dos pagamentos** | |
| Ano | O ano-calendário em que o participante ganhou as recompensas. |
| Valor | Valor total do pagamento em unidades menores (por exemplo, centavos) ganho 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 instâncias individuais de recompensa de pagamento para o participante no ano especificado. Útil para entender com que frequência um participante ganhou pagamentos. |
| **Elegibilidade e status do pagamento** | |
| Bloqueio de pagamento | Indica se os pagamentos do participante estão atualmente retidos (Sim ou Não). Os pagamentos podem ser retidos devido à ausência de formulários fiscais ou à configuração incompleta. |
| Motivos do bloqueio de pagamento | Explica por que o participante está com pagamento retido (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 um provedor de pagamentos). Ajuda a acompanhar o progresso da integração 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.