Integración de Oracle Responsys con AppsFlyer

Los ESP (proveedores de servicios de correo electrónico) pueden ser excelentes fuentes para el tráfico segmentado de usuarios.

Uno de los desafíos con los ESP es realizar una atribución y unos enlaces profundos correctos. Los ESP envuelven la URL del enlace profundo con el dominio de registro de clics de su propio ESP. Este procedimiento a menudo rompe la funcionalidad de los enlaces universales de iOS y los enlaces de aplicaciones de Android. 

Sin embargo, los enlaces profundos y el registro de clics siguen siendo posibles con los ESP que admiten enlaces universales y enlaces de aplicaciones además de su dominio de grabación de clics. Además, puedes configurar tu propio dominio de clic para que actúe como dominio de registro de clics.

Requisitos previos

• Configura tu aplicación para admitir enlaces profundos con OneLink.
• Verifica la versión de tu SDK (tanto Android como iOS).

Configuración del dominio de clic de Oracle Responsys

Sigue esta sección para configurar tu dominio de clic (dominio de registro del clic) en Oracle Responsys.

Paso 1: Configura un dominio de clic en Oracle Responsys

Para configurar un dominio de clic, sigue la guía oficial de Oracle Responsys sobre cómo crear dominios de clic. Oracle Responsys utiliza tablas de enlaces para ayudar a registrar clics para una campaña específica.

Ten en cuenta que, en las tablas de enlaces, puedes definir la URL de enlace IOS para que sea la misma que la URL de enlace:

Una vez que estableces los dominios de clic en las Tablas de enlaces, Responsys utiliza estos dominios para envolver los OneLinks que incluyas en las campañas de correo electrónico. De esta manera, Responsys puede registrar clics en su sistema mientras conserva los OneLinks y la funcionalidad de enlaces profundos.

Paso 2: Proporciona a Responsys un archivo AASA (iOS) y un archivo Asset Links (Android)

Configuración de tu aplicación

<activity android:name=".DeepLinkActivity">
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="https"
               android:host="click.example.com"
               android:pathPrefix="/campaign" />
     </intent-filter>
</activity>

Paso 2: Configurar la aplicación para resolver dominios de clic

El SDK necesita resolver el OneLink detrás del dominio de clic para obtener los detalles de la campaña. Los detalles se devuelven en el método onAppOpenAttribution.

Para resolver dominios de clic:

1. Asegúrate de que la versión de tu SDK sea al menos 4.9.0.
2. Enumera los dominios de clic en la propiedad del SDK resolveDeepLinkURLs. Esta propiedad debe establecerse antes de la inicialización del SDK. Para obtener más información, consulta la documentación del SDK aquí.
   
   Objective-C Swift

   [AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

   AppsFlyerTracker.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
   

   • Importante: Si estás utilizando Movable Ink (MI) junto con Oracle, necesitas obtener el MI CNAME y los dominios internos de tu administrador de cuenta MI y agregarlos a setResolveDeepLinkURLs, además del enlace de clic para Oracle. Ejemplos de dominios:
     • Dominio de Oracle: oracle-click.example.com
     • Dominio MI CNAME: mi.example.com
     • Dominio interno de MI: ejemplo.micpn.com
3. Agrega el siguiente código para que el SDK pueda resolver el dominio de registro de clics:
   
   Objective-C Swift

   Agrega este código en AppDelegate.m

   - (NSDictionary *)allHTTPHeaderFieldsForResolveDeepLinkURL:(NSURL *)URL {
       if ([URL.host  isEqual: @"click.example.com"]) {
           return [NSDictionary dictionary];
       }
       else {
           return nil;
       }
   }

   Agrega este código en AppDelgate.swift

   func allHTTPHeaderFields(forResolveDeepLinkURL URL: URL!) -> [String : String]! {
       if (URL.host == "click.example.com") {
           /// Change User-Agent
           return [:]
       } else {
           return nil;
       }
   }
   

Envío de tu primer correo electrónico

1. Crea una URL de OneLink en la página de Gestión de enlaces (o manualmente).
2. Al crear la URL de OneLink, asegúrate de codificar por URL todos los valores de los parámetros.
3. Los siguientes parámetros son muy recomendables para usar:
   • pid (media source): utiliza una fuente de medios que signifique este uso, por ejemplo Email.
   • c (campaña): el nombre de la campaña que se quiere medir.
   • af_dp: el esquema de URI de enlace profundo al que deseas enlazar profundamente a tus usuarios.
   • af_web_dp: dónde redirigir a los usuarios haciendo clic en el enlace en un dispositivo de escritorio.
   • af_ios_url: dónde redirigir a los usuarios que no tienen la aplicación haciendo clic en el enlace en un dispositivo iOS.
   • af_android_url: dónde redirigir a los usuarios que no tienen la aplicación haciendo clic en el enlace en un dispositivo Android.
4. Introduce la URL de OneLink en el correo electrónico que hayas creado en Responsys. Ejemplo:

   <a href="greatapp.onelink.me/abcd/1234567">Download my great app!</a>

   En esta etapa, Responsys envuelve el enlace anterior con el dominio de clic que configuraste en los pasos anteriores. Cualquier clic en el dominio de clic redirige al enlace de atribución de OneLink. Si la aplicación está instalada en el dispositivo del usuario, el dominio de clic se enlaza profundamente a la aplicación.

https://greatapp.onelink.me/abcd?pid=Email&c=Spring_Newsletter&is_retargeting=true&
af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&
af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/content

Prueba tus enlaces

Después de seguir todos los pasos requeridos mencionados anteriormente, crear la URL de OneLink adecuada y colocarla en un correo electrónico, envíate un correo electrónico de prueba.

¿Qué debes esperar?

Si tienes la aplicación instalada, la aplicación debe ser invocada. Si se implementan las API de enlaces profundos relevantes del SDK de AppsFlyer, debes tener un enlace profundo al contenido relevante.
Además, debe aparecer un clic tanto en el panel de control de AppsFlyer, atribuido a la fuente de medios y campaña proporcionadas, como también en los datos de Responsys.