Importar dados do programa de indicações do SaaSquatch

Este artigo contém referências úteis para ajudar você a importar os dados da sua plataforma de indicação do SaaSquatch para o impact.com.

Referência de 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.
Primeiro IP visto		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 de criação deste usuário participante, 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 no Facebook		O link de compartilhamento do Facebook do programa principal do participante (se especificado).
Link de compartilhamento no Twitter		O link de compartilhamento do 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 no LinkedIn		O link de compartilhamento do 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 externo de usuário do amigo indicado.
Usuário indicado - ID da conta		O ID externo da conta do amigo indicado.
Usuário indicante - ID do usuário		O ID externo de usuário do defensor do cliente.
Usuário indicante - ID da conta		O ID externo da conta do defensor do cliente.
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 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 - 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 no qual esta indicação foi criada.
Usuário indicado - IP de primeira visualização		O primeiro endereço IP que o amigo indicado usou ao carregar um widget.
Usuário indicado - IP de última visualização		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 - Primeiro nome		O primeiro 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 de primeira visualização		O primeiro endereço IP que o defensor do cliente usou ao carregar um widget.
Usuário indicante - IP de última visualização		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, PENDENTE, AÇÃO TOMADA).
Data da moderação		A data em que a indicação foi iniciada, 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 indicante - 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 ganhos, 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.
Fonte 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 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 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 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 total 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. Isso é 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 Crédito ou % de desconto.
Código FuelTank		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 anexar 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 anexar 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: estes 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 .
   • MISSING_FIELD — por exemplo, um campo obrigatório como ID do Usuário ou ID da Conta está ausente.

   
2. Chamada de erro: estes 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 Importações e Exportações tela 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 [Engage] → Relatórios.
   2. Selecione Importações e Exportações para visualizar o relatório.