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;
• Las fuentes de adquisición de usuarios como los valores de la Etiqueta Acquisition Source.

Casos de uso

Con estos datos, puede crear segmentos de usuarios y realizar 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 eficaces en Pushwoosh.

1. Cree campañas muy específicas en Pushwoosh utilizando los eventos rastreados por AppsFlyer.

Supongamos que tiene una aplicación de noticias. Ha configurado 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 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 en función 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 haya 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 con información sobre él. Por ejemplo, los 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ían los datos correctos a AppsFlyer, integre este fragmento de código en su código. Asegúrese de que se ejecuta 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 con prontitud. 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 Partners, localice y elija Pushwoosh.

4. Haga clic en Set up integration. A continuación, se le dirigirá 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á activado 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 recibe todos los datos, le recomendamos que desactive el Modo de Privacidad Avanzada en App Settings. Al hacerlo, no se 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:

• API Access Token. 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 API Access Token en esta guía.
• Application Code (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 Application Code y API Access Token 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
the mapped to partner event	Aunque este campo es obligatorio, no se preocupe por lo que escriba porque no cambiará el nombre de los eventos. Pushwoosh seguirá recibiendo los eventos con los mismos nombres que aparecen en AppsFlyer.
for users from	En este campo, seleccione si los postbacks se envían exclusivamente para los usuarios atribuidos a este partner o para todas las fuentes de medios, incluidas las orgánicas.
including	Elija cómo se comparten los datos de los eventos con Pushwoosh: No values & no revenue: Enviar solo el evento en sí sin ningún parámetro (valores o ingresos). Values & no revenue: Enviar todos los parámetros excepto el valor de los ingresos. Values & revenue: Enviar todos los parámetros del evento, incluido el valor de los ingresos (si existe en el evento). Para recibir eventos con atributos adicionales enviados a Pushwoosh, seleccione Values and Revenue.

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 se producen errores durante la configuración, por lo que una prueba rápida ayuda a evitar el desperdicio de recursos en campañas con datos incorrectos o ausentes.

Seguimiento de clics en correos electrónicos con AppsFlyer ESP 2.0

Para utilizar el seguimiento de clics en correos electrónicos y preservar los Universal Links / App Links al enviar correos electrónicos a través de Pushwoosh, puede configurar la integración de correo electrónico AppsFlyer ESP 2.0.