Integración con Amplitude

Se necesita la ayuda de un desarrollador

Necesitarás la ayuda de tu equipo de desarrollo para configurar la integración. Comparte esta guía con ellos.

Amplitude, una sólida plataforma de análisis de productos, permite a las empresas comprender el comportamiento de los usuarios en tiempo real, realizar un seguimiento de las interacciones dentro del producto y obtener información valiosa sobre la participación, la retención y los ingresos de los usuarios.

La integración de Amplitude con Pushwoosh te permite personalizar las campañas de Pushwoosh con datos de Amplitude, activar campañas automatizadas basadas en las acciones de los usuarios, analizar el rendimiento para una mejora continua y, en última instancia, impulsar una mayor participación, reducir la pérdida de clientes y aumentar los ingresos.

Resumen de la integración

Tipo de integración

Destino: Los datos se envían de Amplitude a Pushwoosh.

Requisitos previos

Para configurar la integración de Transmisión de Eventos y Sincronización de Cohortes de Amplitude a Pushwoosh, asegúrate de que se cumplan los siguientes requisitos previos:

• Necesitas una cuenta activa de Pushwoosh.
• Genera un Token de Acceso a la API en Pushwoosh para enviar datos.
• Localiza tu Código de Aplicación de Pushwoosh antes de configurar la integración.
• Esta integración solo está disponible para clientes de Amplitude con planes de pago.
• Debes tener un plan de pago de Pushwoosh para usar esta integración.

Glosario (mapeo de nombres de entidades si son diferentes)

Cohortes en Amplitude = Segmentos en Pushwoosh

Entidades sincronizadas

• Eventos
• Etiquetas
• Segmentos

¿Cómo funciona la integración?

La integración de Amplitude con Pushwoosh funciona sincronizando datos entre las dos plataformas para mejorar la participación y segmentación de los usuarios. A continuación, se detalla cómo funciona:

Transmisión de datos

• Eventos: Amplitude envía datos de eventos a Pushwoosh. Cada evento contiene un ID de usuario (external_id), un código de aplicación (app_id), una marca de tiempo (created_at) y atributos adicionales (attributes).

• Etiquetas: Pushwoosh recibe etiquetas que se asocian con los perfiles de los usuarios. Estas etiquetas se envían con un ID de usuario (external_id), un código de aplicación (app_id) y propiedades de etiqueta (properties).

• Segmentos: Los segmentos se importan de manera similar a como Pushwoosh maneja las importaciones de CSV. Los usuarios se añaden o eliminan de los segmentos a través de solicitudes.

Flujo de datos

• Eventos y Etiquetas: Los datos se envían desde Amplitude a Pushwoosh en función de las interacciones o atributos de los usuarios rastreados en Amplitude. Los eventos y las etiquetas se crean o actualizan en Pushwoosh según la configuración y los mapeos establecidos en Amplitude.

• Segmentos: Los segmentos se crean en Pushwoosh cuando Amplitude realiza una solicitud. Pushwoosh genera un identificador único para cada segmento, que Amplitude utiliza para manipular el segmento añadiendo o eliminando usuarios.

Solicitudes

Las solicitudes se envían a puntos finales específicos en Pushwoosh para manejar eventos, atributos de usuario y actualizaciones de segmentos. Cada solicitud requiere autenticación y tiene encabezados y formatos de carga útil específicos.

Casos de uso

Seguimiento de eventos

Realiza un seguimiento de las acciones e interacciones de los usuarios desde Amplitude y envía estos eventos a Pushwoosh para activar notificaciones o actualizaciones.

Etiquetado de usuarios

Asigna etiquetas a los usuarios en función de su comportamiento o atributos en Amplitude. Estas etiquetas se pueden utilizar en Pushwoosh para mensajes dirigidos o segmentación.

Gestión de segmentos

Crea y gestiona segmentos de usuarios en Pushwoosh basándote en los datos y segmentos configurados en Amplitude. Esto ayuda a dirigirse a grupos específicos de usuarios con mensajes personalizados.

Gestión automatizada de usuarios

Añade o elimina automáticamente usuarios de los segmentos en función de sus acciones o atributos en Amplitude, garantizando una segmentación actualizada en Pushwoosh.

Configuración de la integración

Sincronización de cohortes

Configuración de Pushwoosh

1. En Pushwoosh, ve a Configuración > Integraciones.

2. Haz clic en Añadir Integración, luego busca y añade Amplitude.

   

3. Copia la Clave de API y el Código de Aplicación de Pushwoosh a tu portapapeles.

Configuración de Amplitude

Para configurar Amplitude para la integración, sigue estos pasos:

1. En tus Datos de Amplitude, ve al Catálogo y selecciona Destinos.
2. En la sección Cohorte, localiza y haz clic en Pushwoosh.

3. Haz clic en Añadir otro destino.

4. Proporciona un nombre y pega la clave de API que copiaste de Pushwoosh.

5. Mapea el campo de ID de Usuario de Amplitude al campo de ID de Usuario de Pushwoosh.
6. Guarda tu configuración cuando hayas terminado.

Envío de una cohorte

Para sincronizar tu primera cohorte, completa los siguientes pasos:

1. En Amplitude, abre la cohorte que deseas sincronizar, luego haz clic en Sincronizar.

2. Elige Pushwoosh y selecciona la cuenta con la que deseas sincronizar. Luego, haz clic en Siguiente.

3. Decide la cadencia de sincronización y guarda tus configuraciones.

Transmisión de eventos

Configuración de Pushwoosh

1. Obtén tu Clave de API de Pushwoosh

2. Localiza el Código de Aplicación en tu cuenta de Pushwoosh.

Configuración de Amplitude

1. En Amplitude, ve a Destinos de Datos y busca Pushwoosh - Transmisión de Eventos.

2. Introduce un nombre de sincronización y luego haz clic en Crear Sincronización.

3. Cambia el Estado de Desactivado a Activado y pega tu Token de Acceso a la API y Código de Aplicación de Pushwoosh.

4. En el menú desplegable de la izquierda, selecciona la propiedad de usuario de Amplitude que corresponde a tu UserID de Pushwoosh.
5. (Opcional) Activa el interruptor Crear y Actualizar usuarios si deseas enviar usuarios y sus propiedades en tiempo real cada vez que Amplitude cree o actualice una propiedad de usuario.

6. Activa Enviar Eventos (“Los eventos se envían a Pushwoosh”) si deseas transmitir eventos a Pushwoosh. Esto reenviará automáticamente los eventos a Pushwoosh a medida que se ingieren en Amplitude. Los eventos no se envían según un horario o bajo demanda con esta integración.

8. Luego, elige qué eventos deseas enviar en la sección Seleccionar y Filtrar Eventos. Selecciona solo los eventos que necesitas en Pushwoosh; los eventos transformados no son compatibles.
9. Una vez hecho, activa el destino y haz clic en Guardar.

¿Cómo saber si la integración está funcionando?

Para verificar que la integración de Amplitude y Pushwoosh funciona correctamente, puedes utilizar los siguientes métodos:

Supervisar el panel de control de Pushwoosh

• Eventos y Etiquetas: Revisa el panel de control de Pushwoosh para ver si los eventos y etiquetas enviados desde Amplitude aparecen como se esperaba. Busca actividades recientes o actualizaciones relacionadas con tus eventos y etiquetas.
• Segmentos: Verifica que los segmentos se están creando, actualizando o modificando en función de los datos de Amplitude. Asegúrate de que los recuentos de usuarios y las membresías de los segmentos reflejen los cambios esperados.

Verificar las respuestas de la API

• Respuestas exitosas: Asegúrate de recibir respuestas 200 OK de los puntos finales de la API de Pushwoosh. Aunque no siempre haya un cuerpo de respuesta, el estado 200 OK indica que la solicitud se recibió con éxito.
• Respuestas de error: Revisa cualquier respuesta de error o código de estado que no sea 200 OK para obtener pistas si algo no funciona. Los errores comunes pueden incluir 400 Bad Request, 401 Unauthorized o 500 Internal Server Error.

Registrar solicitudes y respuestas

• Registros de solicitudes: Mantén registros de las solicitudes salientes de Amplitude y las respuestas entrantes de Pushwoosh. Revisa estos registros para asegurarte de que las solicitudes estén formateadas correctamente y las respuestas sean las esperadas.
• Registro de errores: Implementa un registro de errores para capturar cualquier problema durante la transferencia de datos o los procesos de integración.

Probar con datos de muestra

• Enviar Eventos/Etiquetas de prueba: Crea y envía eventos y etiquetas de prueba desde Amplitude a Pushwoosh. Verifica que estas entradas de prueba aparezcan correctamente en Pushwoosh y activen los comportamientos esperados.
• Simular acciones de usuario: Realiza acciones en Amplitude que deberían activar eventos o actualizaciones específicas en Pushwoosh. Comprueba si estas acciones resultan en los cambios esperados en Pushwoosh.

Usar herramientas de monitorización

• Monitorización de la integración: Utiliza herramientas o servicios de monitorización que puedan rastrear la salud y el rendimiento de la integración. Estas herramientas pueden alertarte sobre problemas o fallos en tiempo real.
• Análisis e informes: Utiliza las funciones de análisis tanto en Amplitude como en Pushwoosh para revisar el flujo de datos y el rendimiento de la integración.

Revisar la documentación de la integración

• Revisión de la configuración: Vuelve a verificar la configuración de la integración tanto en Amplitude como en Pushwoosh para asegurarte de que todos los ajustes y mapeos se apliquen correctamente.
• Actualizaciones de la documentación: Mantente actualizado con cualquier cambio o actualización en la documentación de la integración que pueda afectar la funcionalidad.

Contactar con el soporte

Si encuentras problemas persistentes o inconsistencias, contacta a los equipos de soporte de Amplitude o Pushwoosh para obtener ayuda. Proporciónales detalles de la configuración de la integración y cualquier registro de errores para una resolución más rápida.

Resolución de problemas

Problemas de integración

• El evento no aparece en Pushwoosh: Asegúrate de que el evento esté mapeado correctamente y verifica que el código de la aplicación y el token de la API de Pushwoosh estén configurados correctamente.

• Las etiquetas no se sincronizan: Confirma que las etiquetas estén formateadas correctamente y que todos los detalles de autenticación necesarios estén incluidos en la solicitud.

Problemas de segmento

• Segmento no creado: Comprueba que la solicitud para crear el segmento esté formateada correctamente y que el token de la API de Pushwoosh sea válido.

• Usuarios no añadidos/eliminados: Verifica que los ID de usuario estén especificados correctamente y que el ID del segmento sea válido. Asegúrate de que la carga útil de la solicitud esté formateada correctamente.

Problemas de respuesta

• Sin cuerpo de respuesta: Si recibes una respuesta 200 OK pero sin cuerpo de respuesta, verifica que la solicitud se haya formateado correctamente y que los datos se hayan enviado correctamente.

Preguntas frecuentes

¿Qué debo hacer si recibo un error 400 Bad Request?

Revisa la carga útil de la solicitud en busca de errores de formato o campos faltantes. Asegúrate de que todos los campos obligatorios estén incluidos y formateados correctamente.

¿Cómo puedo verificar si la integración está funcionando?

Revisa el panel de control de Pushwoosh para ver eventos entrantes, etiquetas y actualizaciones de segmentos. También puedes supervisar los registros o las respuestas de los puntos finales de la API para transferencias de datos exitosas.

¿Puedo personalizar los eventos o etiquetas que se envían a Pushwoosh?

Sí, puedes personalizar eventos y etiquetas dentro de la configuración de Amplitude. Asegúrate de que los datos se ajusten al formato esperado de Pushwoosh.

¿Con qué frecuencia se sincronizan los datos entre Amplitude y Pushwoosh?

Los datos se sincronizan en tiempo real o casi en tiempo real según las solicitudes realizadas desde Amplitude. Asegúrate de que tu configuración admita la frecuencia de actualización deseada.

¿Dónde puedo encontrar más información o soporte para esta integración?

Consulta la documentación oficial de Amplitude y Pushwoosh. Para obtener más ayuda, contacta a los respectivos equipos de soporte.