Importar Dados do Programa de Indicação do SaaSquatch

Este artigo contém referências úteis para ajudá-lo a importar os dados da sua plataforma de indicação do SaaSquatch para a 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.
Email		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 realizou um upsert não via API.
IP Visto pela Última Vez		O endereço IP do participante na última vez em que ele realizou um upsert não via API.
Data de Criação		A data em que este usuário participante foi criado, formatada em milissegundos desde a epoch unix .
Hash do Email		O valor de hash MD5 do endereço de e-mail de um participante.
Locale		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 no Facebook do programa principal do participante (se especificado).
Link de Compartilhamento no Twitter		O link de compartilhamento no Twitter/X do programa principal do participante (se especificado).
Link de Compartilhamento por Email		O link de compartilhamento por e-mail do programa principal do participante (se especificado).
Link de Compartilhamento no LinkedIn		O link de compartilhamento no LinkedIn do programa principal do participante (se especificado).
Link de Compartilhamento Limpo		O link vanity primário do participante sem codificação.
Campo Personalizado		Se um participante tiver um campo personalizado, {ExampleName} será o nome do campo.

Arquivo de dados de referências

Coluna	Obrigatório	Descrição
Usuário Referido - ID do Usuário		O id de usuário externo do amigo referido.
Usuário Referido - ID da Conta		O id de conta externo do amigo referido.
Usuário Indicador - ID do Usuário		O id de usuário externo do defensor do cliente.
Usuário Indicador - ID da Conta		O id de conta externo do defensor do cliente.
ID da Referência		O identificador único da referência.
Data Modificada		A data em que a referência foi modificada pela última vez (por exemplo, iniciada, convertida, moderada, etc.), formatada em milissegundos desde a epoch unix .
Data de Início da Referência		A data em que a referência foi criada, formatada em milissegundos desde a epoch unix .
Data de Conversão		A data em que a primeira meta foi alcançada, formatada em milissegundos desde a epoch unix .
Data de Modificação do Usuário		A data em que um usuário foi removido de uma referência (exclusão de usuário) ou adicionado a uma referência, formatada em milissegundos desde a epoch unix .
ID do Programa		O identificador do programa para o qual a referência foi criada.
Nome do Programa		O nome do programa para o qual a referência foi criada.
Usuário Referido - Email		O endereço de e-mail do amigo referido.
Usuário Referido - Nome		O primeiro nome do amigo referido.
Usuário Referido - Sobrenome		O sobrenome do amigo referido.
Usuário Referido - Código de Indicação		O código de indicação primário do amigo referido (depende do programa no qual esta referência foi criada).
Usuário Referido - IP Visto pela Primeira Vez		O primeiro endereço IP que o amigo referido usou ao carregar um widget.
Usuário Referido - IP Visto pela Última Vez		O endereço IP mais recente que o amigo referido usou ao carregar um widget.
Usuário Referido - URL da Imagem		A imagem do amigo referido.
Usuário Referido - Locale		O locale do amigo referido.
Usuário Referido - Data de Criação		A data em que o amigo referido foi visto pela primeira vez pelo SaaSquatch (criado no SaaSquatch), formatada em milissegundos desde a epoch unix .
Usuário Referido - Segmentos		Os segmentos de usuário do amigo referido.
referredUserCustomFields.<fieldName>		Os campos personalizados do amigo referido.
Usuário Indicador - Email		O endereço de e-mail do defensor do cliente.
Usuário Indicador - Nome		O primeiro nome do defensor do cliente.
Usuário Indicador - Sobrenome		O sobrenome do defensor do cliente.
Usuário Indicador - 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 referência).
Usuário Indicador - IP Visto pela Primeira Vez		O primeiro endereço IP que o defensor do cliente usou ao carregar um widget.
Usuário Indicador - IP Visto pela Última Vez		O endereço IP mais recente que o defensor do cliente usou ao carregar um widget.
Usuário Indicador - URL da Imagem		A imagem do defensor do cliente.
Usuário Indicador - Locale		O locale do defensor do cliente.
Usuário Indicador - 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 epoch unix .
Status de Moderação		O status de moderação de fraude da referência (por exemplo, PENDENTE, AÇÃO TOMADA).
Data da Moderação		A data em que a referência foi iniciada, formatada em milissegundos desde a epoch unix .
Usuário Referido - ID da Recompensa		O identificador da recompensa do amigo referido.
Usuário Indicador - ID da Recompensa		O identificador da recompensa do defensor do cliente.
Segmentos do Usuário Indicador		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 referência.
Link de Compartilhamento Usado		O link de compartilhamento do defensor do cliente que foi usado para a referência.

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 concedidas, 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 $1,00, o valor seria 100 (centavos).
Nome da Recompensa		O nome que você atribuiu à recompensa ao criá-la em 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. Isto está em Recompensas → Catálogo → Criar recompensas → Nome da Recompensa.
Fonte da Recompensa		Como a recompensa foi criada, por exemplo, Manual, Usuário referido, Inscrição do amigo.
Data de Criação		A data em que a recompensa foi ganha, formatada em milissegundos desde a epoch unix .
Data Concedida		A data em que a recompensa foi concedida, formatada em milissegundos desde a epoch unix . (Esse valor pode diferir de Data de Criação se a recompensa estava pendente).
Data Agendada Para		A data em que a recompensa estava agendada para ser concedida ao usuário, formatada em milissegundos desde a epoch unix .
Data de Expiração		A data após a qual a recompensa não pode mais ser resgatada, formatada em milissegundos desde a epoch unix .
Data de Cancelamento		A data em que você cancelou a recompensa, formatada em milissegundos desde a epoch unix .
Data Modificada		A data em que você fez modificações na recompensa, formatada em milissegundos desde a epoch unix .
Data de Resgate		A data em que a recompensa total foi resgatada pelo usuário, formatada em milissegundos desde a epoch unix .
Crédito Atribuído		O valor na unidade base para recompensas do tipo Crédito. Isto é o equivalente de Valor da Recompensa, mas para recompensas do tipo Crédito.
Valor Resgatado		O Valor da parte da recompensa que foi resgatada.
Tipo de Fuel Tank		Isto pode ser tanto Crédito ou % de desconto.
Código do Fuel Tank		Isto é como um código de cupom, por exemplo, SummerSave20, 20%OFF, etc.
ID do Usuário Referido		O identificador de usuário do amigo referido.
ID da Conta Referida		O identificador da conta do amigo referido.
referral.referredUser.id		Usado em conjunto com ID do Programa para vincular uma referência a um ID de Programa, se quisermos anexar uma referência a uma recompensa. Isto pode não corresponder sempre ao ID do Usuário.
referral.referredUser.accountId		Usado em conjunto com ID do Programa para vincular uma referência a um ID de Programa, se quisermos anexar uma referência a uma recompensa. Isto pode não corresponder sempre 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: essas aparecem na tabela de validação de visualização e fazem com que as linhas com erro sejam destacadas em vermelho:

   • CAMPO_INVÁLIDO — por exemplo, o Data de Criação o campo não foi formatado em milissegundos desde a epoch unix .

   • CAMPO_FALTANDO — por exemplo, um campo obrigatório como ID do Usuário ou ID da Conta está ausente.

   
2. Aviso de erro: estes aparecem no lugar da tabela de validação de visualização como mensagens de aviso em vermelho:

   • CABEÇALHO_FALTANDO — por exemplo, um cabeçalho de coluna obrigatório como ID da Conta ou Valor da Recompensa está ausente.

   • PARSING_CSV — por exemplo, o arquivo CSV contém caracteres especiais que estão formatados incorretamente.

   • ARQ_REF_IO — por exemplo, o arquivo está corrompido e não pode ser lido.

   
3. Erros listados: estes aparecem como uma lista de contagem de erros na Importações & Exportações tela quando o tipo de importação não possui uma tabela de validação de visualização. Erros de linha e erros de arquivo serão exibidos juntos:

   1. Na barra de navegação à esquerda, selecione [Engage] → Relatórios.

   2. Selecione Importações & Exportações para visualizar o relatório.