Como integrar com a DonorPerfect

O que você vai aprender

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

• Valor da contribuição
• Informações do colaborador, incluindo nome e sobrenome e localidade
• Frequência de doação, quando fornecida no DonorPerfect
• IDs e sinalizadores de doadores do DonorPerfect

Primeiro, você precisa encontrar sua chave de API do DonorPerfect e, em seguida, ativar a integração no Klaviyo.

Você precisa de permissão para gerenciar integrações no Klaviyo para concluir a configuração.

Encontre sua chave de API

Você pode recuperar sua chave de API com o Gerente da sua conta da DonorPerfect. Envie um e-mail ao gerente da sua conta solicitando sua chave de API, e ele a enviará para você em breve.

Adicione a integração da DonorPerfect na Klaviyo

1. Na Klaviyo, selecione a aba Integrações.
2. Na próxima página, clique em Explorar aplicativos, procure por DonorPerfect e clique no cartão.
3. Em seguida, clique em Instalar.
4. Adicione sua chave de API do DonorPerfect e clique em Conectar ao DonorPerfect.
5. Opcional: selecione Adicionar todos os doadores do DonorPerfect a uma lista do Klaviyo e selecione uma lista no menu suspenso. Adicionar doadores a uma lista não os inscreve em mensagens de marketing.

6. Clique em Concluir configuração.

Monitore a sincronização do Klaviyo e verifique os dados

Para verificar sua integração com a DonorPerfect depois de integrar:

1. Clique no menu suspenso Analytics no Klaviyo e selecione a guia Métricas.
2. Clique na métrica Made Contribution para verificar se há doações importadas. Aguarde a sincronização inicial terminar antes de comparar as contagens. A Klaviyo importa dados históricos de doadores e contribuições, mas apenas para doadores com um endereço de e-mail válido. Contribuições com valor ausente ou inválido, com ID de doação ausente ou com valor de 0 são ignoradas. O tempo necessário para a sincronização inicial depende de quantos dados há na sua conta do DonorPerfect.
3. No gráfico Contribuição feita, selecione Total em Medição e use a agregação diária para comparar as contagens de contribuição. Por exemplo, passe o mouse sobre o ponto de dados de ontem ou confira a tabela abaixo do gráfico para ver quantas contribuições foram registradas ontem.
4. Compare essa contagem com as contribuições armazenadas no DonorPerfect para o mesmo dia. Se as contagens forem diferentes, espere a sincronização por hora e verifique se alguma contribuição foi excluída pelos motivos acima.
5. Para verificar a configuração de fuso horário na Klaviyo:
   1. Clique no nome da sua conta no canto inferior esquerdo.
   2. Selecione Configurações > Geral > Conta.
   3. Role para baixo até Fuso horário.

A Klaviyo registra cada contribuição ao meio-dia, no fuso horário da sua conta da Klaviyo, na data da doação do DonorPerfect. Se não houver data da doação, ela usa a data de criação da contribuição.

Dados da DonorPerfect

Há 1 métrica principal capturada pelo DonorPerfect e carregada na Klaviyo: Contribuição feita.

A métrica Contribuição Realizada

Esse evento é rastreado quando um apoiador faz uma contribuição no DonorPerfect e a contribuição é importada para o Klaviyo. Ele inclui o valor da contribuição e os detalhes da doação apoiada que são preenchidos no DonorPerfect. Você pode filtrar e segmentar eventos Made Contribution usando propriedades como:

• Valor
• Campanha
• PrimeiroPresente
• Tipo de presente
• Na memória
• Frequência

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

dados do cliente

Além dos eventos Made Contribution, o Klaviyo sincroniza as informações do doador com perfis com um endereço de e-mail válido. Você pode usar Propriedades do perfil em segmentos e fluxos. Os seguintes campos padrão de perfil são sincronizados do DonorPerfect:

• E-mail
• Nome
• Sobrenome
• Cidade
• Estado/Região
• CEP
• País
• Telefone

A Klaviyo também importa a propriedade personalizada DonorPerfect DonorID e as flags de doador chamadas DonorPerfect Flag <flag name>. As flags são definidas como true quando estão presentes no DonorPerfect e são removidas do perfil quando uma sincronização posterior não as encontra mais.

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

A Klaviyo verifica o DonorPerfect em busca de novos dados de doadores e de contribuições aproximadamente a cada hora. Novas doações e informações de perfil não são sincronizadas instantaneamente.

Adicionar rastreamento no site da Klaviyo

A etapa final aqui é adicionar o código de rastreamento com atividade no site do Klaviyo ao rodapé do seu site. Este código de rastreamento da Klaviyo permitirá que a gente acompanhe uma métrica Com atividade no site para você, para que você possa ver e aproveitar dados relacionados a visitas ao site e ao comportamento dos visitantes. Por meio dessa métrica, o Klaviyo vai rastrear a atividade do site para navegadores conhecidos.

Por exemplo, você pode usar a métrica Com atividade no site para criar segmentos de pessoas cujos navegadores o Klaviyo identificou e que visitaram seu site, mas ainda não fizeram uma doação.

Para fazer a instalação manual, você precisa ter acesso para editar e publicar o modelo principal do seu site. As etapas abaixo cobrem a configuração manual; se a Klaviyo mostrar instruções para a plataforma de e-commerce do seu site, siga essas instruções.

1. O script de rastreamento a seguir pode ser encontrado na Klaviyo selecionando a aba Integrações e, em seguida, clicando em Gerenciar dados > Configurar rastreamento web no canto superior direito.
2. Se você for solicitado a escolher um método de instalação, selecione Configurar manualmente e clique em Próximo.
3. Copie o código mostrado no Klaviyo ou use o script abaixo e cole-o no modelo principal do seu site antes da tag </body>. Se você usar o script abaixo, substitua Public API Key pela sua chave de API pública do Klaviyo. Para encontrar, clique no nome da sua conta e selecione Configurações > Geral > Chaves de API e, em seguida, copie a chave de API pública. Use sua chave de API pública do Klaviyo aqui, não sua chave de API do DonorPerfect nem uma chave de API privada do Klaviyo.

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

1. Salve e publique o modelo do seu site antes de testar a instalação.
2. Volte para a configuração de rastreamento da Klaviyo, insira o URL do seu site em Confirme se o rastreamento no site está ativado e clique em Confirmar. A Klaviyo mostra uma mensagem de sucesso quando verifica a instalação. Se não for possível verificar, siga as instruções de solução de problemas exibidas.

3. Se a Klaviyo pedir que você atualize o URL do site nas configurações da sua conta, escolha Atualizar para alterá-lo ou Continuar sem atualizar para manter o URL existente. Atualizar isso também afeta os modelos existentes que têm link para a URL do site da sua conta.

Resultado

Agora você integrou com a DonorPerfect, verificou seus dados sincronizados e adicionou o rastreamento onsite da Klaviyo.

Recursos adicionais