Como Integrar com a ActBlue
O que você vai aprender
Saiba como fazer a integração do ActBlue com a Klaviyo. Depois de concluir essas etapas, você poderá personalizar e segmentar e-mails com base na doação e na atividade de cada colaborador no site. Confira alguns dos dados que sincronizamos do ActBlue:
- Valor da contribuição
- Informações do colaborador, incluindo nome e sobrenome e local, além de códigos de indicação da contribuição quando fornecidos
- Se a doação é recorrente e, se for, com que frequência ela vai ocorrer
- O comitê ao qual a doação foi feita
- O EntityID e o FecID
Adicionar a integração ActBlue
- Na Klaviyo, selecione a aba Integrações.
- Clique em Explorar aplicativos, procure por ActBlue e clique no cartão. Em seguida, clique em Instalar.
- Selecione Conectar à ActBlue.
- Na próxima página, copie a URL do webhook, o nome de usuário e a senha e envie-os para o Gerente da sua conta do ActBlue. Se você não tiver um contato no ActBlue, entre em contato com nossa Equipe de suporte e nós encaminharemos para o ActBlue (esse processo geralmente leva menos de 24 horas). Copie e guarde a senha em um local seguro antes de concluir a configuração. Você não poderá visualizá-la novamente depois disso.
- Clique em Concluir configuração.
Monitore a sincronização do Klaviyo
Para verificar sua integração do ActBlue (depois que você fizer a integração completa):
- Clique no menu suspenso Análises na sua conta Klaviyo e selecione a guia Métrica.
- Clique na métrica Contribuição feita (identificável com um ícone do ActBlue) para verificar se há dados preenchidos para essa métrica.
- Se aparecerem dados, o Klaviyo está recebendo contribuições do ActBlue. Para contribuições históricas, confirme com seu gerente de conta do ActBlue quais datas serão enviadas e quando a transferência será concluída.
- Defina Medição como Total e Agregação como Diária. Para verificar os dados que a ActBlue enviou, compare o número de contribuições em um dia específico na Klaviyo com o que aparece na sua interface da ActBlue. Por exemplo, ao explorar a métrica Made Contribution , você pode passar o cursor sobre o ponto de dados de ontem ou consultar a tabela de dados abaixo do gráfico para ver quantas contribuições foram registradas ontem.
- Se os totais não corresponderem, verifique se a sua conta do Klaviyo e o ActBlue usam o mesmo fuso horário e confirme se o ActBlue enviou as contribuições para as datas que você está comparando. Contribuições com endereço de e-mail ausente ou inválido não são sincronizadas.
- Para verificar a configuração de fuso horário na Klaviyo:
- Clique no nome da sua conta no canto inferior esquerdo.
- Selecione Configurações > Geral > Conta.
- Role para baixo até Fuso horário. Se você alterar a configuração, clique em Salvar.
Dados sincronizados do ActBlue
Há 1 métrica principal que é capturada pelo ActBlue e sincronizada com a Klaviyo: Made Contribution.
Contribuição Realizada
Esse evento é registrado quando um cliente conclui o processo de checkout e faz uma contribuição no ActBlue. O evento que a Klaviyo sincroniza inclui detalhes da contribuição, como o valor da contribuição, se a doação é recorrente e, em caso afirmativo, com que frequência a doação vai se repetir. Você pode filtrar e segmentar eventos de Made Contribution com base nos seguintes critérios:
- Valor
- Recorrente
Isso é True ou False. - Período recorrente
Isso será "Once" se a doação não for recorrente; caso contrário, indicará com que frequência a doação se repete. - Nome do comitê
O nome do comitê ao qual a contribuição foi feita. - ID da entidade
- FecID
Este é um exemplo dos dados que recebemos junto com um evento Made Contribution :
dados do cliente
Além dos eventos Made Contribution, a Klaviyo cria ou atualiza um perfil quando recebe uma contribuição com um endereço de e-mail válido. Ela sincroniza os campos do colaborador listados abaixo. Outros detalhes armazenados no ActBlue não são adicionados automaticamente como propriedades personalizadas. Você pode usar essas propriedades em segmentos e fluxos.
- Nome
- Sobrenome
- Cidade
- Estado/Região
- CEP
- País
- Telefone
- Endereço
- Empregador
- Ocupação
Frequência de sincronização do ActBlue
Os eventos de contribuições feitas e os detalhes do perfil do contribuidor são sincronizados usando webhook. O ActBlue envia os dados da contribuição para a Klaviyo quase instantaneamente quando ocorre um evento.
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 que visitaram seu site a partir de um navegador que a Klaviyo identificou, mas que ainda não fizeram uma doação.
A configuração manual abaixo exige acesso ao código do seu site. Se você já ativou o rastreamento no site pelas integrações de e-commerce do seu site, siga Guia de introdução ao rastreamento no site do Klaviyo para conferir as instruções da sua plataforma.
- O script de rastreamento a seguir pode ser encontrado na Klaviyo selecionando a guia Integrações e clicando em Gerenciar dados > Configurar rastreamento web no canto superior direito.
- Em Ativar rastreamento no site, selecione Configurar manualmente e clique em Próximo. Se o código de instalação já estiver sendo exibido, continue para a próxima etapa.
- Também incluímos aqui o script de rastreamento do Klaviyo com atividade no site, que você pode colar no modelo principal do seu site antes da tag
</body>. Lembre-se de adicionar sua própria chave de API, encontrada em Configurações > Geral > Chaves de API, onde você vê “Chave de API pública”. Salve e publique o modelo do seu site após adicionar o script:
<script type="application/javascript" async
src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=Public API Key"></script>- Volte para Ativar rastreamento no site, insira o URL do seu site e clique em Confirmar para verificar a instalação. Se solicitado, clique em Executar teste, deixe o site carregar e depois volte para a Klaviyo.
- Se a Klaviyo pedir para atualizar seu site nas configurações da conta, revise o URL antes de continuar. Atualizá-la também afeta modelos existentes que têm link para seu site. Selecione Atualizar para usar o URL testado ou Continuar sem atualizar para manter o URL atual da sua conta.
- Depois que a Klaviyo confirmar que o rastreamento no site está habilitado, clique em Fechar.
Resultado
Agora você integrou com a ActBlue, verificou seus dados sincronizados e adicionou o rastreamento onsite da Klaviyo.
Recursos adicionais
- Perguntas frequentes sobre integrações
Saiba as respostas para algumas perguntas frequentes sobre integrações. Se a sua pergunta não for respondida aqui, fale conosco no nosso fórum da Community.
- Referência de frequência de sincronização das integrações
Aprenda quais dados são sincronizados a partir de uma integração específica da Klaviyo e com que frequência a sincronização é executada. Organizamos essas integrações por plataformas de e-commerce, ESP e outras integrações de dados.