Kochava
Kochava ofrece atribución y análisis móviles para ayudarte a aprovechar tus datos para crecer. La plataforma de audiencia de Kochava te permite planificar, direccionar, activar, medir y optimizar tus campañas de aplicaciones.
Esta integración está mantenida por Kochava.
Acerca de la integración
La integración de Braze y Kochava ayuda a potenciar una comprensión más integral de tus campañas enviando datos de atribución a Braze para entender mejor qué campañas están impulsando instalaciones, actividad dentro de la aplicación y más.
Requisitos previos
| Requisito | Descripción |
|---|---|
| SDK de Braze | El SDK móvil de Braze es necesario para esta integración. Braze vincula los postbacks de atribución de Kochava con los perfiles de usuario utilizando identificadores de dispositivo que el SDK de Braze crea y registra. Exportar valores de device_id desde Braze y pasarlos a Kochava sin conexión no es un sustituto compatible para integrar el SDK de Braze. |
| Cuenta de Kochava | Se requiere una cuenta de Kochava para aprovechar esta integración. |
| Aplicación iOS o Android | Esta integración es compatible con aplicaciones iOS y Android. Dependiendo de tu plataforma, es posible que se necesiten fragmentos de código en tu aplicación. Los detalles sobre estos requisitos se encuentran en el paso 1 del proceso de integración. |
| SDK de Kochava | Además del SDK de Braze, debes instalar el SDK de Kochava. |
Integración
Paso 1: Mapear los ID de usuario
Este paso requiere el SDK de Braze en tu aplicación. Dependiendo de tu plataforma, tu aplicación puede necesitar pasar el identificador de dispositivo de Braze (device_id) del SDK de Braze a Kochava para que, cuando Kochava envíe datos de atribución de vuelta a Braze, Braze pueda hacer coincidir esos datos con el perfil de usuario correcto. Consulta las secciones de Android e iOS para saber cuándo se requiere el mapeado.
Android
El SDK de Braze genera un identificador de dispositivo (device_id). Tu aplicación debe recuperar este identificador y pasarlo al método IdentityLink de Kochava. Esto permite que Kochava incluya el device_id en los datos de atribución que envía de vuelta a Braze, para que Braze pueda hacer coincidir los eventos de atribución con el perfil de usuario correcto.
Recupera el device_id de Braze con el siguiente método:
Braze.getInstance(context).getDeviceId();
iOS
Antes de febrero de 2023, nuestra integración de atribución con Kochava utilizaba el identificador para proveedores (IDFV) como identificador principal para hacer coincidir los datos de atribución de iOS. Los clientes de Braze que usan Objective-C no necesitan obtener el device_id de Braze y enviarlo a Kochava en la instalación, ya que no hay interrupción del servicio.
A partir de Swift SDK v5.7.0, puedes configurar si Braze utiliza IDFV o un UUID generado aleatoriamente como ID de dispositivo. En Swift SDK v7.0.0+, useUUIDAsDeviceId tiene como valor predeterminado true, por lo que los nuevos usuarios obtienen un device_id UUID a menos que establezcas este campo en false. Para obtener más información, consulta Recopilar IDFV.
- Para mantener IDFV como el identificador mutuo con Kochava, establece
useUUIDAsDeviceIdenfalse. - Si
useUUIDAsDeviceIdestrue(el valor predeterminado en v7.0.0+), pasa eldevice_idde Braze a Kochava en la instalación de la aplicación para que Braze pueda hacer coincidir las atribuciones de iOS.
Utiliza una de las siguientes API no bloqueantes para recuperar el device_id de Braze, luego pasa ese valor a Kochava según las instrucciones del SDK de iOS de Kochava. Para obtener ayuda adicional, contacta con el soporte de Kochava.
Controlador de finalización
AppDelegate.braze?.getDeviceId { deviceId in
// Pass `deviceId` to Kochava
}
Concurrencia de Swift
let deviceId = await AppDelegate.braze?.getDeviceId()
Paso 2: Obtener la clave de importación de datos de Braze
En Braze, ve a Integraciones de partners > Partners tecnológicos y selecciona Kochava.
Aquí puedes encontrar el endpoint REST y generar tu clave de importación de datos de Braze. Una vez generada la clave, puedes crear una nueva o invalidar una existente. La clave de importación de datos y el endpoint REST se utilizan en el siguiente paso al configurar un postback en el panel de Kochava.
Paso 3: Configurar un postback desde Kochava
Añade un postback en tu panel de Kochava. Se te solicita la clave de importación de datos y el endpoint REST que encontraste en el panel de Braze.
Paso 4: Confirmar la integración
En la página de partners tecnológicos de Kochava en Braze, el indicador de conexión muestra No conectado hasta que generes una clave de API de importación de datos en el paso 2. Una vez que generas la clave, el indicador cambia a Conectado y muestra una marca de tiempo. Esa marca de tiempo refleja cuándo se configuró por primera vez la integración en Braze (cuando se creó la clave de importación de datos), no cuándo Kochava envió un postback por última vez.
Para confirmar que los datos de atribución de instalación fluyen desde Kochava, comprueba que los datos de instalaciones no orgánicas aparecen en los filtros de Segment de Braze. Braze ignora las instalaciones orgánicas de los postbacks de Kochava cuando la fuente de atribución es organic y no las almacena como datos de instalación atribuida.
Datos de atribución de Facebook y X (anteriormente Twitter)
Los datos de atribución de las campañas de Facebook y X (anteriormente Twitter) no están disponibles a través de nuestros partners. Estas fuentes de medios no permiten que sus partners compartan datos de atribución con terceros y, por lo tanto, nuestros partners no pueden enviar esos datos a Braze.
URL de seguimiento de clics de Kochava en Braze (opcional)
Los enlaces de seguimiento de clics en tus Campaigns de Braze te permiten ver qué Campaigns están impulsando las instalaciones de aplicaciones y la reactivación. Como resultado, puedes medir tus esfuerzos de marketing de manera más eficaz y tomar decisiones basadas en datos sobre dónde invertir más recursos para obtener el máximo ROI.
Para empezar con los enlaces de seguimiento de clics de Kochava, visita su documentación. Puedes insertar los enlaces de seguimiento de clics de Kochava en tus Campaigns de Braze directamente. Kochava usa entonces sus metodologías de atribución probabilística para atribuir al usuario que hizo clic en el enlace. Recomendamos agregar un identificador de dispositivo a tus enlaces de seguimiento de Kochava para mejorar la precisión de las atribuciones de tus Campaigns de Braze. Esto atribuye de manera determinista al usuario que hizo clic en el enlace.
Para Android, Braze permite a los clientes optar por la recopilación del ID de publicidad de Google (GAID). El GAID también se recopila de forma nativa a través de la integración del SDK de Kochava. Puedes incluir el GAID en tus enlaces de seguimiento de clics de Kochava utilizando la siguiente lógica Liquid:
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}
Para iOS, agrega el identificador de dispositivo de Braze para mejorar la atribución determinista. En Liquid, most_recently_used_device.${id} es el ID de dispositivo de Braze, que puede ser el IDFV o un UUID dependiendo de tu configuración useUUIDAsDeviceId del SDK SWIFT. Las URL de seguimiento de clics de Kochava suelen usar un parámetro de consulta idfv para este valor:
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}
Esta recomendación es puramente opcional
Si actualmente no utilizas ningún identificador de dispositivo, como el ID de dispositivo de Braze o el GAID, en tus enlaces de seguimiento de clics, o no planeas hacerlo en el futuro, Kochava aún puede atribuir estos clics a través de su modelado probabilístico.