> 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ções do SaaSquatch Este artigo reúne referências úteis para ajudar você a importar os dados da sua plataforma de indicação 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 primeiro 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 que não fosse via API.
Último IP visto		O endereço IP do participante na última vez em que ele fez um upsert que não fosse via 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 principal link personalizado 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ções

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 cliente defensor.
Usuário indicante - ID da conta		O ID de conta externo do cliente defensor.
ID de Indicação		O identificador exclusivo da indicação.
Data de 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 de conversão		A data em que a primeira meta foi alcançada, formatada em milissegundos desde a época Unix .
Data da modificação do usuário		A data em que um usuário foi excluído 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 - Primeiro nome		O primeiro 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 em que esta indicação foi criada.
Usuário indicado - Primeiro IP detectado		O primeiro endereço IP que o amigo indicado usou ao carregar um widget.
Usuário indicado - Último IP detectado		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 cliente defensor.
Usuário indicante - Primeiro nome		O primeiro nome do cliente defensor.
Usuário indicante - Sobrenome		O sobrenome do cliente defensor.
Usuário indicante - Código de indicação		O código de indicação principal do cliente defensor (por exemplo, o código de indicação usado para criar esta indicação).
Usuário indicante - Primeiro IP detectado		O primeiro endereço IP que o cliente defensor usou ao carregar um widget.
Usuário indicante - Último IP detectado		O endereço IP mais recente que o cliente defensor usou ao carregar um widget.
Usuário indicante - URL da imagem		A imagem do cliente defensor.
Usuário indicante - Localidade		A localidade do cliente defensor.
Usuário indicante - Data de criação		A data em que o cliente defensor foi visto pela primeira vez pelo SaaSquatch (criado no SaaSquatch), formatada em milissegundos desde a época Unix .
Status da moderação		O status de moderação de fraude da indicação (por exemplo, `PENDENTE`, `PROCESSADO`).
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 de recompensa do amigo indicado.
Usuário indicante - ID da recompensa		O identificador de recompensa do cliente defensor.
Usuário indicante - Segmentos		Os segmentos de usuário do cliente defensor.
referrerUserCustomFields.<fieldName>		Os campos personalizados do cliente defensor.
Código de indicação usado		O código de indicação do cliente defensor que foi usado para a indicação.
Link de compartilhamento usado		O link de compartilhamento do cliente defensor 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 em que as recompensas são obtidas, 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 de recompensas no catálogo de recompensas. Ela está 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 obtida, formatada em milissegundos desde a época Unix .
Data de concessão		A data em que a recompensa foi concedida, formatada em milissegundos desde a época Unix . (Este valor pode ser diferente de Data de criação se a recompensa estava pendente).
Data agendada para		A data em que a recompensa foi programada 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 de modificação		A data em que você fez modificações na recompensa, formatada em milissegundos desde a época Unix .
Data de resgate		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 de Crédito. Este é o equivalente a Valor da recompensa, mas para recompensas de Crédito.
Valor resgatado		O Valor da parte da recompensa que foi resgatada.
Tipo Fuel Tank		Isso pode ser qualquer um dos dois Crédito ou % de desconto.
Código do tanque de combustível		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 indicada		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 erro de validação Você pode obter 3 tipos de erros de validação: 1. **Mensagem de erro inline:** estas 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. **Aviso de erro:** estas 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 formatados incorretamente. * `FILE_REF_IO` — por exemplo, o arquivo está corrompido e não pode ser lido.

3. **Erros listados:** estes aparecem como uma lista de contagens de erros na tela *Importações e Exportações* quando o tipo de importação não tem uma tabela de validação de pré-visualização. Os erros de linha e os erros de arquivo serão exibidos juntos: 1. Na barra de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Relatórios**. 2. Selecione **Importações e Exportações** para ver 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.