Integración de Salesforce Marketing Cloud con AppsFlyer

De un vistazo: Integra los datos de AppsFlyer con una cuenta de Salesforce Marketing Cloud (SFMC) para crear enlaces profundos sin problemas desde los correos electrónicos. El flujo utiliza la compatibilidad de SFMC con los enlaces universales en un dominio de registro de clics de marca.

SFMC_AF-logo.png

Introducción 

Los ESP (proveedores de servicios de correo electrónico) son excelentes fuentes de tráfico de usuarios segmentado. Sin embargo algunos ESP, y este es un problema común de los ESP, no realizan correctamente la atribución y el enlace profundo.

Los ESP envuelven la URL del enlace profundo con el dominio de registro de clics de su propio ESP. Este procedimiento suele romper el proceso de Enlaces Universales de iOS. Sin embargo, hay ESP que admiten enlaces universales en su dominio de registro de clics, por lo que se pueden realizar enlaces profundos y registro de clics.

Integración de Salesforce Marketing Cloud con AppsFlyer

Los pasos 1 a 4 descritos a continuación son necesarios para admitir la vinculación profunda de iOS.

Requisitos previos

iOSAndroid

AppsFlyer iOS SDK versión 4.9.0 

Para los enlaces universales de iOS debes realizar lo siguiente en tu entorno SFMC:

  • Adquisición y aplicación del Paquete de Autenticación de Remitentes (SAP)
  • Adquiere un certificado SSL (también conocido como configuración SSL) y envía un formulario de solicitud de SSL
    * Para obtener el paquete de autenticación de remitente y el certificado SSL, ponte en contacto con tu representante de cuentas de Salesforce o envía un caso de asistencia de entregabilidad a través del Centro de Ayuda de Salesforce.

Paso 1: Establece tu dominio de registro de clics en SFMC

Para configurar un dominio de registro de clics, sigue las guías oficiales de SFMC para:

Paso 2: Carga tu certificado SSL en SFMC

Para que los enlaces universales de iOS funcione correctamente, tu dominio de registros de clics debe incluir el certificado SSL de tu dominio que debe estar instalado en su cuenta SFMC. Encontrarás instrucciones para configurar tus certificados SSL en la guía oficial de SFMC.

Paso 3: Establece enlaces profundos en SFMC

Para habilitar el enlace profundo desde los correos electrónicos de SFMC:

  1. Inicia sesión en tu cuenta de SFMC y ve a la vista Estudio de correo electrónico
  2. Haz clic en la pestaña Administrar
  3. En el menú lateral, haz clic en enlaces profundos. En esta vista, puedes configurar nuevas integraciones de enlaces profundos con tu aplicación, o modificar las existentes.

  4. Para crear una nueva configuración, haz clic en el botón Crear e introduce tu AppID. El valor AppID es una combinación de tu ID de equipo de desarrollador de Apple y el ID de paquete. Ambos valores pueden recuperarse desde tu cuenta de desarrollador de Apple.

     Ejemplo

    Dado el prefijo de ID de equipo 5UABCDFGH y el ID de paquete com.your.app, debe introducirse el siguiente valor:
    5UABCDFGH.com.your.app

    SFMC_Deep_Linking_2.png

  5. La configuración de enlaces universales y enlaces profundos se completa una vez que SFMC configura el archivo Apple App Site Association (AASA). Este proceso puede durar unas horas. Puedes ver el archivo generado utilizando la siguiente URL:
    https://<click_recording_link_domain>/apple-app-site-association

Paso 4: Configura tu SDK AppsFlyer

 Nota

Si aún no lo has hecho, asegúrate de configurar tu aplicación para que admita enlaces profundos con OneLink.

Después de configurar tu dominio de registro de clics para que admita enlaces universales como se ha descrito anteriormente, debes configurar su aplicación para que establezca enlaces profundos y resuelva el enlace universal.

  1. Asociar el dominio de registro de clics en Xcode:

  2. Proporciona el dominio de registro de clics a la API del SDK setResolveDeepLinkURLs. Esta API debe llamarse antes de la inicialización del SDK. Para obtener más información, consulta la documentación del SDK aquí.
    AppsFlyerLib.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
    
    • Importante: Si utilizas Movable Ink (MI) junto con Salesforce, deberás obtener el CNAME de MI y los dominios internos del administrador de tu cuenta de MI y añadirlos a setResolveDeepLinkURLs, además del enlace de clic para Salesforce. Por ejemplo:
      AppsFlyerLib.shared().resolveDeepLinkURLs = ["salesforce-click.example.com", "mi.example.com", "example.micpn.com"]
      
  3. Cuando se invoca la aplicación debido a un clic en el enlace universal, el SDK de AppsFlyer resuelve el enlace profundo y extrae el OneLink subyacente. A continuación, todos los parámetros de enlace profundo se propagan a la API onAppOpenAttribution para la ejecución de la lógica de enlace profundo.

Enviar correos electrónicos con OneLink a través de SFMC

  1. Crea un enlace OneLink manualmente o en la página de enlaces OneLink del panel de control de AppsFlyer.
    • URL codifica todos los valores de los parámetros al crear un OneLink. 
    • Son parámetros muy recomendables:
      pid fuente de medios Fuente mediática representativa
      c nombre de la campaña Campaña que se atribuirá.
      af_dp URL de enlace profundo Redireccionamiento de enlaces profundos para los usuarios.
      af_web_dp redireccionamiento de escritorio Redireccionamiento para usuarios de ordenadores de mesa.
      af_ios_url  

      Redireccionamiento para usuarios de dispositivos iOS que no tengan instalada la aplicación.

      af_android_url   Redireccionamiento para usuarios de dispositivos Android que no tengan instalada la aplicación.
  2. Copia el enlace en el correo electrónico creado en Salesforce Email Studio.
    • Ahora, Salesforce Marketing Cloud envuelve el enlace con el dominio de registro de clics que se configuró anteriormente.
    • Cualquier clic en el dominio de registro de clics redirige al enlace de atribución de OneLink.

 Ejemplo

Para facilitar la lectura, los parámetros URL no están codificados:

https://example.onelink.me/ABcd?pid=Email&c=Spring_Newsletter&
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

Para probar tus enlaces de atribución:

  1. Crea la URL OneLink adecuada.
  2. Colócalo en un correo electrónico.
  3. Envíate el correo electrónico a ti mismo.
  4. Haz clic en el enlace.
  • Si tienes la aplicación instalada en tu dispositivo, 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.
  • Debería aparecer un clic tanto en el panel de control de AppsFlyer, atribuido a la fuente de medios proporcionada como a la campaña.
  • Aparece un clic en los datos de Salesforce.