Integración con Amplitude

Se necesita ayuda de un desarrollador

Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Comparta esta guía con ellos.

Amplitude, una robusta plataforma de análisis de productos, permite a las empresas comprender el comportamiento del usuario en tiempo real, rastrear las interacciones dentro del producto y obtener información valiosa sobre la participación, retención e ingresos del usuario.

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

Resumen de la integración

Tipo de integración

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

Prerrequisitos

Para configurar la integración de Transmisión de Eventos (Event Streaming) y Sincronización de Cohortes (Cohort Sync) desde Amplitude a Pushwoosh, asegúrese de que se cumplan los siguientes prerrequisitos:

• Necesita una cuenta activa de Pushwoosh.
• Genere un Token de Acceso a la API en Pushwoosh para enviar datos.
• Localice su 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.
• Debe tener un plan de pago de Pushwoosh para usar esta integración.

Glosario (mapeo de nombres de entidades si son diferentes)

Cohorts en Amplitude = Segments 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 del usuario. Aquí hay un desglose detallado de 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 están asociadas con los perfiles de usuario. Estas etiquetas se envían con un ID de usuario (external_id), un código de aplicación (app_id) y propiedades de la 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 basándose en las interacciones o atributos del usuario rastreados en Amplitude. Los eventos y 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 específicos.

Casos de uso

Seguimiento de eventos

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

Etiquetado de usuarios

Asigne 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

Cree y gestione segmentos de usuarios en Pushwoosh basándose 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ñada o elimine automáticamente usuarios de segmentos en función de sus acciones o atributos en Amplitude, asegurando una segmentación actualizada en Pushwoosh.

Configuración de la integración

Sincronización de cohortes (Cohort sync)

Configuración de Pushwoosh

1. En Pushwoosh, navegue a Settings > Integrations.

2. Haga clic en Add Integration, luego busque y añada Amplitude.

   

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

Configuración de Amplitude

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

1. En sus Datos de Amplitude, vaya al Catálogo y seleccione Destinos.
2. Bajo la sección Cohorte, localice y haga clic en Pushwoosh.

3. Haga clic en Add another destination.

4. Proporcione un nombre y pegue la clave de API que copió de Pushwoosh.

5. Mapee el campo de ID de Usuario de Amplitude al campo de ID de Usuario de Pushwoosh.
6. Guarde su configuración cuando haya terminado.

Envío de una cohorte

Para sincronizar su primera cohorte, complete los siguientes pasos:

1. En Amplitude, abra la cohorte que desea sincronizar, luego haga clic en Sync.

2. Elija Pushwoosh y seleccione la cuenta con la que desea sincronizar. Luego, haga clic en Next.

3. Decida la cadencia de sincronización y guarde sus configuraciones.

Transmisión de eventos (Event streaming)

Configuración de Pushwoosh

1. Obtenga su Clave de API de Pushwoosh

2. Localice el Código de Aplicación en su cuenta de Pushwoosh.

Configuración de Amplitude

1. En Amplitude, vaya a Data Destinations y busque Pushwoosh - Event Stream.

2. Introduzca un nombre de sincronización y luego haga clic en Create Sync.

3. Cambie el Estado de Disabled a Enabled y pegue su Token de Acceso a la API de Pushwoosh y el Código de Aplicación.

4. Desde el menú desplegable izquierdo, seleccione la propiedad de usuario de Amplitude que corresponde a su UserID de Pushwoosh.
5. (Opcional) Habilite el conmutador Create & Update users si desea enviar usuarios y sus propiedades en tiempo real cada vez que Amplitude crea o actualiza una propiedad de usuario.

6. Habilite Send Events (“Events are sent to Pushwoosh”) si desea 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 en un horario o bajo demanda utilizando esta integración.

8. Luego, elija qué eventos desea enviar en la sección Select and Filter Events. Solo seleccione los eventos que necesita en Pushwoosh; los eventos transformados no son compatibles.
9. Una vez hecho, habilite el destino y haga clic en Save.

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

Para verificar que la integración de Amplitude y Pushwoosh está funcionando correctamente, puede utilizar los siguientes métodos:

Monitorear el panel de Pushwoosh

• Eventos y Etiquetas: Verifique el panel de Pushwoosh para ver si los eventos y etiquetas enviados desde Amplitude aparecen como se esperaba. Busque actividades recientes o actualizaciones relacionadas con sus eventos y etiquetas.
• Segmentos: Verifique que los segmentos se están creando, actualizando o modificando según los datos de Amplitude. Asegúrese 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úrese 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: Revise cualquier respuesta de error o códigos de estado distintos de 200 OK para obtener pistas si algo no está funcionando. Los errores comunes pueden incluir 400 Bad Request, 401 Unauthorized o 500 Internal Server Error.

Registrar solicitudes y respuestas

• Registros de solicitudes: Mantenga registros de las solicitudes salientes de Amplitude y las respuestas entrantes de Pushwoosh. Verifique estos registros para asegurarse de que las solicitudes estén formateadas correctamente y que las respuestas sean las esperadas.
• Registro de errores: Implemente el 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: Cree y envíe eventos y etiquetas de prueba desde Amplitude a Pushwoosh. Verifique que estas entradas de prueba aparezcan correctamente en Pushwoosh y activen los comportamientos esperados.
• Simular acciones de usuario: Realice acciones en Amplitude que deberían activar eventos o actualizaciones específicas en Pushwoosh. Verifique si estas acciones resultan en los cambios esperados en Pushwoosh.

Usar herramientas de monitoreo

• Monitoreo de la integración: Utilice herramientas o servicios de monitoreo que puedan rastrear la salud y el rendimiento de la integración. Estas herramientas pueden alertarle sobre problemas o fallos en tiempo real.
• Análisis e informes: Utilice las funciones de análisis en Amplitude y 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: Verifique dos veces la configuración de la integración tanto en Amplitude como en Pushwoosh para asegurarse de que todas las configuraciones y mapeos se apliquen correctamente.
• Actualizaciones de la documentación: Manténgase actualizado con cualquier cambio o actualización en la documentación de la integración que pueda afectar la funcionalidad.

Contactar a soporte

Si encuentra problemas persistentes o inconsistencias, póngase en contacto con los equipos de soporte de Amplitude o Pushwoosh para obtener ayuda. Proporcióneles detalles de la configuración de la integración y cualquier registro de errores para una resolución más rápida.

Solución de problemas

Problemas de integración

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

• Las etiquetas no se sincronizan: Confirme 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: Verifique 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: Verifique que los ID de usuario estén correctamente especificados y que el ID del segmento sea válido. Asegúrese de que la carga útil de la solicitud esté formateada correctamente.

Problemas de respuesta

• Sin cuerpo de respuesta: Si recibe una respuesta 200 OK pero no hay cuerpo de respuesta, verifique que la solicitud se haya formateado correctamente y que los datos se hayan enviado correctamente.

Preguntas frecuentes (FAQ)

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

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

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

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

¿Puedo personalizar los eventos o etiquetas enviados a Pushwoosh?

Sí, puede personalizar eventos y etiquetas dentro de la configuración de Amplitude. Asegúrese de que los datos se adhieran 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úrese de que su configuración admita la frecuencia de actualización deseada.

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

Consulte la documentación oficial de Amplitude y Pushwoosh. Para obtener más ayuda, póngase en contacto con los respectivos equipos de soporte.