AppsFlyer

AppsFlyer es una plataforma de análisis y atribución de marketing móvil que te ayuda a analizar y optimizar tus aplicaciones mediante análisis de marketing, atribución móvil y vinculación en profundidad.

La integración de Braze y AppsFlyer te permite comprender mejor cómo optimizar y crear campañas más holísticas aprovechando los datos de atribución de instalaciones móviles de AppsFlyer.

También puedes pasar tus audiencias (cohortes) de AppsFlyer directamente a Braze con la integración AppsFlyer Audiences, lo que te permite crear potentes campañas de interacción con los clientes dirigidas a los usuarios adecuados en el momento oportuno.

Requisitos previos

Integración

Paso 1: Mapear ID de dispositivo

• android
• ios
• unity

Si tienes una aplicación Android, debes pasar un ID de dispositivo Braze único a AppsFlyer.

Asegúrate de que las siguientes líneas de código se insertan en el lugar correcto: después de iniciar el SDK de Braze y antes del código de inicialización del SDK de AppsFlyer. Consulta la guía de integración del SDK de Android de AppsFlyer para obtener más información.

1
2
3
4
5
val customData = HashMap<String, Any>()
Braze.getInstance(context).getDeviceIdAsync { deviceId ->
   customData["brazeCustomerId"] = deviceId
   setAdditionalData(customData)
}

Importante

Antes de febrero de 2023, nuestra integración de atribución de AppsFlyer utilizaba el Identificador de Vendedor (IDFV) como identificador principal para cotejar los datos de atribución de iOS. No es necesario que los clientes de Braze que utilicen Objective-C obtengan el device_id de Braze y lo envíen a AppsFlyer en la instalación, porque no se interrumpe el servicio.

Para los que utilicen el SDK Swift v5.7.0+, si quieres seguir utilizando IDFV como identificador mutuo, debes confirmar que el campo useUUIDAsDeviceId está configurado en false para evitar una interrupción de la integración.

Si se establece en true, debes implementar el mapeado de ID de dispositivo iOS para Swift con el fin de pasar el device_id de Braze a AppsFlyer en la instalación de la aplicación para que Braze coincida adecuadamente con las atribuciones de iOS.

• swift
• objective-c

1
2
3
4
5
6
let configuration = Braze.Configuration(
    apiKey: "<BRAZE_API_KEY>",
    endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
AppsFlyerLib.shared().customData = ["brazeDeviceId": braze.deviceId]

1
2
3
4
5
6
BRZConfiguration *configurations = [[BRZConfiguration alloc] initWithApiKey:@"BRAZE_API_KEY" endpoint:@"BRAZE_END_POINT"];
[configurations setUseUUIDAsDeviceId:NO];
Braze *braze = [[Braze alloc] initWithConfiguration:configurations];
[[AppsFlyerLib shared] setAdditionalData:@{
    @"brazeDeviceId": braze.deviceId
}];

Para mapear el ID del dispositivo en Unity, utiliza lo siguiente:

1
2
3
4
Appboy.AppboyBinding.getDeviceId()
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("brazeCustomerId", Appboy.AppboyBinding.getDeviceId());
AppsFlyer.setAdditionalData(customData);

Paso 2: Obtener la clave de importación de datos de Braze

En Braze, ve a Integraciones de socios > Socios tecnológicos y selecciona AppsFlyer.

Aquí encontrarás el punto de conexión REST y generarás 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 punto de conexión REST se utilizan en el siguiente paso cuando se configura un postback en el dashboard de AppsFlyer.

Paso 3: Configurar Braze en el dashboard de AppsFlyer

1. En AppsFlyer, ve a la página de Integrated Partners en la barra de la izquierda. A continuación, busca Braze y selecciona el logotipo de Braze para abrir una ventana de configuración.
2. Dentro de la pestaña Integration, activa Activate Partner.
3. Proporciona la clave de importación de datos y el punto de conexión REST que encontraste en el dashboard de Braze.
4. Desactiva Advanced Privacy y guarda la configuración.

Importante

Al introducir el punto de conexión REST de Braze en la pestaña de integración de AppsFlyer, introduce solo el dominio (por ejemplo, rest.fra-02.braze.eu) sin el protocolo https:// y sin la ruta /attribution/appsflyer. AppsFlyer antepone automáticamente el protocolo y añade la ruta. Incluir cualquiera de los dos en tu entrada provoca fallos en el postback.

Encontrarás información adicional sobre estas instrucciones en la documentación de AppsFlyer.

Paso 4: Confirmar la integración

En la página de socios tecnológicos de AppsFlyer en Braze, el indicador de conexión muestra Not Connected hasta que generes una clave de API de importación de datos en el paso 2. Después de generar la clave, el indicador cambia a Connected y muestra una marca de tiempo. Esa marca de tiempo refleja cuándo se configuró la integración por primera vez en Braze (cuando se creó la clave de importación de datos), no cuándo AppsFlyer envió un postback por última vez.

Para confirmar que los datos de atribución de instalación están fluyendo desde AppsFlyer, utiliza el paso 5 para verificar que los datos de instalación no orgánica aparecen en los filtros de segmento de Braze. Braze ignora las instalaciones orgánicas de los postbacks de AppsFlyer y no las almacena como datos de instalación atribuida.

Paso 5: Visualización de los datos de atribución de los usuarios

Campos de datos disponibles

Si la integración se ha realizado correctamente, Braze mapea todos los datos de instalación no orgánicos en filtros de segmento.

Puedes segmentar tu base de usuarios por datos de atribución en el dashboard de Braze utilizando los filtros de atribución de instalación.

Además, los datos de atribución de un usuario concreto están disponibles en el perfil de cada usuario en el dashboard de Braze.

Nota

Los datos de atribución de las campañas de Facebook y X (antes Twitter) no están disponibles a través de nuestros socios. Estas fuentes de medios no permiten a sus socios compartir datos de atribución con terceros y, por lo tanto, nuestros socios no pueden enviar esos datos a Braze.

Integrar AppsFlyer con Braze para vinculación en profundidad

Los vínculos profundos—enlaces que dirigen a los usuarios a una página o lugar específicos dentro de una aplicación o sitio web—se utilizan para crear una experiencia de usuario personalizada.

Aunque su uso está muy extendido, pueden surgir problemas al utilizar vínculos profundos por correo electrónico con seguimiento de clics—otra característica importante utilizada en la recopilación de datos de usuario. Estos problemas se deben a que los proveedores de servicios de correo electrónico (ESP) envuelven los vínculos profundos en un dominio de registro de clics, rompiendo el vínculo original. Por lo tanto, la compatibilidad con los vínculos profundos requiere una configuración adicional.

AppsFlyer proporciona un servicio que evita estos problemas, habilitando a AppsFlyer para que actúe como intermediario entre el servidor ESP y tu dominio. Su papel como proxy habilita la provisión de archivos de asociación (AASA/vínculos de activos), lo que facilita la vinculación en profundidad.

Paso 1: Crear un dominio de seguimiento de clics

Siguiendo los elementos iniciales de la guía de configuración de correo electrónico de Braze, crea un dominio de envío de correo electrónico y un dominio de seguimiento de clics. Para obtener asistencia, puedes crear un ticket a través del dashboard de Braze para iniciar la configuración del nuevo CTD con el equipo de correo electrónico de Braze.

Es obligatorio crear un nuevo CTD, aunque ya utilices uno existente. Esto garantiza que no haya ningún impacto en el tráfico de las campañas de correo electrónico en vivo actuales.

Importante

AppsFlyer crea el certificado SSL. En esta fase, es probable que los enlaces de correo electrónico no sean seguros, es decir, que el prefijo de la URL sea HTTP en lugar de HTTPS. Esto se resuelve en pasos posteriores.

Paso 2: Crear una plantilla OneLink en AppsFlyer

Crea una plantilla OneLink y configura Universal Links/App Links en “When app is installed”. Esta plantilla se utiliza posteriormente para crear enlaces OneLink para tus campañas de correo electrónico.

Nota

Si ya tienes configurada una plantilla OneLink que habilita Universal Links/App Links, puedes utilizarla.

Paso 3: Configura tu integración de Braze en AppsFlyer

Ahora es el momento de configurar tu integración de Braze en AppsFlyer. Este paso y el siguiente (“Configura tu aplicación”) pueden configurarse al mismo tiempo. Para configurar tu integración de Braze en AppsFlyer:

1. En AppsFlyer, en el menú lateral, selecciona Engage > ESP integration. {#1-in-appsflyer-from-the-side-menu-select-engage-esp-integration}

2. Selecciona Braze. {#2-select-braze}

3. Selecciona la plantilla OneLink que deseas utilizar para las campañas de correo electrónico y, a continuación, haz clic en Next. {#3-select-the-onelink-template-you-want-to-use-for-email-campaigns-then-click-next}

4. Introduce tu dominio de seguimiento de clics y el valor “Braze endpoint”, que se proporcionó con el nuevo CTD creado en el paso 1, y luego haz clic en Validate connection. {#4-enter-your-click-tracking-domain-and-braze-endpoint-value-which-was-provided-with-the-new-ctd-created-in-step-1-then-click-validate-connection}

Esto valida que el dominio de seguimiento de clics apunta al punto de conexión que has introducido.

Con “Braze Endpoint”, AppsFlyer está pidiendo los detalles proporcionados por Braze en el paso 1 de esta guía, concretamente el nuevo CTD.

A continuación, haz clic en Validate connection, que valida que el dominio de seguimiento de clics apunta al punto de conexión que has introducido. Cuando hayas terminado, haz clic en Next.

5. Enruta el tráfico de enlaces a AppsFlyer: {#5-route-link-traffic-to-appsflyer}

a. Copia y envía las instrucciones personalizadas prefabricadas en AppsFlyer a tu administrador de TI o de dominio.

Tu administrador debe redirigir el tráfico de tu campaña de correo electrónico desde los servidores ESP a los servidores de AppsFlyer actualizando tus registros de DNS CNAME con el nuevo dominio que AppsFlyer te ha proporcionado.

Como resultado, cada vez que se hace clic en un enlace, el clic se redirige a AppsFlyer, que a su vez lo redirige al punto de conexión ESP.

b. Después de copiar y enviar las instrucciones, haz clic en Done.

Se ha creado tu integración de Braze.

Importante

El estado de tu integración de Braze es pendiente y solo empezará a funcionar una vez mapeado el registro CNAME. Una nueva integración puede tardar hasta 24 horas después de ser mapeada en empezar a funcionar y activarse.

Paso 4: Configura tu aplicación (tarea del desarrollador)

AppsFlyer ofrece orientación sobre la correcta configuración de la aplicación, que deben seguir tus equipos web o de aplicaciones para soportar el enlace universal.

Paso 5: Confirma que el seguimiento de clics SSL está habilitado con Braze

En esta fase, después de compartir y validar los detalles del CTD en AppsFlyer, te recomendamos que realices un envío de prueba para confirmar si tu dominio de envío OneLink tiene un certificado SSL. Esto se ajusta a nuestra guía de configuración del correo electrónico.

Puedes realizar la garantía de calidad y la solución de problemas enviando un vínculo profundo mediante OneLink. Consulta la documentación de AppsFlyer para más detalles sobre el uso de OneLink.

Si los enlaces CTD se identifican como HTTP, ponte en contacto con el equipo de operaciones de correo electrónico de Braze para habilitar el seguimiento de clics SSL. Esto garantiza que todos los enlaces HTTP se conviertan automáticamente a HTTPS. Puedes utilizar el siguiente ejemplo de texto de mensaje cuando te pongas en contacto con tu administrador del éxito del cliente, o volviendo a crear un ticket en el dashboard de Braze, como en el paso 1:

1
2
Hi Team,
Could you please enable SSL click tracking for CTD XXX? It is currently set to HTTP instead of HTTPS.

URL de seguimiento de clics de AppsFlyer en Braze (opcional)

Puedes utilizar los enlaces de atribución OneLink de AppsFlyer en Campaigns de Braze a través de push, correo electrónico y más. Esto te permite enviar datos de atribución de instalación o reactivación de la interacción de tus Campaigns de Braze a AppsFlyer. Como resultado, podrás medir tus esfuerzos de marketing con mayor eficacia y tomar decisiones basadas en datos.

Puedes simplemente crear tu URL de seguimiento OneLink en AppsFlyer e insertarla directamente en tus Campaigns de Braze. AppsFlyer utiliza entonces sus metodologías de atribución probabilística para atribuir al usuario que ha hecho clic en el enlace. Te recomendamos que añadas a tus enlaces de seguimiento de AppsFlyer un identificador de dispositivo para mejorar la precisión de las atribuciones de tus Campaigns de Braze. Esto atribuye de forma determinista al usuario que ha hecho clic en el enlace.

• android
• ios

1
2
3
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}