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 las propiedades del evento que se pueden exportar desde 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 del evento específicas de Braze se enviarán bajo la clave event_properties en los datos enviados a Amplitude.
Para utilizar 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 para 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 otra actividad 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 llevan el prefijo [Appboy], y todos los eventos personalizados llevan el prefijo [Appboy] [Custom Event]. Las propiedades de eventos personalizados y de eventos de compra llevan el prefijo [Custom event property] y [Purchase property], respectivamente.
Braze Currents aplica el prefijo [Appboy] al exportar eventos a Amplitude. La etiqueta hace referencia al nombre de producto heredado de Braze. Este es el comportamiento esperado y no indica un problema con el SDK o la integración.
Todas las cohortes nombradas e importadas en Braze llevará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 mostrará como [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 caducan, 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, ve 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 la 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 “Clave de API no válida” al pegar tu clave de API de Amplitude, intenta escribir la clave manualmente. Algunos navegadores pueden añadir caracteres ocultos al copiar y pegar que pueden provocar 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, puede 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 como se especifica 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 ver 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.