Amplitude para Currents
Amplitude es una plataforma de análisis de productos e inteligencia empresarial.
La integración bidireccional de Braze y Amplitude te permite sincronizar tus cohortes de Amplitude, rasgos de usuario y eventos en Braze, así como aprovechar Braze Currents para exportar tus eventos de Braze a Amplitude y realizar análisis más profundos de tus datos de producto y marketing.
Requisitos previos
| Requisito | Descripción |
|---|---|
| Cuenta de Amplitude | Se requiere una cuenta de Amplitude para aprovechar esta integración. |
| Currents | Para exportar datos de vuelta a Amplitude, necesitas tener Braze Currents configurado para tu cuenta. |
Integración de exportación de datos
Puedes encontrar una lista completa de los eventos y propiedades de eventos que se pueden exportar de Braze a Amplitude en las siguientes secciones. Todos los eventos enviados a Amplitude incluirán el external_user_id del usuario como el ID de usuario de Amplitude. Las propiedades de eventos específicas de Braze se enviarán bajo la clave event_properties en los datos enviados a Amplitude.
Para usar esta característica, tu ID de usuario de Amplitude debe coincidir con el ID externo de Braze.
Braze solo enviará datos de eventos para usuarios que tengan su external_user_id configurado o usuarios anónimos que tengan su device_id configurado. Para los usuarios anónimos, necesitarás sincronizar tu ID de dispositivo de Amplitude con el ID de dispositivo de Braze en el SDK. Por ejemplo:
1
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Puedes exportar dos tipos de eventos a Amplitude: Eventos de participación en mensajes, que consisten en los eventos de Braze directamente relacionados con el envío de mensajes, y Eventos de comportamiento del cliente, que incluyen otras actividades de la aplicación o el sitio web, como sesiones, eventos personalizados y compras rastreadas a través de la plataforma. Todos los eventos regulares tienen el prefijo [Appboy], y todos los eventos personalizados tienen el prefijo [Appboy] [Custom Event]. Las propiedades de eventos personalizados y de eventos de compra tienen el prefijo [Custom event property] y [Purchase property], respectivamente.
Todas las cohortes nombradas e importadas a Braze tendrán el prefijo [Amplitude] y el sufijo de su cohort_id. Esto significa que una cohorte llamada “TEST_COHORT” con el cohort_id “abcd1234” se titulará [Amplitude] TEST_COHORT: abcd1234 en los filtros de Braze.
Contacta a tu director de cuentas o abre un ticket de soporte si necesitas acceso a derechos de eventos adicionales.
Paso 1: Configurar la integración de Amplitude en Braze
En Amplitude, localiza tu clave de API de exportación de Amplitude.
Mantén tu clave de API de Amplitude actualizada. Si las credenciales de tu conector expiran, el conector dejará de enviar eventos. Si esto persiste durante más de 48 horas, los eventos del conector se descartarán y los datos se perderán permanentemente.
Paso 2: Crear un Braze Current
En Braze, navega a Currents > + Create Current > Create Amplitude Export. Proporciona un nombre de integración, correo electrónico de contacto, clave de API de exportación de Amplitude y región de Amplitude en los campos indicados. A continuación, selecciona los eventos que deseas rastrear; se proporciona una lista de eventos disponibles. Por último, haz clic en Launch Current.
Los eventos enviados desde Braze Currents a Amplitude contarán para tu cuota de volumen de eventos de Amplitude.
Si recibes un error de “Invalid API key” al pegar tu clave de API de Amplitude, intenta escribir la clave manualmente. Algunos navegadores pueden agregar caracteres ocultos al copiar y pegar, lo que puede causar errores de validación.
Para más información, consulta la integración de Appboy con Amplitude de Amplitude.
Límites de velocidad
Currents se conecta a la API HTTP de Amplitude, que tiene un límite de velocidad de 30 eventos/segundo por dispositivo y un límite no documentado de 500K eventos/día por dispositivo. Si se superan estos umbrales, Amplitude limitará los eventos registrados a través de Currents. Si un dispositivo en tu integración supera este límite de velocidad, es posible que experimentes un retraso en la aparición de los eventos de todos los dispositivos en Amplitude.
Los dispositivos no deberían reportar más de 30 eventos/segundo o 500K eventos/día en circunstancias normales, y este patrón de eventos solo debería ocurrir debido a una integración mal configurada. Para evitar este tipo de retraso, asegúrate de que tu integración de SDK reporte eventos a una tasa normal según lo especificado en nuestras instrucciones de integración de SDK y evita ejecutar pruebas automatizadas que generen muchos eventos para un solo dispositivo.
Eventos de Currents compatibles
Braze permite exportar los siguientes eventos a Amplitude:
Para consultar la estructura de la carga útil de cada evento, selecciona la pestaña Amplitude en el glosario de eventos de participación en mensajes y en el glosario de eventos de comportamiento del cliente.