> 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
A 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 lhe dar mais controle sobre os dados que você baixa. Cada relatório pode ser baixado como um arquivo .CSV ou do Excel.
Este artigo explica os diferentes relatórios e que tipo de dados cada um inclui. Consulte [Executar um relatório do programa da Advocate](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) para ver instruções sobre como gerar um relatório.
#### Relatório de detalhes do usuário
O *Detalhes do usuário* O 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 da 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 ao atualizar registros de contato em seu CMS ou sistema de e-mail para incluir os links e códigos de compartilhamento da Advocate de cada participante.
A 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 de colunas do relatório**
| Coluna | Descrição |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do usuário** | |
| ID | O identificador exclusivo do participante no sistema da 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 compatível com 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 indicações que ele gera. |
| Link de compartilhamento | O link exclusivo de indicação associado ao participante. |
| Link de compartilhamento no Facebook | Um link pré-gerado para compartilhar a indicação no Facebook. |
| Link de compartilhamento no 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 no 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** | |
| Primeiro IP visto | 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). |
| **Marcas de tempo** | |
| Data de criação | A data e a hora em que a conta do participante foi criada na Advocate. |
| Data de envio do formulário fiscal dos EUA | (Se aplicável) A data em que um formulário fiscal dos EUA foi enviado para fins de conformidade ou processamento de recompensas. |
| **Estatísticas do usuário (se incluídas na exportação)** | |
| stats.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) 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.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 pelos 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** | |
| 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** | |
| Fonte 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* 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 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 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 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 definida de forma personalizada que seu sistema envie. |
| ID do Usuário | O identificador exclusivo do participante na 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. |
| **Marcas de tempo do evento** | |
| Data do evento acionado – 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 de recebimento do evento – AAAA-MM-DD | A data em que a Advocate recebeu o evento do seu sistema. Pode ser diferente da data acionada devido ao processamento em lote ou a atrasos do sistema. |
| Data de processamento do evento – AAAA-MM-DD | A data em que o evento foi processado e armazenado com sucesso na Advocate. Marca quando o evento se tornou utilizável para rastreamento, recompensas ou relatórios. |
| **Campos de dados do evento (se incluídos nas cargas úteis do seu evento)** | |
| campos.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. |
| campos.receita | O valor da receita associada ao evento. Normalmente usado em eventos de compra para calcular desempenho, recompensas ou ROI. |
| campos.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. |
| campos.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 conectar eventos do usuário às datas originais de aquisição ou a registros de 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 para criar 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 da recompensa** informações como:
* ID da recompensa
* Tipo de recompensa
* Valor da recompensa
A 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 de colunas do relatório**
| Coluna | Descrição |
| ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações da recompensa** | |
| ID | ID exclusivo da instância da recompensa (gerado pela 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)). |
| Fonte 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). Por exemplo, *Pré-pago*, *Cartão-presente*. |
| Código FuelTank | O código associado à entrega externa (por exemplo, código de voucher ou cartão-presente). |
| ID do programa | ID do programa da 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). |
| **Marcas de tempo 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 ao participante. |
| Data de expiração | A data de expiração da recompensa (se aplicável). |
| Data de cancelamento | A data em que a recompensa foi anulada ou cancelada. |
| Data de Resgate | A data em que o participante resgatou a recompensa (se aplicável). |
| Data de modificação | A data em que 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 não usada ou não resgatada da recompensa. |
| **Status e mensagens da recompensa** | |
| Status | Status atual da recompensa (por exemplo, *Pendentes*, *Agendada*, *Concedida*, *Expirado*, *Cancelado*). |
| meta.status | Status técnico ou em nível de sistema (útil para diagnósticos ou tratamento de erros). |
| meta.message | Mensagem vinculada à entrega da recompensa (por exemplo, “Recompensa entregue com sucesso”). |
| meta.mensagem interna | Notas apenas internas para administradores (por exemplo, explicações de falha ou sinalizações). |
| meta.data modificada | Ú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 associado ao usuário na Advocate. |
| user.first Name
user.last Name
user.email
| 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.data de início da indicação | Quando a ação de indicação começou (por exemplo, um 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 a 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 exclusivo da conta do indicador. |
| referral.referred User.first Name
referral.referred User.last Name
referral.referred User.email
| Dados básicos de contato do indicador. |
| **Informações do indicador (Advocate)** | |
| referral.referrer User.id | ID da pessoa que fez a indicação (o “advocate”). |
| referral.referrer User.account Id | O ID exclusivo da conta do indicador. |
| referral.referrer User.first Name
referral.referrer User.last Name
referral.referrer User.email
| Dados básicos de contato do indicador. |
| referral.data convertida | 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 acompanhar o número de novos clientes trazidos pelo seu programa.
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
A 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 de colunas do relatório**
| Coluna | Descrição |
| ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Metadados da indicação** | |
| ID | Identificador exclusivo do registro de indicação na Advocate. |
| Data de 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 de conversão | Quando a indicação foi convertida, normalmente quando o usuário indicado concluiu a ação necessária (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 da 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). |
| Primeiro IP visto 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 capturada ou atribuída ao usuário indicado. |
| Localidade do usuário indicado | Configuração de idioma/região (por exemplo, *en-US*, *fr-FR*) do usuário indicado. |
| Data de criação do usuário indicado | A data em que a conta do usuário indicado foi criada na Advocate. |
| Usuário indicado | ID interno do usuário indicado no sistema da Advocate. |
| Conta indicada | ID interno da conta vinculado 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 faz 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 o usuário indicado provavelmente usou. |
| Primeiro IP visto 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 na 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., *Aprovado*, *Rejeitadas*, *Pendentes*.) |
| 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 da indicação referente ao usuário indicado. |
| Status de moderação do indicador | Status de moderação específico da parte da indicação referente ao indicador. |
| **Referências de recompensa** | |
| Recompensa do indicado | O ID ou referência da recompensa emitida ao usuário indicado (se aplicável). |
| Recompensa do indicador | O ID ou referência da recompensa emitida ao indicador (se aplicável). |
#### Saldos de recompensas por usuário
O *Saldos de recompensas por usuário* este relatório fornece um registro das recompensas pendentes, incluindo o valor e o destinatário pretendido, geradas por meio do seu programa de indicações. Este relatório é frequentemente usado como parte da liberação manual de recompensas ou de um processo em lote para um sistema como o Tango Card. Também pode ser útil para acompanhar quanto o 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, ID do usuário e da conta, endereço de e-mail e mais
* Tipo de recompensa
* Unidade da recompensa
* Valor da recompensa
A 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 de 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 a entrega 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 de recompensas. |
| Código de indicação | O código de indicação atribuído ao participante. É isso 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 liberadas ou agrupadas. |
| Unidade | A unidade do valor da recompensa (por exemplo, *USD*, *ZAR*, *Pontos*, *%*). Importante para calcular saldos e para o processamento de pagamentos por região. |
| Valor | O saldo total disponível de recompensas pendentes para este usuário. Esse é o valor principal usado ao preparar pagamentos ou exportações. |
| Total de crédito 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. |
| Total de crédito resgatado | A parte total das recompensas que este participante já resgatou. Útil para auditar custos reais versus obrigações. |
| Total de crédito expirado | Total de recompensas atribuídas ao usuário, mas que expiraram antes de serem resgatadas. Ajuda a rastrear recompensas não reclamadas ou oportunidades perdidas de entrega. |
| **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. |
| Primeiro IP visto | 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 coorte ou do comportamento de recompensas ao longo do tempo. |
| Fonte da indicação | A fonte ou canal original pelo 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* este relatório fornece uma lista de recompensas não resgatadas. Este tipo de relatório destina-se a ser usado como parte da liberação 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 mais
* Unidade da recompensa
* Moeda da recompensa
* Valor disponível
A 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 Cartão-presente. Use o *Saldos de recompensas por usuário* relatório para mais detalhes sobre esses tipos de recompensa.
{% 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 de recompensas. |
| 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) (por exemplo, *por região*, *estágio do ciclo de vida*, *tipo de cliente*). Útil para filtrar ou aplicar regras diferentes de liberação. |
| **Status e cronograma da recompensa** | |
| Data do 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 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 da moeda do valor da recompensa (por exemplo, *USD*, *ZAR*, *EUR*). Necessário ao liberar 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 uma liberação em massa ou aguardando processamento). Útil para evitar resgate duplo ou garantir que não haja sobreposição nos resgates. |
| Valor total resgatado | O valor total das recompensas que este participante já resgatou. Fornece insight sobre resgates anteriores e pode ser útil para controle de limite de recompensas |
| 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 a liberação. |
#### 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, 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 obtidas por ano fiscal
* Número total de recompensas obtidas por cada 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 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 obteve recompensas. Usado para agrupar ganhos por ano-calendário para o processamento do 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 em cálculos brutos ou integrações em que a precisão é necessária. |
| Valor tributável nos EUA em dólares | O mesmo que acima, mas exibido no formato padrão de 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 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* este relatório mostra o status fiscal dos participantes e as recompensas ganhas ou pendentes por ano.
Se o seu programa oferece pagamentos em dinheiro aos participantes, alguns campos relacionados ao status do formulário fiscal do participante estarã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 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 da retenção do pagamento também estão incluídos 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 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 formulário tributário americano 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 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 revisão fácil (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 ganhou pagamentos. |
| **Elegibilidade e status de pagamento** | |
| Pagamento retido | Indica se os pagamentos do participante estão atualmente retidos (Sim ou Não). Os pagamentos podem ser retidos devido a formulários fiscais ausentes ou configuração incompleta. |
| Motivos da retenção do 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 são ou serão processados (por exemplo, *USD*, *EUR*, *ZAR*). Importante para sistemas globais de pagamento e contabilidade. |
| Iniciou a configuração de 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 de 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 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.