Integración con AppsFlyer

Se necesita ayuda del desarrollador

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

Resumen de la integración

AppsFlyer es una plataforma de atribución móvil y análisis de marketing que le ayuda a analizar la adquisición y el engagement de los usuarios. Proporciona datos completos sobre el comportamiento del usuario dentro de la aplicación y le permite rastrear las fuentes de adquisición de usuarios. Utilizando la información obtenida de AppsFlyer, puede crear campañas de marketing eficaces en Pushwoosh.

Una vez configurada la integración, AppsFlyer enviará la siguiente información a Pushwoosh:

• El comportamiento in-app del usuario como Eventos y sus atributos;
• Fuentes de adquisición de usuarios como valores de la Etiqueta Acquisition Source.

Casos de uso

Utilizando estos datos, puede construir segmentos de usuarios y crear campañas personalizadas y dirigidas con precisión en Pushwoosh. A continuación se presentan dos ejemplos de cómo aprovechar los datos de AppsFlyer para crear customer journeys efectivos en Pushwoosh.

1. Cree campañas altamente dirigidas en Pushwoosh utilizando eventos rastreados por AppsFlyer.

Supongamos que tiene una aplicación de noticias. Configuró AppsFlyer para rastrear el evento SubscribedToNews, que se activa cada vez que un usuario se suscribe a un canal de noticias. Este evento tiene el atributo de categoría que indica el tipo de noticias a las que el usuario se suscribe: politics, business o sports.

Pushwoosh recibe la información sobre este evento con los valores de sus atributos. Puede crear tres segmentos de usuarios basados en tres valores posibles:

Ahora puede crear campañas dirigidas a usuarios que están interesados en un tipo particular de noticias:

2. Personalice los mensajes basándose en los datos de comportamiento del usuario de AppsFlyer.

En este ejemplo, utilizaremos una aplicación de compras en línea. Supongamos que AppsFlyer rastrea el evento AddToWishlist que se activa cada vez que un usuario añade un artículo a su lista de deseos. Este evento tiene el atributo item que indica el nombre del artículo añadido a la lista de deseos.

AppsFlyer envía los datos del evento AddToWishlist a Pushwoosh, donde puede personalizar los mensajes dependiendo de las elecciones de los usuarios. Por ejemplo, puede crear un preset de push que ofrezca un descuento en un artículo que un usuario ha añadido a su lista de deseos. En lugar del nombre del artículo, añada un marcador de posición de Contenido Dinámico con el atributo item:

Si un usuario añade un artículo a su lista de deseos, recibirá un push que contiene información sobre él. Por ejemplo, aquellos que seleccionen el iPhone 14 Pro Max verán este mensaje:

Configuración de la integración

Nota

El proceso de integración es idéntico para las plataformas Android e iOS.

1. Integre el SDK de Pushwoosh en su aplicación si aún no lo ha hecho. Para obtener instrucciones más detalladas, lea la guía.

Precaución

Para un funcionamiento correcto, se requiere la versión 6.5.7 o posterior del SDK de Pushwoosh para iOS y la versión 6.6.16 o posterior del SDK de Pushwoosh para Android.

2. Para asegurarse de que se envíen los datos correctos a AppsFlyer, integre este fragmento de código en su código. Asegúrese de que se ejecute después de que se hayan inicializado tanto el SDK de Pushwoosh como el SDK de AppsFlyer.

Java

String pwhwid = Pushwoosh.getInstance().getHwid();
String pwuserid = Pushwoosh.getInstance().getUserId();
Map<String, Object> customData = new HashMap<String, Object>();
customData.put("pushwoosh_hwid", pwhwid);
customData.put("pushwoosh_user_id", pwuserid);
AppsFlyerLib.getInstance().setAdditionalData(customData);

Objective-C

NSString *pwhwid = [[Pushwoosh sharedInstance] getHWID];
NSString *pwuserid = [[Pushwoosh sharedInstance] getUserId];
NSDictionary *customData = [[NSDictionary alloc] initWithObjectsAndKeys:pwuserid, @"pushwoosh_user_id", pwhwid, @"pushwoosh_hwid", nil];
[[AppsFlyerLib shared] setAdditionalData:customData];

Peligro

Cuando utilice valores personalizados de UserID de Pushwoosh para identificar y dirigirse a los usuarios, asegúrese de ejecutar el código después de llamar al método setUserId() en el SDK de Pushwoosh con el valor personalizado.

Rastree cuándo cambia el UserID de Pushwoosh según la lógica de su aplicación móvil y envíe los valores actualizados a AppsFlyer de inmediato. Esto es importante para el mapeo correcto de los datos enviados con los usuarios en su base de datos de Pushwoosh.

3. Configure la integración de Pushwoosh en AppsFlyer. Para ello, en su cuenta de AppsFlyer, vaya a Collaborate > Partner Marketplace. En la lista de Socios, localice y elija Pushwoosh.

4. Haga clic en Set up integration. Luego será dirigido a la página de configuración de la integración. Allí, active el interruptor Activate partner.

Nota

Para las aplicaciones de iOS, el Modo de Privacidad Avanzada está habilitado por defecto, lo que permite controlar la disponibilidad de los datos de atribución a nivel de usuario a través de la plataforma AppsFlyer. Aunque AppsFlyer no envía este tipo de datos a Pushwoosh, mantener activado el interruptor de Privacidad Avanzada puede interferir con la transmisión de datos.

Para asegurarse de que Pushwoosh reciba todos los datos, recomendamos desactivar el Modo de Privacidad Avanzada en App Settings. Hacerlo no comprometerá la privacidad de los datos del usuario. Pushwoosh se dedica a gestionar los datos de forma segura y responsable, empleando protocolos de seguridad estándar de la industria para proteger la confidencialidad.

5. En la sección General settings, introduzca sus credenciales de Pushwoosh:

• Token de Acceso a la API. Para obtener el token, en su cuenta de Pushwoosh vaya a Settings > API Access y copie el código. Puede obtener más información sobre el Token de Acceso a la API en esta guía.
• Código de Aplicación (XXXXX-XXXXX) que puede encontrar debajo del nombre de su aplicación en su cuenta de Pushwoosh.

6. En la sección Default postback, seleccione All media sources, including organic.

7. En la sección In-app event settings, introduzca su Código de Aplicación y Token de Acceso a la API de Pushwoosh.

8. Active el interruptor In-app event postback y configure los eventos y datos que se incluirán en los postbacks enviados a Pushwoosh.

Elija uno o más eventos de AppsFlyer para enviar a Pushwoosh desde el menú desplegable y complete los parámetros necesarios.

Parámetro	Descripción
el evento mapeado al socio	Aunque este campo es obligatorio, no se preocupe por lo que escriba porque no cambiará cómo se nombran los eventos. Pushwoosh seguirá recibiendo los eventos con los mismos nombres que aparecen en AppsFlyer.
para usuarios de	En este campo, seleccione si los postbacks se envían exclusivamente para los usuarios atribuidos a este socio o para todas las fuentes de medios, incluidas las orgánicas.
incluyendo	Elija cómo se comparten los datos del evento con Pushwoosh: Sin valores y sin ingresos: Enviar solo el evento en sí sin ningún parámetro (valores o ingresos). Valores y sin ingresos: Enviar todos los parámetros excepto el valor de ingresos. Valores e ingresos: Enviar todos los parámetros del evento, incluido el valor de ingresos (si existe en el evento). Para recibir eventos con atributos adicionales enviados a Pushwoosh, seleccione Valores e Ingresos.

9. Una vez configurada la integración, haga clic en Save.

Nota

Antes de lanzar sus campañas, asegúrese de probar la integración. A menudo ocurren errores durante la configuración, por lo que una prueba rápida ayuda a evitar el desperdicio de recursos en campañas con datos faltantes o incorrectos.