Cómo integrar con DonorPerfect

Objetivos del artículo

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

• Cantidad de contribución
• Información del colaborador, incluidos el nombre, el apellido y la ubicación
• Frecuencia de donación, cuando se proporciona en DonorPerfect
• ID de donantes y marcadores de DonorPerfect

Primero, tendrás que encontrar tu clave de API de DonorPerfect y luego habilitarás la integración en Klaviyo.

Necesitas permiso para administrar integraciones en Klaviyo y completar la configuración.

Encuentra tu clave de API

Puedes recuperar tu clave de API desde tu Gerente de cuentas de DonorPerfect. Envía a tu gerente de cuentas un correo electrónico para solicitar tu clave de API y te la enviará en breve.

Agrega la integración de DonorPerfect en Klaviyo

1. En Klaviyo, selecciona la pestaña Integraciones.
2. En la página siguiente, haz clic en Explorar aplicaciones, busca DonorPerfect y haz clic en la tarjeta.
3. Entonces haz clic en Instalar.
4. Agrega tu clave de API de DonorPerfect y haz clic en Conectar a DonorPerfect.
5. Opcional: selecciona Agregar todos los donantes de DonorPerfect a una lista de Klaviyo y luego selecciona una lista en el menú desplegable. Agregar donantes a una lista no los suscribe a los mensajes de marketing.

6. Haz clic en Completar la configuración.

Monitorea la sincronización de Klaviyo y verifica los datos

Para revisar tu integración de DonorPerfect una vez que la hayas integrado:

1. Haz clic en el menú desplegable Analytics en Klaviyo y selecciona la pestaña Métricas.
2. Haz clic en la métrica Made Contribution para verificar si hay donaciones importadas. Espera a que termine la sincronización inicial antes de comparar los conteos. Klaviyo importa datos históricos de donantes y contribuciones, pero solo de donantes con una dirección de correo electrónico válida. Se omiten las contribuciones con un monto faltante o no válido, un ID de donación faltante o un monto de 0. El tiempo necesario para la sincronización inicial depende de cuántos datos haya en la cuenta de DonorPerfect.
3. En el gráfico Made Contribution, selecciona Total en Medición y usa la agregación diaria para comparar los recuentos de contribuciones. Por ejemplo, pasa el cursor sobre el punto de datos de ayer o consulta la tabla debajo del gráfico para ver cuántas contribuciones se reportaron ayer.
4. Compara esa cantidad con las contribuciones registradas en DonorPerfect para el mismo día. Si las cantidades no coinciden, toma en cuenta la sincronización por hora y revisa si se excluyeron contribuciones por los motivos anteriores.
5. Para verificar la configuración de zona horaria en Klaviyo:
   1. Haz clic en el nombre de tu cuenta en la parte inferior izquierda.
   2. Selecciona Configuración > General > Cuenta.
   3. Desplázate hacia abajo hasta Zona horaria.

Klaviyo registra cada contribución al mediodía en la zona horaria de la cuenta de Klaviyo, en la fecha de donación de DonorPerfect. Si no hay una fecha de donación, se usa la fecha de creación de la contribución.

Datos de DonorPerfect

Hay 1 métrica principal que DonorPerfect captura y se carga en Klaviyo: Contribución realizada.

La métrica Contribución Realizada

Este evento se registra cuando un simpatizante hace una contribución en DonorPerfect y la contribución se importa a Klaviyo. Incluye el monto de la contribución y los detalles de la donación apoyada que se completan en DonorPerfect. Puedes filtrar y dirigir eventos de Contribución realizada usando propiedades como:

• Valor
• Campaña
• FirstGift
• Tipo de regalo
• En memoria
• Frecuencia

Aquí tienes un ejemplo de los datos que recibimos junto con un evento de Made Contribution :

datos de clientes

Además de los eventos de contribución realizada, Klaviyo sincroniza la información de donantes con perfiles que tienen una dirección de correo electrónico válida. Puedes usar las propiedades del perfil en segmentos y flujos. Los siguientes campos estándar del perfil se sincronizan desde DonorPerfect:

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

Klaviyo también importa la propiedad personalizada DonorPerfect DonorID y los indicadores de donante llamados DonorPerfect Flag <flag name>. Los indicadores se establecen como true cuando están presentes en DonorPerfect y se eliminan del perfil cuando una sincronización posterior ya no los encuentra.

Con qué frecuencia se sincronizan los datos de DonorPerfect

Klaviyo revisa DonorPerfect para obtener nuevos datos de donantes y contribuciones aproximadamente cada hora. Las donaciones nuevas y la información de perfil no se sincronizan de forma instantánea.

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 cuyos navegadores Klaviyo ha identificado y que han visitado tu sitio, pero que aún no han hecho una donación.

Para la instalación manual, necesitas acceso para editar y publicar la plantilla principal del sitio web. Los pasos a continuación cubren la configuración manual; si Klaviyo muestra instrucciones para la plataforma de ecommerce del sitio web, sigue esas instrucciones.

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. Si se te solicita elegir un método de instalación, selecciona Configurar manualmente y haz clic en Siguiente.
3. Copia el código que se muestra en Klaviyo o usa el siguiente script y pégalo en la plantilla principal del sitio web antes de la etiqueta </body>. Si usas el siguiente script, reemplaza Public API Key con tu clave de API pública de Klaviyo. Para encontrarla, haz clic en el nombre de tu cuenta y selecciona Configuración > General > Claves de API, y luego copia la Clave de API pública. Usa aquí tu clave de API pública de Klaviyo, no tu clave de API de DonorPerfect ni una clave de API privada de Klaviyo.

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

1. Guarda y publica la plantilla de tu sitio web antes de probar la instalación.
2. Vuelve a la configuración de seguimiento de Klaviyo, ingresa la URL del sitio web en Confirmar que el seguimiento en el sitio esté habilitado y haz clic en Confirmar. Klaviyo muestra un mensaje de éxito cuando verifica la instalación. Si no puede verificarlo, sigue las instrucciones de solución de problemas que se muestran.

3. Si Klaviyo te pide que actualices la URL del sitio web en la configuración de la cuenta, selecciona Actualizar para cambiarla o Continuar sin actualizar para conservar la URL existente. Actualizarlo también afecta a las plantillas existentes que se vinculan a la URL del sitio web de la cuenta.

Resultado

Ya integraste DonorPerfect, verificaste los datos sincronizados y agregaste el seguimiento en el sitio de Klaviyo.

Recursos adicionales