Como fazer a integração com o NeonCRM

O que você vai aprender

Saiba como integrar o NeonCRM ao Klaviyo para personalizar e direcionar e-mails com base nas atividades de doação e registro de eventos de cada colaborador. Os dados sincronizados do NeonCRM para o Klaviyo incluem:

• Quando ocorre uma doação, com detalhes sobre a contribuição
• Informações de contato, incluindo nome e sobrenome, local e campos personalizados
• Quando alguém se inscreve em um evento, com detalhes sobre a inscrição

Integrar o NeonCRM com o Klaviyo

1. No Klaviyo, clique no nome da sua conta no canto inferior esquerdo e selecione Integrations (Integrações).
2. Clique em Add integrations (Adicionar integrações), procure o NeonCRM e clique no cartão. Em seguida, clique em Install (Instalar).
3. O senhor precisará da chave de API do NeonCRM e do ID da organização. Para gerar sua chave de API do NeonCRM, abra uma nova guia e faça login no seu sistema NeonCRM.
4. Navegue até System Settings (Configurações do sistema) > System Users (Usuários do sistema).
5. Clique em New User (Novo usuário); o usuário pode ter o nome que quiser, mas recomendamos que o nome seja algo que diferencie seu uso, como Klaviyo API User (Usuário da API do Klaviyo ).
6. Especifique um nome de usuário e uma senha.
7. Habilite o acesso à API para essa conta de usuário clicando na caixa de seleção.
8. Digite um endereço de e-mail; esse endereço receberá alertas e atualizações da equipe do NeonCRM relacionados ao API.
9.  Clique em Generate para criar sua chave de API; o senhor deverá copiar essa chave de API para colar no Klaviyo.
10.  Clique em Next para concluir o processo de criação desse usuário.
11.  Volte para a Klaviyo e cole sua chave de API.
    
12.  Para encontrar o ID da organização, navegue até a tela de login do sistema NeonCRM.
13.  Observe o URL em seu navegador da Web; o texto após /clients/ e antes de /login.jsp é o ID da organização.
14.  Copie e cole o ID da sua organização no Klaviyo.
15.  Clique em Connect to NeonCRM (Conectar ao NeonCRM).
16.  Se o senhor quiser adicionar contas do NeonCRM a uma lista no Klaviyo, marque essa configuração e selecione uma lista.
17. Clique em Complete setup (Concluir configuração).

Adicionar rastreamento no local do Klaviyo

A etapa final é adicionar o código de rastreamentoActive on Site da Klaviyo ao rodapé do seu site. Esse trecho de código permitirá que o Klaviyo rastreie uma métrica Active on Site para que o senhor possa aproveitar os dados relacionados às visitas ao site e ao comportamento de navegadores conhecidos. 

Por exemplo, o senhor pode usar a métrica Active on Site (Ativo no site ) para criar segmentos de pessoas que visitaram seu site (enquanto estavam conectadas), mas ainda não fizeram uma doação. 

1. Copie o snippet de código de rastreamento Active on Site abaixo:
   

   <script type="application/javascript" async src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=Public API Key"></script>

2. Cole o snippet no modelo principal do seu aplicativo antes da tag </body>.
3. Substitua "Public API Key" no snippet por sua própria chave de API pública do Klaviyo, que pode ser encontrada em Account name (Nome da conta) > Settings (Configurações) > API keys (Chaves de API).
4. Clique novamente no nome de sua conta e selecione Integrations (Integrações).
5. No canto superior direito, clique em Manage sources (Gerenciar fontes) > Setup web tracking (Configurar rastreamento da Web).
6. Digite o URL do seu site na etapa 2 da página Setup Web Tracking.
7. Clique em Next (Avançar ) para testar a configuração do rastreamento da Web; uma chamada verde de sucesso aparecerá se estiver funcionando com êxito.
   

Monitorar a sincronização do Klaviyo 

Para verificar a sincronização de dados por meio de sua integração com o NeonCRM: 

1. Clique no menu suspenso Analytics no Klaviyo e selecione Metrics.
2. Clique na métrica Made Contribution (Contribuição feita ) para verificar se há dados preenchidos para essa métrica; observe que a sincronização inicial da integração com o NeonCRM pode levar algumas horas, dependendo da quantidade de dados que o senhor tem em sua conta.
3. O Klaviyo importará todos os seus dados históricos do NeonCRM; para verificar isso, o senhor pode comparar o número de contribuições em um determinado dia no Klaviyo com o que está na sua conta do NeonCRM e confirmar se são iguais.
4. Se não coincidirem, o problema provavelmente é que o fuso horário da sua conta Klaviyo não coincide com o fuso horário do NeonCRM.
5. Para verificar sua configuração de fuso horário no Klaviyo:
   • Clique no nome de sua conta no canto inferior esquerdo.
   • Selecione e clique em Settings (Configurações) > Organization (Organização).
   • Role para baixo até Timezone.

Dados sincronizados do NeonCRM

Há duas métricas principais sincronizadas do NeonCRM para o Klaviyo: Contribuição feita e Registro no evento.

As métricas e as propriedades de perfil do NeonCRM são sincronizadas a cada 30 minutos.

Contribuição feita

Esse evento é rastreado quando um apoiador faz uma contribuição no NeonCRM. O evento que o Klaviyo rastreia inclui todas as informações coletadas pelo NeonCRM, e o senhor pode filtrar e direcionar os eventos do Made Contribution com base nos seguintes critérios:

• Doação anônima
  Indica se o doador deseja ou não permanecer anônimo (Sim/Não)
• Data de término da campanha
  Data de término da campanha (se disponível)
• Objetivo da campanha
  Meta da campanha (se disponível)
• Nome da campanha
  Nome da campanha
• Data de início da campanha
  Data de início da campanha (se disponível)
• Valor da doação
  Valor da doação
• Data da doação
  Registro de data e hora do evento de doação
• ID da doação
  ID associado ao evento de doação
• Método de solicitação de doação
  Como a doação foi solicitada
• Solicitador de doações
  O advogado que ajudou com esta doação
• Status da doação
  Status da transação de doação
• Tipo de doação
  Tipo de doação (doação, compromisso, pagamento de compromisso, compromisso equivalente)
• Nome do doador
  Normalmente usado para indicar como o doador gostaria de ser reconhecido publicamente (se disponível)
• Nota do doador
  Nota preenchida pelo constituinte ao fazer a doação (se houver)
• Fundo
  A que fundo (se houver) a doação deve ser atribuída
• Nome completo da homenagem/memória
  Homenageado por esta doação (se houver)
• Valor da promessa
  Valor do compromisso do doador
• Status da promessa
  Status do compromisso do doador
• ID da transação
  ID da transação

Registrado no evento

Esse evento é rastreado quando um apoiador se registra para um evento no NeonCRM. O evento que o Klaviyo rastreia inclui todas as informações coletadas pelo NeonCRM, e o senhor pode filtrar e direcionar esses eventos com base nos seguintes critérios:

• Código da campanha
  Código da campanha
• Data de término da campanha
  Data de término da campanha (se disponível)
• Objetivo da campanha
  Meta da campanha (se disponível)
• Nome da campanha
  Nome da campanha
• Data de início da campanha
  Data de início da campanha (se disponível)
• Taxa de admissão ao evento
  Taxa de admissão ao evento
• Nome da categoria do evento
  Nome da categoria do evento
• Código do evento
  Código do evento
• Data de término do evento
  Data de término do evento
• ID do evento
  ID do evento
• Nome do evento
  Nome do evento
• Data de início do evento
  Data de início do evento
• Fundo
  A qual fundo (se houver) a taxa do evento deve ser atribuída

Dados do cliente

Além das duas principais métricas de eventos que o Klaviyo sincroniza do NeonCRM, o Klaviyo também sincroniza informações sobre cada contato/conta que o senhor tem no NeonCRM - tanto contas individuais quanto contas de organizações. As propriedades padrão da conta que são sincronizadas automaticamente a partir do NeonCRM são:

• Data/hora de criação da conta
• Tipo de conta
• Linha de endereço 1
• Linha de endereço 2
• Cidade
• Nome da empresa
• País
• Falecido
• Não entre em contato
• E-mail 1
• Cancelamento de e-mail
• Primeiro nome
• Código postal completo
• Tipo de indivíduo
• Cargo
• Sobrenome
• Tipo de organização
• Telefone 1
• Fonte
• Província
• Estado

O Klaviyo também sincroniza todos os campos personalizados do NeonCRM relacionados a um contato - esses campos personalizados aparecerão como propriedades personalizadas anexadas ao perfil do contato no Klaviyo.

Resultado

O senhor concluiu a integração do NeonCRM com o Klaviyo, adicionou o rastreamento da Web do Klaviyo ao NeonCRM e verificou os dados sincronizados. Agora, o senhor pode personalizar e direcionar e-mails com base nas atividades de doação e registro de eventos de cada colaborador.

Recursos adicionais

• Referência de FAQ de integração
• Com que frequência as integrações sincronizam a referência