Cómo realizar la integración con ActBlue

Objetivos del artículo

Aprende a integrar ActBlue con Klaviyo. Después de completar estos pasos, podrás personalizar y dirigir los correos electrónicos en función de la donación y la actividad en el sitio web de cada colaborador. Estos son algunos de los datos que sincronizamos desde ActBlue:

• Monto de la contribución
• Información de contribuyente, incluido el nombre, apellido y ubicación, además de los códigos de referencia de contribución cuando se proporcionen
• Si el donativo es recurrente y, si es así, con qué frecuencia ocurrirá
• El comité al que se hizo la donación
• El EntityID y el FecID

Añadir la integración de ActBlue

1. En Klaviyo, selecciona la pestaña Integraciones.
2. Haz clic en Explorar aplicaciones, busca ActBlue y haz clic en la tarjeta. Entonces haz clic en Instalar.
3. Selecciona Conectar a ActBlue.
   

4. En la siguiente página, copia la URL del webhook, el nombre de usuario y la contraseña, y envíalos a tu Gerente de cuenta de ActBlue. Si no tienes un contacto en ActBlue, comunícate con nuestro equipo de soporte y lo reenviaremos a ActBlue (este proceso suele tardar menos de 24 horas). Copia y guarda la contraseña en un lugar seguro antes de completar la configuración. No podrás volver a verla después.
5. Haz clic en Completar la configuración.

Monitorea la sincronización de Klaviyo

Para revisar la integración de ActBlue (una vez que hayas completado la integración):

1. Haz clic en el menú desplegable Análisis de tu cuenta de Klaviyo y selecciona la pestaña Métricas.
2. Haz clic en la métrica Made Contribution (identificable con un ícono de ActBlue) para verificar que haya datos registrados para esta métrica.
3. Si aparecen datos, Klaviyo está recibiendo contribuciones de ActBlue. Para contribuciones históricas, confirma con el gerente de cuenta de ActBlue qué fechas se enviarán y cuándo se complete la transferencia.
4. Configura Measurement como Total y Aggregation como Daily. Para verificar los datos que ActBlue envió, compara el número de contribuciones en un día en particular en Klaviyo con lo que aparece en la interfaz de ActBlue. Por ejemplo, al explorar la métrica Made Contribution , puedes pasar el cursor sobre el punto de datos de ayer o revisar la tabla de datos debajo de la gráfica para ver cuántas contribuciones se reportaron ayer.
5. Si los totales no coinciden, revisa que tu cuenta de Klaviyo y ActBlue usen la misma zona horaria y confirma que ActBlue haya enviado las contribuciones para las fechas que estás comparando. Las contribuciones con una dirección de correo electrónico faltante o no válida no se sincronizan.
6. Para verificar la configuración de zona horaria en Klaviyo:
   • Haz clic en el nombre de tu cuenta en la parte inferior izquierda.
   • Selecciona Configuración > General > Cuenta.
   • Desplázate hacia abajo hasta Zona horaria. Si cambias la configuración, haz clic en Guardar.

Datos sincronizados desde ActBlue

ActBlue captura 1 métrica principal y la sincroniza en Klaviyo: Contribución realizada.

Contribución Realizada

Este evento se registra cuando un cliente completa el proceso de pago y realiza un aporte en ActBlue. El evento que Klaviyo sincroniza incluye detalles del aporte, como el monto del aporte, si la donación es recurrente y, si es así, con qué frecuencia se repetirá la donación. Puedes filtrar y dirigir los eventos de Made Contribution en función de los siguientes criterios:

• Importe
• Recurrente
  Esto es True o False.
• Periodo recurrente
  Será "Una vez" si la donación no es recurrente; de lo contrario, indicará con qué frecuencia se repite la donación.
• Nombre del comité
  El nombre del comité al que se hizo la contribución.
• ID de entidad
• FecID

Este es un ejemplo de los datos que recibimos junto con un evento Made Contribution :

datos de clientes

Además de los eventos Made Contribution, Klaviyo crea o actualiza un perfil cuando recibe una contribución con una dirección de correo electrónico válida. Sincroniza los campos de colaborador que se indican a continuación. Otros detalles almacenados en ActBlue no se agregan automáticamente como propiedades personalizadas. Puedes usar estas propiedades en segmentos y flujos.

• Correo electrónico
• Nombre
• Apellido
• Ciudad
• Estado/región
• Código postal
• País
• Número de teléfono
• Calle y número
• Empleador
• Ocupación

Frecuencia de la sincronización de ActBlue

Los eventos de contribución de Made y los detalles del perfil del colaborador se sincronizan mediante webhooks. ActBlue envía los datos de contribución a Klaviyo casi de forma instantánea cuando ocurre un evento.

Añadir seguimiento en el sitio de Klaviyo

El último paso aquí es agregar el código de seguimiento "con actividad en el sitio" de Klaviyo al pie de página de tu sitio web. Este código de seguimiento de Klaviyo nos permitirá medir una métrica de con actividad en el sitio para que puedas ver y aprovechar datos relacionados con las visitas al sitio y el comportamiento de los visitantes. A través de esta métrica, Klaviyo hará un seguimiento de la actividad del sitio web de los navegadores conocidos.

Por ejemplo, puedes usar la métrica con actividad en el sitio para crear segmentos de personas que han visitado el sitio desde un navegador que Klaviyo ha identificado, pero que todavía no han hecho una donación.

La configuración manual a continuación requiere acceso al código de tu sitio web. Si ya habilitaste el seguimiento en el sitio a través de la integración de ecommerce de tu sitio web, sigue Primeros pasos con el seguimiento en el sitio de Klaviyo para ver las instrucciones para tu plataforma.

1. El guion de seguimiento que sigue se puede encontrar en Klaviyo seleccionando la pestaña Integraciones y luego haciendo clic en Gestionar datos > Configurar el seguimiento web, en la esquina superior derecha.
2. En Habilitar el seguimiento en el sitio, selecciona Configurar manualmente y haz clic en Siguiente. Si el código de instalación ya se muestra, continúa con el siguiente paso.
3. También incluimos aquí el script de seguimiento con actividad en el sitio de Klaviyo, que puedes pegar en la plantilla principal de tu sitio web antes de la etiqueta </body>. Recuerda agregar tu propia clave de API, que encontrarás en Configuración > General > Claves de API, donde veas "Clave de API pública". Guarda y publica la plantilla de tu sitio después de agregar el script:

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

1. Vuelve a Habilitar seguimiento en el sitio, ingresa la URL de tu sitio web y haz clic en Confirmar para verificar la instalación. Si se solicita, haz clic en Ejecutar prueba, deja que el sitio web cargue y luego vuelve a Klaviyo.

2. Si Klaviyo pide actualizar el sitio web en la configuración de la cuenta, revisa la URL antes de continuar. Actualizarla también afecta las plantillas existentes que se vinculan con el sitio web. Selecciona Actualizar para usar la URL probada, o Continuar sin actualizar para conservar la URL actual de la cuenta.
3. Una vez que Klaviyo confirme que el seguimiento en el sitio está habilitado, haz clic en Cerrar.

Resultado

Ahora has integrado ActBlue, verificado los datos sincronizados y agregado el seguimiento en el sitio de Klaviyo.

Recursos adicionales