> 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/getting-started-with-advocate/import-referral-program-data-from-saasquatch.md). # Importar dados do programa de indicação do SaaSquatch Este artigo reúne referências úteis para ajudá-lo a importar os dados da sua plataforma de indicações do SaaSquatch para o impact.com. #### Referência das colunas do arquivo CSV

Arquivo de dados de usuários

Coluna	Obrigatório	Descrição
ID do Usuário		O identificador do participante.
ID da Conta		O identificador da conta do participante.
E-mail		O endereço de e-mail do participante.
Nome		O nome do participante.
Sobrenome		O sobrenome do participante.
Código de indicação		O código de indicação do programa principal do participante (se especificado).
URL da imagem		A URL da imagem do participante.
IP visto pela primeira vez		O endereço IP do participante na primeira vez em que ele fez um upsert sem API.
Último IP visto		O endereço IP do participante na última vez em que ele fez um upsert sem API.
Data de criação		A data em que este usuário participante foi criado, formatada em milissegundos desde a época Unix .
Hash do e-mail		O valor do hash MD5 do endereço de e-mail de um participante.
Localidade		A localização geográfica do participante.
Código do país		O código do país do participante.
Segmentos		Os segmentos de usuário do participante.
Link de compartilhamento		O link de compartilhamento do programa principal do participante (se especificado).
Link de compartilhamento do Facebook		O link de compartilhamento no Facebook do programa principal do participante (se especificado).
Link de compartilhamento do Twitter		O link de compartilhamento no Twitter/X do programa principal do participante (se especificado).
Link de compartilhamento por e-mail		O link de compartilhamento por e-mail do programa principal do participante (se especificado).
Link de compartilhamento do LinkedIn		O link de compartilhamento no LinkedIn do programa principal do participante (se especificado).
Link de compartilhamento limpo		O link vanity principal do participante sem codificação.
Campo personalizado		Se um participante tiver um campo personalizado, `{ExampleName}` será o nome do campo.

Arquivo de dados de indicação

Coluna	Obrigatório	Descrição
Usuário indicado - ID do usuário		O ID de usuário externo do amigo indicado.
Usuário indicado - ID da conta		O ID de conta externo do amigo indicado.
Usuário indicante - ID do usuário		O ID de usuário externo do defensor do cliente.
Usuário indicante - ID da conta		O ID de conta externo do defensor do cliente.
ID da indicação		O identificador exclusivo da indicação.
Data da modificação		A data em que a indicação foi modificada pela última vez (ou seja, iniciada, convertida, moderada etc.), formatada em milissegundos desde a época Unix .
Data de início da indicação		A data em que a indicação foi criada, formatada em milissegundos desde a época Unix .
Data da conversão		A data em que a primeira meta foi alcançada, formatada em milissegundos desde a época Unix .
Data de modificação do usuário		A data em que um usuário foi removido de uma indicação (exclusão de usuário) ou adicionado a uma indicação, formatada em milissegundos desde a época Unix .
ID do programa		O identificador do programa para o qual a indicação foi criada.
Nome do Programa		O nome do programa para o qual a indicação foi criada.
Usuário indicado - E-mail		O endereço de e-mail do amigo indicado.
Usuário indicado - Nome		O nome do amigo indicado.
Usuário indicado - Sobrenome		O sobrenome do amigo indicado.
Usuário indicado - Código de indicação		O código de indicação principal do amigo indicado (depende do programa no qual esta indicação foi criada.
Usuário indicado - IP da primeira visualização		O primeiro endereço IP que o amigo indicado usou ao carregar um widget.
Usuário indicado - Último IP visualizado		O endereço IP mais recente que o amigo indicado usou ao carregar um widget.
Usuário indicado - URL da imagem		A imagem do amigo indicado.
Usuário indicado - Localidade		A localidade do amigo indicado.
Usuário indicado - Data de criação		A data em que o amigo indicado foi visto pela primeira vez pelo SaaSquatch (criado no SaaSquatch), formatada em milissegundos desde a época Unix .
Usuário indicado - Segmentos		Os segmentos de usuário do amigo indicado.
referredUserCustomFields.<fieldName>		Os campos personalizados do amigo indicado.
Usuário indicante - E-mail		O endereço de e-mail do defensor do cliente.
Usuário indicante - Nome		O nome do defensor do cliente.
Usuário indicante - Sobrenome		O sobrenome do defensor do cliente.
Usuário indicante - Código de indicação		O código de indicação principal do defensor do cliente (por exemplo, o código de indicação usado para criar esta indicação).
Usuário indicante - IP da primeira visualização		O primeiro endereço IP que o defensor do cliente usou ao carregar um widget.
Usuário indicante - Último IP visualizado		O endereço IP mais recente que o defensor do cliente usou ao carregar um widget.
Usuário indicante - URL da imagem		A imagem do defensor do cliente.
Usuário indicante - Localidade		A localidade do defensor do cliente.
Usuário indicante - Data de criação		A data em que o defensor do cliente foi visto pela primeira vez pelo SaaSquatch (criado no SaaSquatch), formatada em milissegundos desde a época Unix .
Status de moderação		O status de moderação de fraude da indicação (por exemplo, `PENDING`, `ACTIONED`).
Data da moderação		A data em que a indicação começou, formatada em milissegundos desde a época Unix .
Usuário indicado - ID da recompensa		O identificador da recompensa do amigo indicado.
Usuário indicante - ID da recompensa		O identificador da recompensa do defensor do cliente.
Usuário que indicou - Segmentos		Os segmentos de usuário do defensor do cliente.
referrerUserCustomFields.<fieldName>		Os campos personalizados do defensor do cliente.
Código de indicação usado		O código de indicação do defensor do cliente que foi usado para a indicação.
Link de compartilhamento usado		O link de compartilhamento do defensor do cliente que foi usado para a indicação.

Arquivo de dados de recompensas

Coluna	Obrigatório	Descrição
ID do Usuário		O identificador do usuário.
ID da Conta		O identificador da conta do usuário.
Tipo		O tipo de recompensa, por exemplo, crédito, desconto, cartão-presente etc.
Unidade da Recompensa		A unidade na qual as recompensas são ganhas, por exemplo, dinheiro, pontos, meses etc.
Valor da recompensa		O valor numérico da recompensa em sua menor unidade de medida; por exemplo, para uma recompensa em dinheiro de US$ 1,00, o valor seria 100 (centavos).
Nome da Recompensa		O nome que você atribuiu à recompensa ao criá-la no seu programa.
Valor em USD		O valor da recompensa em USD.
ID do programa		O identificador do programa para o qual a recompensa foi criada.
Chave global da recompensa		Chave da configuração global da recompensa no catálogo de recompensas. Isso fica em Recompensas → Catálogo → Criar recompensas → Nome da recompensa.
Origem da recompensa		Como a recompensa foi criada, por exemplo, Manual, Usuário indicado, Cadastro de amigo.
Data de criação		A data em que a recompensa foi ganha, formatada em milissegundos desde a época Unix .
Data Concedida		A data em que a recompensa foi concedida, formatada em milissegundos desde a época Unix . (Este valor pode diferir de Data de criação se a recompensa estava pendente).
Data agendada para		A data em que a recompensa foi agendada para ser concedida ao usuário, formatada em milissegundos desde a época Unix .
Data de expiração		A data após a qual a recompensa não pode mais ser resgatada, formatada em milissegundos desde a época Unix .
Data de cancelamento		A data em que você cancelou a recompensa, formatada em milissegundos desde a época Unix .
Data da modificação		A data em que você fez modificações na recompensa, formatada em milissegundos desde a época Unix .
Data Resgatada		A data em que a recompensa completa foi resgatada pelo usuário, formatada em milissegundos desde a época Unix .
Crédito atribuído		O valor na unidade base para recompensas em crédito. Este é o equivalente a Valor da recompensa, mas para recompensas em crédito.
Valor Resgatado		O Valor da parte da recompensa que foi resgatada.
Tipo Fuel Tank		Isso pode ser Crédito ou % de desconto.
Código do Fuel Tank		Isso é como um código de cupom, por exemplo, SummerSave20, 20%OFF, etc.
ID do Usuário Indicado		O identificador de usuário do amigo indicado.
ID da Conta do Indicado		O identificador da conta do amigo indicado.
referral.referredUser.id		Usado em conjunto com ID do programa para vincular uma indicação a um ID de programa, se quisermos associar uma indicação a uma recompensa. Isso pode nem sempre corresponder ao ID do Usuário.
referral.referredUser.accountId		Usado em conjunto com ID do programa para vincular uma indicação a um ID de programa, se quisermos associar uma indicação a uma recompensa. Isso pode nem sempre corresponder ao ID da Conta.

#### Referência de erros de validação Você pode receber 3 tipos de erros de validação: 1. **Mensagem de erro inline:** essas aparecem na tabela de validação de pré-visualização e fazem com que as linhas com erro sejam destacadas em vermelho: * `INVALID_FIELD` — por exemplo, o *Data de criação* campo não foi formatado em [milissegundos desde a época Unix](https://currentmillis.com/) . * `MISSING_FIELD` — por exemplo, um campo obrigatório como *ID do Usuário* ou *ID da Conta* está ausente.

2. **Chamada de erro:** essas aparecem no lugar da tabela de validação de pré-visualização como mensagens de aviso em vermelho: * `MISSING_HEADER` — por exemplo, um cabeçalho de coluna obrigatório como *ID da Conta* ou *Valor da recompensa* está ausente. * `CSV_PARSING` — por exemplo, o arquivo CSV contém caracteres especiais que estão formatados incorretamente. * `FILE_REF_IO` — por exemplo, o arquivo está corrompido e não pode ser lido.

3. **Erros listados:** esses aparecem como uma lista de contagens de erros na *Importações e Exportações* tela quando o tipo de importação não tiver uma tabela de validação de pré-visualização. Erros de linha e erros de arquivo serão exibidos juntos: 1. Na barra de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage] → Relatórios**. 2. Selecione **Importações e Exportações** para visualizar o relatório. --- # 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/getting-started-with-advocate/import-referral-program-data-from-saasquatch.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.