Como fazer a integração com o DonorPerfect

O que você vai aprender

Saiba como integrar o DonorPerfect com a Klaviyo. Depois de concluir essas etapas, o senhor poderá personalizar e direcionar e-mails com base na doação de cada colaborador e na atividade do site. Aqui estão alguns dos dados que sincronizamos do DonorPerfect:

• Valor da contribuição
• Informações do colaborador, incluindo nome e sobrenome, local e como ele encontrou seu site
• Se a doação é recorrente e, em caso afirmativo, com que frequência ela ocorrerá
• Se o contribuinte deseja ser anônimo

Primeiro, o senhor precisará encontrar sua chave de API do DonorPerfect e, em seguida, habilitar a integração no Klaviyo.

Encontre sua chave de API

O senhor pode obter sua chave de API no seu DonorPerfect Account Manager. Envie um e-mail ao gerente da sua conta solicitando sua chave de API e ele a enviará para o senhor em breve. 

Adicionar a integração do DonorPerfect no Klaviyo

1. Na Klaviyo, selecione a aba Integrações.
2. Na página seguinte, clique em Add integrations (Adicionar integrações), procure o DonorPerfect e clique no cartão.
3. Em seguida, clique em Install (Instalar).
4. Adicione sua chave de API do DonorPerfect e clique em Connect to DonorPerfect (Conectar ao DonorPerfect).
5. Na próxima página, escolha Add all DonorPerfect donors to a Klaviyo list (Adicionar todos os doadores do DonorPerfect a uma lista da Klaviyo) e selecione uma lista no menu suspenso que aparece.
   
6. Clique em Complete setup (Concluir configuração).

Monitorar a sincronização do Klaviyo e verificar os dados

Para verificar sua integração com o DonorPerfect, depois que o senhor tiver feito a integração:

1. Clique no menu suspenso Analytics no Klaviyo e selecione a guia Metrics (Métricas ).
2. Clique na métrica Contribuição feita para verificar se há dados preenchidos para essa métrica. Se houver dados, tudo o que o senhor precisa fazer é esperar até que a sincronização inicial da integração com o DonorPerfect seja concluída; esse processo pode levar até duas horas, dependendo da quantidade de dados que o senhor tem na sua conta. O Klaviyo importará todos os seus dados históricos do DonorPerfect. Para verificar isso, o senhor pode comparar o número de contribuições em um determinado dia na Klaviyo com o que está na interface do DonorPerfect e confirmar se são iguais.
3. Por exemplo, ao explorar a métrica Contribuição feita na Klaviyo, o senhor pode passar o mouse sobre o ponto de dados de ontem ou olhar a tabela de dados abaixo do gráfico para ver quantas contribuições foram relatadas ontem.
4. Compare esse número com o que está armazenado no DonorPerfect de ontem e o senhor verá que eles são exatamente iguais. Se isso não acontecer, o problema provavelmente é que o fuso horário da sua conta da Klaviyo não corresponde ao fuso horário da sua conta do DonorPerfect.
5. Para verificar sua configuração de fuso horário no Klaviyo: 
   1. Clique no nome de sua conta no canto inferior esquerdo.
   2. Selecione e clique em Settings (Configurações) > Organization (Organização).
   3. Role para baixo até Timezone.

Dados do DonorPerfect

Há uma métrica principal que é capturada pela DonorPerfect e carregada em Klaviyo: Made Contribution.

A métrica Contribuição feita

Esse evento é rastreado quando um apoiador faz uma contribuição no DonorPerfect. O evento que a Klaviyo rastreia inclui todas as informações que a DonorPerfect coleta, inclusive o valor da contribuição, se a doação é recorrente e, em caso afirmativo, com que frequência a doação será recorrente. O senhor pode filtrar e direcionar eventos de Contribuição Feita com base nos seguintes critérios:

• Valor
• Campanha
• Primeiro presente
• Tipo de presente
• Em memória de
• É recorrente (Verdadeiro ou Falso)

Aqui está um exemplo dos dados que recebemos junto com um evento Made Contribution :

Dados do cliente

Além da métrica que a Klaviyo sincroniza com o DonorPerfect, há também propriedades personalizadas que são adicionadas a cada perfil da Klaviyo. O senhor pode usar essas propriedades em segmentos e fluxos. Aqui estão as propriedades que são sincronizadas automaticamente com o DonorPerfect:

• E-mail
• Primeiro nome
• Sobrenome
• Cidade
• Estado/Região
• Código Postal
• País
• Número de telefone

Com que frequência os dados do DonorPerfect são sincronizados

As métricas e as propriedades de perfil do DonorPerfect são sincronizadas usando webhooks. Isso significa que o DonorPerfect indica à Klaviyo quando um evento ocorre e a Klaviyo extrai todos os dados do evento. Isso ocorre quase instantaneamente. 

Adicionar rastreamento no local do Klaviyo

A etapa final aqui é adicionar o código de rastreamento Active on Site da Klaviyo ao rodapé do seu site. Esse código de rastreamento da Klaviyo nos permitirá rastrear uma métrica Active on Site para que o senhor possa ver e aproveitar os dados relacionados às visitas ao site e ao comportamento do visitante. Por meio dessa métrica, a Klaviyo rastreará a atividade do site para 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. O script de rastreamento a seguir pode ser encontrado em Klaviyo, selecionando a guia integrações e clicando em Manage sources > Set up rastreamento web no canto superior direito.
2. Também incluímos aqui o script de rastreamento Klaviyo Active on Site , que o senhor pode colar no modelo principal do seu aplicativo antes da </body>tag</body >. Lembre-se de adicionar sua própria chave de API, que pode ser encontrada em Account name (Nome da conta) > Settings (Configurações) > API keys (Chaves de API), onde o senhor vê "Public API Key" (Chave de API pública):

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

3. Em seguida, o senhor precisará inserir o URL do seu site na página Set Up Web Tracking. Depois de inserir o URL, clique em Next (Avançar ) para testar a configuração do rastreamento. O senhor deve receber uma mensagem de sucesso se estiver funcionando corretamente. 
   

Resultado

O senhor já se integrou ao DonorPerfect, verificou seus dados sincronizados e adicionou o rastreamento no local da Klaviyo. 

Recursos adicionais

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