# Relatórios do Programa Advocate Explicados Faça o curso PXA A 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 o tipo de dados que cada um inclui. Consulte [Executar um Relatório do Programa Advocate](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/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 *Relatório de* detalhes do usuário contém informações detalhadas sobre cada participante em todos os seus programas. Exporte uma lista de todos os participantes para manter seus registros atualizados com os links de compartilhamento e códigos de indicação do Advocate.
Detalhes do relatório Por padrão, o relatório incluirá informações do participante como: * Nome * ID do usuário e da conta * Endereço de e-mail * Campos personalizados * Segmentos * Informações de indicação (se aplicável) Ao gerar o relatório, você pode incluir opcionalmente: * **Estatísticas do usuário**, incluindo informações analíticas sobre o participante, como tráfego, receita e muito mais. * **Links e códigos de compartilhamento de indicação**, se aplicável. Essas informações podem ser úteis para atualizar registros de contato no seu CMS ou sistema de e-mail para incluir os links e códigos de compartilhamento do 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) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) 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 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. | | Primeiro 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 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** | | | IP visto primeiro | 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). | | **Timestamps** | | | Data de criação | A data e a hora em que a conta do participante foi criada no Advocate. | | Data de envio do formulário fiscal dos EUA | (Se aplicável) A data em que um formulário fiscal dos EUA foi enviado para conformidade ou processamento de recompensas. | | **Estatísticas do usuário (se incluídas na exportação)** | | | stats.date Modified | A última data em que as estatísticas do participante foram atualizadas. | | stats.traffic | Número total de visitas geradas pela atividade de indicação do participante. | | stats.referrals | Número total de indicações bem-sucedidas feitas pelo participante. | | stats.conversions | Número total de conversões (por exemplo, compras, cadastros) resultantes dessas indicações. | | stats.goals | Número de conclusões de metas específicas associadas à atividade de indicação do participante (definidas de forma personalizada no programa). | | stats.rewards | Número total de recompensas que o participante ganhou. | | stats.widget Loads | Número de vezes que o widget de indicação ou a interface de compartilhamento foi carregada por este participante. | | stats.revenue | Receita total gerada por usuários indicados por este participante. | | stats.generated Revenue | Sinônimo de stats.revenue; alguns relatórios podem diferenciar se a receita vier de várias fontes. | | stats.referred Revenue | Receita atribuída especificamente a participantes que se cadastraram ou compraram por meio do link de indicação deste participante. | | **Dados personalizados** | | | custom Fields.example | Um espaço reservado para quaisquer campos personalizados definidos pelo seu programa (por exemplo, *ID de fidelidade*, *notas internas*, *tag de região*). Cada campo aparecerá como sua própria coluna, com o prefixo custom Fields. | | **Outros** | | | Origem da indicação | A fonte ou o canal original que levou o participante ao seu programa (por exemplo, *orgânico*, *email*, *site parceiro*). |
#### Exportação de eventos do usuário O *Exportação de eventos do usuário* relatório fornece um registro de todos os eventos de usuário que recebemos da sua organização para o seu programa Advocate. Você pode aplicar filtros para restringir um intervalo de tempo, chave do evento, ID do usuário e muito mais.
Detalhes do relatório Por padrão, o relatório inclui: * ID do evento * Chave do evento * ID do usuário e da conta * Data de 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 `purchase`, `cadastro`, ou qualquer chave personalizada enviada pelo seu sistema. | | 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. | | **Timestamps do evento** | | | Data de acionamento do evento – 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 o Advocate recebeu o evento do seu sistema. Pode ser diferente da data de acionamento devido a processamento em lote ou atrasos do sistema. | | Data de processamento do evento – 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 cargas úteis do evento)** | | | fields.coupon | Qualquer cupom ou código de desconto aplicado durante o evento, se enviado nos dados do evento. Útil para rastrear o uso de incentivos ou gatilhos de promoção específicos. | | fields.revenue | O valor da receita associado ao evento. Normalmente usado em eventos de compra para calcular desempenho, recompensas ou ROI. | | fields.currency | O código da moeda (por exemplo, *USD*, *ZAR*, *EUR*) vinculado ao valor da receita. Importante ao fazer relatórios entre regiões ou calcular recompensas ajustadas pela taxa de câmbio. | | fields.lead Created Date | A data original em que o lead (usuário) foi criado no seu sistema, se enviada como parte do evento. Ajuda a conectar eventos de usuário às datas originais de aquisição ou registros do CRM. |
#### Histórico de recompensas O *Histórico de recompensas* relatório fornece um registro detalhado de cada uma das suas recompensas e das relações com participantes e indicações. Essas informações podem ser úteis 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 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) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) ou [JSONL de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) 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/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-rewards/create-a-reward.md)). | | Origem da recompensa | Descreve o que disparou a recompensa (por exemplo, *Indicações*, *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 do Fuel Tank | O código associado à execução externa (por exemplo, código de voucher ou de cartão-presente). | | ID do Programa | ID do programa Advocate sob o qual a recompensa foi emitida. | | Chave de recompensa do programa | Identificador interno da configuração específica de recompensa usada dentro do programa. | | Chave global de recompensa | Identificador entre programas para recompensas configuradas em nível global (se aplicável). | | **Timestamps 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 concedida (por exemplo, após um atraso ou período de espera). | | Data de concessão | Quando a recompensa foi realmente concedida 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 invalidada 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 foi feita a atualização mais recente no registro da recompensa. | | **Controle de crédito e valor** | | | Crédito atribuído | A quantidade de crédito atribuída a esta recompensa (pode diferir do valor em alguns modelos). | | Crédito resgatado | A quantidade de crédito que foi resgatada da recompensa. | | Valor disponível | A parte restante da recompensa que não foi usada ou resgatada. | | **Status e mensagens da recompensa** | | | Status | Status atual da recompensa (por exemplo, *Pendente*, *Agendado*, *Concedida*, *Expirado*, *Cancelado*). | | meta.status | Status técnico ou de 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.internal Message | Notas internas apenas para administradores (por exemplo, explicações de falhas ou sinalizações). | | meta.date Modified | Última vez que os metadados relacionados à recompensa foram atualizados. | | meta.customMeta.testMeta | Um espaço reservado para quaisquer campos personalizados de metadados enviados pelo seu programa (neste caso, testMeta é um exemplo). | | **Informações do participante (usuário)** | | | user.id | ID do usuário que recebe a recompensa. | | user.account Id | O ID da conta associado ao 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 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.date Referral Started | Quando a ação de indicação começou (por exemplo, clique ou evento de compartilhamento). | | referral.date Modified | Quando o registro da indicação foi atualizado pela última vez. | | referral.referral Code Used | O código que o usuário indicado usou para 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 de conta exclusivo do referenciador. | |

referral.referred User.first Name

referral.referred User.last Name

referral.referred User.email

| Os dados básicos de contato do referenciador. | | **Informações do referenciador (Advocate)** | | | referral.referrer User.id | ID da pessoa que fez a indicação (o “advocate”). | | referral.referrer User.account Id | O ID de conta exclusivo do referenciador. | |

referral.referrer User.first Name

referral.referrer User.last Name

referral.referrer User.email

| Os dados básicos de contato do referenciador. | | referral.date Converted | 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* relatório fornece um registro do status de cada conexão de indicação feita no seu programa de indicações. Essas informações podem ser úteis ao verificar o sucesso do seu programa e acompanhar o número de novos clientes trazidos por ele.
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 de moderação * IDs de 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) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) 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 exigida (como um cadastro ou compra). | | Data de modificação do usuário | A última vez em que os dados do usuário envolvidos nesta indicação (quem indicou ou quem foi 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

Primeiro nome do usuário indicado

Sobrenome do usuário indicado

| Informações básicas de identidade do usuário indicado. | | Código de indicação do usuário indicado | O código de indicação atribuído ao usuário indicado (caso ele também possa indicar outras pessoas depois). | |

IP visto primeiro 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 referenciador (Customer Advocate)** | | |

E-mail do usuário referenciador

Primeiro nome do usuário referenciador

Sobrenome do usuário referenciador

| Informações básicas de identidade do participante que indicou. | | Código de indicação do usuário referenciador | O código de indicação pertencente ao referenciador, o código que o usuário indicado provavelmente usou. | |

IP visto primeiro do usuário referenciador

Último IP visto do usuário referenciador

| Endereços IP registrados na primeira e na atividade mais recente do referenciador. | | URL da imagem do usuário referenciador | A URL da imagem ou avatar do referenciador. | | Localidade do usuário referenciador | Configuração de localidade do referenciador. | | Data de criação do usuário referenciador | Quando o referenciador entrou pela primeira vez ou foi registrado no sistema. | | Usuário referenciador | ID interno do referenciador no Advocate. | | Conta do referenciador | ID da conta associada ao referenciador. | | **Moderação e status** | | | Status de moderação | Status geral de moderação da indicação. (Por exemplo, *Aprovada*, *Recusado*, *Pendente*.) | | Data de moderação | A data em que a decisão de moderação (aprovação/rejeição) foi tomada. | | Data de pagamento da indicação | Quando qualquer recompensa associada foi paga pela indicação. | | Data de término da indicação | Quando o registro da indicação foi oficialmente encerrado (por exemplo, devido à expiração ou conclusão). | | Status de moderação do indicado | Status de moderação específico da parte da indicação relacionada ao usuário indicado. | | Status de moderação do referenciador | Status de moderação específico da parte da indicação relacionada ao referenciador. | | **Referências de recompensa** | | | Recompensa do indicado | O ID ou a referência da recompensa emitida para o usuário indicado (se aplicável). | | Recompensa do referenciador | O ID ou a referência da recompensa emitida para o referenciador (se aplicável). |
#### Saldos de recompensas por usuário O *Saldos de recompensas por usuário* relatório fornece um registro de 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 processo de 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 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 muito mais * Tipo de recompensa * Unidade de 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) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) 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 pagamento manual de recompensas ou sincronização com sistemas externos. | |

Primeiro 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 à 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 regional de pagamentos. | | Amount | O saldo total disponível de recompensas pendentes para este usuário. Este é o valor principal usado ao preparar pagamentos ou exportações. | | Crédito total atribuído | A quantidade total de crédito que já foi atribuída a este usuário (independentemente de 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 auditoria de custos reais versus passivos. | | Crédito total expirado | Total de recompensas atribuídas ao usuário que expiraram antes de serem resgatadas. Ajuda a acompanhar recompensas não reclamadas ou oportunidades perdidas de pagamento. | | **Metadados do usuário** | | | URL da imagem | URL da imagem de perfil ou avatar do participante (se coletada). Em geral, é algo estético ou usado em painéis voltados ao usuário, se aplicável. | | IP visto primeiro | 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 recompensa ao longo do tempo. | | Origem da indicação | A fonte ou o canal original por meio do qual o participante foi adquirido (por exemplo, *email*, *orgânico*, *parceiro*). Ajuda a avaliar o alcance e a eficácia do programa de indicações por canal. | | Localidade | A configuração de idioma e região do participante (por exemplo, *en-US*, *fr-FR*). Importante para comunicações personalizadas ou opções de recompensa regionais. |
#### Saldos de prêmios disponíveis por usuário O *Saldos de prêmios disponíveis por usuário* relatório fornece uma lista de recompensas não resgatadas. Esse tipo de relatório destina-se a ser usado como parte do processamento de recompensas por meio do [resgate em massa de recompensas](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) processo.
Detalhes do relatório Por padrão, o relatório inclui: * Detalhes do participante, como nome, ID do usuário e da conta, endereço de e-mail e muito mais * Unidade de 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) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) 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** | | | Primeiro 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 vinculada ao participante. | | Segmentos | Tags ou categorias usadas para [agrupar participantes](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (ex., *por região*, *por estágio do ciclo de vida*, *por tipo de cliente*). Útil para filtrar ou aplicar diferentes regras de execução. | | **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 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 conceder recompensas, especialmente entre países ou sistemas de pagamento. | | Valor disponível | A quantidade de recompensa não resgatada atualmente disponível para este participante. Este é o valor principal usado ao determinar quanto pagar. | | Valor a resgatar | O valor atualmente na fila para resgate (por exemplo, pendente em uma execução em lote ou aguardando processamento). Útil para evitar resgates duplos ou garantir que não haja sobreposição nos resgates. | | Valor total resgatado | O valor total das recompensas que este participante já resgatou. Dá uma visão dos 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 a execuçã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 muito mais * Data em que o formulário W-9 do participante foi marcado como coletado * Valor tributável nos EUA das recompensas ganhas por ano fiscal * Número total de recompensas ganhas 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 associada ao participante. | | E-mail | O endereço de e-mail do participante. | | Primeiro Nome | O primeiro nome do participante. | | Sobrenome | O sobrenome do participante. | | **Informações fiscais 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 o processamento do 1099. | | Valor tributável nos EUA em centavos | Valor total de recompensas tributáveis nos EUA ganhas por este participante no ano fiscal especificado, expresso em centavos (por exemplo, 2500 = 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 instâncias individuais de recompensa ganhas pelo participante no ano fiscal especificado. Útil para trilhas de auditoria ou para entender a frequência de recompensas e o engajamento no programa. |
#### 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 fornecer 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, ID do usuário e da conta, endereço de e-mail e muito mais * Data em que o formulário fiscal do participante — como um W-8 ou W-9 — foi marcado como enviado * Valor tributável nos EUA das recompensas ganhas por ano fiscal * Número total de recompensas ganhas por cada participante no ano fiscal * O status do formulário fiscal, por exemplo, *válido*, *bloqueado*, 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. | | Primeiro Nome | O primeiro nome do participante. | | Sobrenome | O sobrenome do participante. | | **Informações fiscais 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 fiscal relevante dos EUA). 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 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 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 do pagamento** | | | Retenção de pagamento | Indica se os pagamentos do participante estão atualmente retidos (Sim ou Não). Os pagamentos podem ser retidos 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 na qual os pagamentos do participante estão sendo ou serão processados (por exemplo, *USD*, *EUR*, *ZAR*). Importante para sistemas globais de pagamento e contabilidade. | | Configuração de pagamento iniciada | Indica se o participante começou a configurar seu método de pagamento (por exemplo, por meio de uma integração com provedor de pagamentos). Ajuda a acompanhar o progresso de onboarding ou a necessidade de acompanhamento para pagamentos pendentes. |
--- # Agent Instructions: 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: ``` GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.