Como fazer a integração com a ActBlue

Estimado 5 min de leitura
|
Atualizado 28 de mar. de 2025, 19:01 EST
O que você vai aprender

O que você vai aprender

Saiba como integrar o ActBlue com o 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 da ActBlue:

  • 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á
  • O Comitê para o qual a doação foi feita
  • O EntityID e o FecID
Adicionar a integração do ActBlue

Adicionar a integração do ActBlue

  1. Na Klaviyo, selecione a aba Integrações.
  2. Clique em Add integrations (Adicionar integrações), procure o ActBlue e clique no cartão. Em seguida, clique em Install (Instalar).
  3. Selecione Conectar à ActBlue.
  4. Na próxima página, copie o URL do webhook, o nome de usuário e a senha e envie-os para seu gerente de conta da ActBlue. Se o senhor não tiver um contato na ActBlue, entre em contato com nossa equipe de suporte e nós o encaminharemos para a ActBlue (esse processo geralmente leva menos de 24 horas).
  5. Clique em Complete setup (Concluir configuração).
Monitorar a sincronização do Klaviyo

Monitorar a sincronização do Klaviyo

Para verificar sua integração com o ActBlue (depois que o senhor estiver totalmente integrado):

  1. Clique no menu suspenso Analytics em sua conta Klaviyo e selecione a guia Metrics (Métricas ).
  2. Clique na métrica Contribuição feita (identificável com um ícone da ActBlue) para verificar se há dados preenchidos para essa métrica.
  3. Se houver dados, tudo o que o senhor precisa fazer é esperar até que a sincronização do histórico da sua integração com o ActBlue seja concluída; esse processo pode levar até duas horas, dependendo da quantidade de dados que o senhor tem em sua conta.
  4. O Klaviyo importará todos os seus dados históricos do ActBlue. Para verificar isso, o senhor pode comparar o número de pedidos em um determinado dia no Klaviyo com o que está na sua interface do ActBlue e confirmar se são iguais. Por exemplo, ao explorar a métrica Made Contribution , o senhor pode passar o mouse sobre o ponto de dados de ontem ou examinar a tabela de dados abaixo do gráfico para ver quantos pedidos foram relatados ontem.
  5. Compare esse número com o que está armazenado no ActBlue 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 Klaviyo não corresponde ao fuso horário da sua conta ActBlue.
  6. 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 ActBlue

Dados sincronizados do ActBlue

Há uma métrica importante que é capturada pela ActBlue e sincronizada com a Klaviyo: Contribuição feita.

Guia Métricas no Klaviyo filtrada pela ActBlue mostrando a métrica Contribuição feita

Contribuição feita

Contribuição feita

Esse evento é rastreado quando um cliente conclui o processo de checkout e faz uma contribuição na ActBlue. O evento que a Klaviyo sincroniza inclui todas as informações que a ActBlue 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
  • Recurring
    Essa opção é verdadeira ou falsa.
  • Recurring Period
    Será "Once" se a doação não for recorrente; caso contrário, indicará a frequência com que a doação é recorrente.
  • Nome do comitê
    O nome do comitê para o qual a contribuição foi feita.
  • ID da entidade
  • FecID

Aqui está um exemplo dos dados que recebemos junto com um evento de Contribuição Feita :

Popup de detalhes do evento no Klaviyo para um evento de Contribuição Feita

Dados do cliente

Dados do cliente

Além das duas métricas principais que a Klaviyo sincroniza da ActBlue, a Klaviyo também cria um Perfil Klaviyo abrangente para cada contribuidor. Além das informações básicas de contato, a Klaviyo também sincronizará quaisquer detalhes adicionais que o senhor possa ter armazenado no ActBlue sobre uma determinada pessoa - esses detalhes serão sincronizados como 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 padrão que são sincronizadas automaticamente a partir do ActBlue:

  • E-mail
  • Primeiro nome
  • Sobrenome
  • Cidade
  • Estado/Região
  • Código Postal
  • País
  • Número de telefone
Frequência da sincronização do ActBlue

Frequência da sincronização do ActBlue

A métrica Contribuição feita e as propriedades de perfil personalizado da ActBlue são sincronizadas usando webhooks. Isso significa que a ActBlue indica à Klaviyo quando um evento ocorreu e a Klaviyo extrai todos os dados relevantes para o evento. Isso ocorre quase instantaneamente. 

Adicionar rastreamento no local do Klaviyo

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 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. 
    Etapa 2 da configuração do rastreamento da Web com caixa de texto para URL e botão Next com fundo azul
Resultado

Resultado

O senhor já integrou a ActBlue, verificou seus dados sincronizados e adicionou o rastreamento no local da Klaviyo. 

Recursos adicionais

Recursos adicionais

Esse artigo foi útil?
Use esse formulário somente para dar feedback sobre os artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Community
Conecte-se com colegas, parceiros e especialistas da Klaviyo para ter ideias, compartilhar insights e tirar dúvidas.
Treinamentos ao vivo
Participe de uma sessão ao vivo com especialistas da Klaviyo para conhecer práticas recomendadas, saber como configurar os principais recursos e muito mais.
Suporte

Acesse o suporte na sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano