> 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 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 de programa do Advocate](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) para obter 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 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
* Segments
* 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 os 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 de 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 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 exclusivo de indicação 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** | |
| Primeiro IP detectado | O endereço IP a partir do qual o participante foi registrado pela primeira vez. |
| Último IP detectado | 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 e hora** | |
| Data de criação | A data e hora em que a conta do participante foi criada no Advocate. |
| Data de envio do formulário fiscal dos EUA | (Se aplicável) A data em que um formulário fiscal dos EUA foi enviado para conformidade ou processamento de recompensa. |
| **Estatísticas do usuário (se incluídas na exportação)** | |
| stats.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 vier 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, com o prefixo campos personalizados. |
| **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* o relatório fornece um registro de todos os eventos de usuário que recebemos da sua organização para o seu programa do 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 do acionamento
* Data de recebimento
* Data de processamento
**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 o 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 nos quais os usuários podem pertencer a diferentes estruturas de conta. |
| **Carimbos de data e hora do evento** | |
| Data de acionamento do evento – YYYY-MM-DD | A data em que o evento realmente aconteceu (conforme relatado 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 acionamento devido ao processamento em lote ou 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 poder ser usado para rastreamento, recompensas ou relatórios. |
| **Campos de dados do evento (se incluídos nos payloads do 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çõ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 reportar entre 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 enviada como parte do evento. Ajuda a conectar eventos do usuário às datas originais de aquisição ou 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 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 customer advocate, 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 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 acionou a recompensa (por exemplo, *Indicação*, *Meta*, *Manual*, *API*). |
| Tipo de 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 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 do Advocate no 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 programada para | Quando a recompensa foi programada para ser emitida (por exemplo, após um atraso ou período de espera). |
| Data concedida | Quando a recompensa foi 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 de modificação | A data em que foi feita a atualização mais recente do registro da recompensa. |
| **Rastreamento de crédito e valor** | |
| Crédito atribuído | O valor de crédito atribuído a esta recompensa (pode diferir 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, *Pendentes*, *Agendada*, *Concedida*, *Expirado*, *Cancelado*). |
| meta.status | Status técnico ou de nível do 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 apenas internas 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 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 está recebendo a recompensa. |
| user.account Id | O ID da conta associada do usuário no Advocate. |
| user.first Name
user.last Name
user.email
| Informações básicas do participante incluídas para referência ou correspondência no 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 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 exclusivo da conta do indicador. |
| referral.referred User.first Name
referral.referred User.last Name
referral.referred User.email
| Os 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
| Os dados 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 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 muito mais
* Detalhes do customer advocate, como nome, ID do usuário e da conta, endereço de e-mail e muito mais
* Status da indicação
* Status da 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 de 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 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 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). |
| Primeiro IP detectado do usuário indicado
Último IP detectado 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
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 o usuário indicado provavelmente usou. |
| Primeiro IP detectado do usuário indicador
Último IP detectado 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 referenciador. |
| **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 em que a indicação foi paga | Quando qualquer recompensa associada foi paga pela indicação. |
| Data em que a indicação terminou | Quando o registro da indicação foi oficialmente encerrado (por exemplo, devido à 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 do referenciador | Status de moderação específico da parte do referenciador na indicação. |
| **Referências de recompensa** | |
| Recompensa do indicado | O ID ou referência da recompensa emitida ao usuário indicado (se aplicável). |
| Recompensa do referenciador | O ID ou referência da recompensa emitida ao referenciador (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, geradas por meio do seu programa de indicação. Este 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. Também pode ser útil para acompanhar quanto o seu programa de indicação 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 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 processamento 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. É o que ele compartilha para indicar outras pessoas e rastrear 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 pagas 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. 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 parcela total das recompensas que este participante já resgatou. Útil para auditar custos reais versus 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 reivindicadas ou oportunidades de pagamento perdidas. |
| **Metadados do usuário** | |
| URL da imagem | URL da imagem de perfil ou avatar do participante (se coletada). É principalmente estética ou usada em painéis voltados ao usuário, se aplicável. |
| Primeiro IP detectado | 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 detectado | 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 ou canal original 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ção 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 de recompensa regionais. |
#### Saldos de recompensas disponíveis por usuário
O *Saldos de recompensas disponíveis por usuário* relatório fornece uma lista de recompensas não resgatadas. Esse tipo de relatório destina-se a 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 cartão-presente. Use o *Saldos de recompensas por usuário* relatório para mais detalhes sobre esses tipos de recompensas.
{% endhint %}
**referência de colunas do relatório**
| Coluna | Descrição |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações do participante** | |
| Nome | O primeiro nome do participante, usado para identificação ou personalização durante o processamento 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. |
| Segments | 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 filtragem ou aplicação de diferentes regras de pagamento. |
| **Status e tempo da recompensa** | |
| Data do 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 da 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 pagar 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 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 insights sobre resgates anteriores e pode ser útil para acompanhar limites de recompensa |
| Unidade | O código interno ou do sistema para a unidade de recompensa (por exemplo, *USD*, *pontos*, etc.). Pode ser usado em chamadas de API ou lógica interna durante o 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 recebidas 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
* O 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 para verificar o 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 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 valor, exibido no formato padrão de dólar para fácil revisão (por exemplo, 25,00). |
| Quantidade 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 das 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 oferece 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, 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
* O 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 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 ganhou 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 fácil 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 recebeu pagamentos. |
| **Elegibilidade e status de pagamento** | |
| Retenção de pagamento | Indica se os pagamentos do participante estão atualmente retidos (Sim ou Não). Os pagamentos podem ser retidos devido à falta de formulários fiscais ou à configuração incompleta. |
| 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 em que os pagamentos do participante são ou serão processados (por exemplo, *USD*, *EUR*, *ZAR*). Importante para sistemas globais de pagamento e contabilidade. |
| 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 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.