¿Cómo podemos ayudarte?

Integración de Salesforce Marketing Cloud (SFMC) con AppsFlyer

  • Actualización

Integra AppsFlyer con Salesforce Marketing Cloud (SFMC) para usar Deep Linking y dirigir a los usuarios desde campañas de correo electrónico hasta contenido in-app. Sincroniza los datos de eventos in-app en SFMC para crear audiencias y activar viajes en función del comportamiento real de la aplicación.

Sobre la integración

SFMC te permite volver a interactuar con los usuarios existentes mediante campañas de correo electrónico, usando Deep Linking para dirigirlos a contenido in-app específico, como una promoción o una oferta personalizada.

Hay dos opciones de integración:

  • Deep Linking estándar de correo electrónico de SFMC: crea los enlaces OneLink de tu campaña en AppsFlyer y luego añádelos a tus correos electrónicos.
  • Integración avanzada con AppExchange de SFMC: crea enlaces OneLink de campaña directamente en Salesforce e importa automáticamente datos de eventos in-app para poder crear audiencias de re-engagement. Esta es una función premium.

Comparación: Standard vs. Advanced

Capacidad Deep Linking estándar de correo electrónico de SFMC Integración avanzada con AppExchange de SFMC
Deferred deep links
Enlaces directos
Medición de Deep Linking
Creación de enlaces En AppsFlyer En la aplicación de Salesforce dedicada
Postbacks de SFMC (sincronización de eventos in-app) No

Prerrequisitos

apps de iOS,
  • SDK de AppsFlyer para iOS, versión 4.9.0+
  • Para los enlaces universales de iOS, haz lo siguiente en tu entorno de SFMC: compra e implementa un Sender Authentication Package (SAP) y compra un certificado SSL (configuración de SSL) y envía un formulario de solicitud de SSL. Ponte en contacto con tu representante de cuenta de Salesforce o envía un Caso de soporte de entregabilidad a través de Salesforce ayuda para obtener ambos.
Android
  • SDK de AppsFlyer para Android, versión 4.9.0+
  • SFMC no admite Android App Links, así que en su lugar se usa Deep Linking con URI Scheme. No se requiere ninguna acción especial para soporte de Deep Linking en apps Android desde SFMC.

Configura Deep Linking estándar de correo electrónico de SFMC 

Configura la integración:

Paso 1: Configura 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 funcionen correctamente, tu dominio de registro de clics debe incluir el certificado SSL de tu dominio, que debe estar instalado en tu cuenta de SFMC. Encontrarás instrucciones para configurar tus certificados SSL en la guía oficial de SFMC.

Paso 3: Configura el deep linking 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 Email Studio
  2. Haz clic en la pestaña Administrar
  3. En el menú lateral, haz clic en Deep Linking. En esta vista, puedes configurar nuevas integraciones de enlaces profundos con tu aplicación, o modificar las existentes.

    [SE NECESITA TEXTO ALT: describe la pantalla de configuración de Deep Linking de SFMC]
  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

    [SE NECESITA TEXTO ALT: describe la pantalla de configuración de Deep Linking de SFMC que se muestra aquí]
  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 de AppsFlyer

Nota:

Si aún no lo has hecho, asegúrate de configurar tu aplicación para que admita Deep Linking 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:

    [SE NECESITA TEXTO ALT: describe la pantalla de dominios asociados de 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 sobre la resolución de URL de Deep Linking.

    AppsFlyerLib.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
    • ¡Importante! Si utilizas Movable Ink (MI) junto con Salesforce, debes obtener el CNAME de MI y los dominios internos de tu gestor de cuentas 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 deep link se propagan a la API onAppOpenAttribution para ejecutar la lógica de deep link.

Envía correos electrónicos con Deep Linking de correo electrónico estándar de SFMC

Para enviar correos electrónicos con Deep Linking de correo electrónico estándar de SFMC:

  1. Crea un enlace de OneLink, ya sea manualmente o desde la página de enlaces de OneLink en el dashboard de AppsFlyer.
  2. Codifica en URL todos los valores de los parámetros cuando crees el OneLink. Estos parámetros son muy recomendables:
Parámetro Descripción Notas
pid Fuente de medios Fuente mediática representativa
C Nombre de la campaña La 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 iOS que no tengan instalada la aplicación
af_android_url   Redireccionamiento para usuarios de Android que no tengan instalada la aplicación
  1. Copia el enlace en el correo electrónico que crees en Salesforce Email Studio. Salesforce Marketing Cloud envuelve el enlace con tu dominio de registro de clics, por lo que cualquier clic en ese dominio redirige a tu enlace de atribución de OneLink.

Ejemplo (parámetros de URL mostrados sin codificar, para facilitar la lectura):

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

Configura la integración avanzada de intercambio de aplicaciones de SFMC 

Para configurar la integración avanzada de SFMC con AppExchange:

Paso 1: Instala la app OneLink desde el SFMC AppExchange
  1. Pide a tu CSM, o escribe a hello@appsflyer.com, que habilite la instalación de la app en SFMC AppExchange.
  2. En Salesforce, ve al enlace de AppExchange que comparta tu CSM una vez que la app esté habilitada.
  3. Haz clic en Install.
  4. Concede permisos: pide al administrador de Salesforce Marketing Cloud que conceda acceso a la app a usuarios individuales o unidades de negocio. Puede que necesites hacer una recarga completa para ver los nuevos permisos.
  5. Da a los usuarios acceso a la app OneLink de AppsFlyer: ve a Apps > Installed Packages, selecciona la pestaña ACCESS, selecciona los usuarios que deban poder usar OneLink y haz clic en Save. De nuevo, puede que necesites hacer una recarga completa.
Paso 2: Completa la configuración básica

Completa los pasos de «Configurar el Deep Linking estándar de correo electrónico de SFMC» que aparecen arriba.

Paso 3: Crea enlaces OneLink en Salesforce con la app OneLink de AppsFlyer

Crea un enlace de atribución independiente para cada campaña.

[SE NECESITA TEXTO ALT: actualmente el nombre de archivo es SFMC-AF-app1-en_us.png; describe la pantalla de la app OneLink que se muestra]

Para crear un enlace de OneLink:

  1. En Salesforce, abre la app OneLink de AppsFlyer.
  2. Haz clic en Añadir OneLink.
  3. Introduce un nombre en el campo Nombre del enlace. Considere:
    • Elige un nombre fácil de identificar.
    • El nombre del enlace se usará al aplicar OneLinks a las campañas de correo electrónico.
  4. En el campo URL base, introduce la URL OneLink en versión larga que copiaste de la página Enlaces personalizados de OneLink de AppsFlyer.
  5. [Opcional] Para añadir más parámetros, haz clic en Añadir parámetro. Consulta la lista de parámetros recomendados.
  6. [Opcional] Para configurar una macro interna de Salesforce Marketing Cloud, haz clic en el icono situado a la derecha de un parámetro.
    • Se recomienda configurar una Subscriber key para cada parámetro de OneLink.
    • Esto te permite vincular las conversiones de correo electrónico atribuidas a tus datos de Salesforce.
  7. Haz clic en Generar enlace.
Paso 4: Envía correos electrónicos que contengan enlaces de atribución personalizados
  1. En Salesforce Email Studio, crea una nueva plantilla o un nuevo correo electrónico.
  2. Haz clic en el icono Edit, en la pestaña Content y, a continuación, selecciona Blocks.
  3. Desplázate hacia abajo hasta encontrar AppsFlyer Button CB o AppsFlyer Image CB.

    [SE NECESITA TEXTO ALT: describe el panel de bloques de contenido que se muestra actualmente en el archivo sf_email_edit_onelink_new.PNG]
  4. Arrastra la imagen o el botón al cuerpo del correo electrónico.
  5. Haz clic en la imagen o el botón para editarlo/la.
  6. En el campo Título, asigna un nombre a la imagen o al botón.
  7. Selecciona un enlace de OneLink.

    [SE NECESITA TEXTO ALT: describe el selector de enlaces de OneLink que se muestra]
  8. Guarda el correo electrónico y envíalo.

 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
Paso 5: 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.

Correos electrónicos dinámicos

Si necesitas generar enlaces dinámicamente para representar contenido dinámico por usuario, usa la API de OneLink.

Para hacerlo, usa una actividad de script de Automation Studio en Journey Builder de SFMC que llame a la API de OneLink antes del envío, escriba el enlace profundo generado en un campo de la Data Extension de envío para cada contacto y, después, haz que el correo electrónico extraiga ese campo con una búsqueda sencilla de AMPscript.

Sincronización avanzada de datos de eventos in-app de SFMC

Esta función permite que AppsFlyer envíe automáticamente datos de eventos in-app desde tu aplicación a Salesforce Marketing Cloud, donde se almacenan en una Data Extension específica. Usa estos datos para crear audiencias, activar viajes y personalizar campañas en función del comportamiento real de la aplicación, como compras, registros o niveles completados.

Esta es una función premium, disponible como parte de la integración avanzada de AppExchange de SFMC.

Cómo funciona

Cuando un usuario realiza un evento in-app (por ejemplo, al completar una compra), AppsFlyer envía un postback al conector de SFMC. El conector escribe los datos del evento en una Data Extension de tu cuenta de SFMC, donde cada fila representa un evento para un contacto. A partir de ahí, usa Journey Builder o Automation Studio de SFMC para activar comunicaciones de seguimiento en función de ese evento.

Para configurar la sincronización avanzada de datos: 

Paso 1: Activa el envío de postback en AppsFlyer
  1. En AppsFlyer, ve a Colaborar > Integraciones activas y busca Salesforce Marketing Cloud.
  2. Selecciona la aplicación que quieres configurar y haz clic en Configurar integración.
  3. En la pestaña Integración, asegúrate de que el selector Activar partner esté activado.
  4. Desplázate hasta Postbacks de eventos in-app y activa el selector.
  5. Haz clic en Añadir evento y asigna los eventos de AppsFlyer que quieras enviar a SFMC. Para cada evento, selecciónalo en la lista de eventos de tu aplicación y establece la condición de envío: Solo este partner (envía solo los eventos atribuidos al tráfico de SFMC) o Todas las fuentes de medios, incluido el orgánico (recomendado para crear audiencias, ya que envía cada ocurrencia del evento independientemente de la atribución).
  6. Haz clic en Guardar integración.

En la lista de eventos solo aparecen los eventos que AppsFlyer ya ha recibido a través de tu SDK o de la integración S2S. Si falta algún evento, primero revisa la implementación del SDK.

Paso 2: Verifica la Data Extension en SFMC

Después de que se envíe el primer postback, AppsFlyer crea automáticamente una Data Extension en tu cuenta de SFMC con el nombre Installs-{mid} o Events-{mid}. Para verificarlo:

  1. En SFMC, ve a Email Studio > Data Extensions.
  2. Busca la Data Extension de tu aplicación.
  3. Confirma que las filas se estén rellenando con datos de eventos. Cada fila debe incluir el identificador del contacto, el nombre del evento, la marca de tiempo del evento y los parámetros del evento.

Si la Data Extension no se creó automáticamente, confirma que la aplicación del conector de SFMC esté instalada correctamente y que el administrador de SFMC le haya concedido los permisos necesarios para escribir datos.

Paso 3: Usa los datos de eventos en Journey Builder
  1. En SFMC, abre Journey Builder y crea o edita un journey.
  2. Configura la fuente de entrada como Data Extension y selecciona la Data Extension de AppsFlyer de tu aplicación.
  3. Configura los criterios de entrada, por ejemplo, contactos cuyo event_name sea igual a af_purchase.
  4. Crea los pasos del viaje que necesites (enviar correo electrónico, esperar, ramificar por valor de evento, etc.).
  5. Activa el viaje.

Usa el parámetro af_sub1 en tus OneLinks para pasar la clave de suscriptor de SFMC como identificador de usuario. Esto permite que los postbacks coincidan con el registro de contacto correcto en Salesforce, lo que habilita la personalización a nivel de contacto en lugar de solo la atribución a nivel de campaña.

Campos de datos de postback

El conector de SFMC crea dos Data Extensions en tu cuenta: una para instalaciones y otra para eventos in-app. Todos los campos existen en el esquema, pero algunos no se rellenan actualmente. Los campos marcados como "not written" forman parte del esquema, pero siempre estarán vacíos.

Campos de datos

Campos de la Data Extension de instalación (49 campos)

Campo Escrito Notas
Tipo de Toque  
Tiempo de toque  
eventName  
Fuente del evento  
Media Source  
Channel  
Campaña  
Campaign ID  
Sub Param 1 a 5 Se asigna a af_sub1 hasta af_sub5 en OneLink
Región  
Código del país  
State  
CITY  
Código postal  
DMA  
IP  
ID de AF El identificador único de dispositivo de AppsFlyer
IDFV  
Tipo de dispositivo  
Categoría del dispositivo  
Platform  
Versión OS de la instalación  
Versión de la aplicación  
Versión del SDK  
Identificación de la aplicación  
App Name  
Es retargeting  
Tipo de coincidencia  
User Agent  
Hora de la Instalación  
Event Time  
Valor de enlace profundo  
deep_link_sub1 a sub10 No Existe en el esquema, no se escribe
Identificador de anunciante (IDFA) No Existe en el esquema, no se escribe (identificador de dispositivo de iOS)
ID de anunciante No Existe en el esquema, no se escribe (GAID de Android)

Campos de la Data Extension de eventos in-app

Todos los campos de instalación anteriores, además de:

Campo Escrito Notas
Es atribución primaria No Existe en el esquema, no está escrito
Ventana de re-engagement No Existe en el esquema, no está escrito
Valor del evento No Existe en el esquema, no está escrito
Divisa de ingresos del evento No Existe en el esquema, no está escrito
Ingresos del evento en USD No Existe en el esquema, no está escrito

Resolución de problemas

  • No hay datos en la Data Extension: comprueba que tanto el selector Activar partner como el selector de postbacks de eventos in-app estén activados y que los eventos que necesitas estén mapeados. Confirma también que la aplicación de SFMC tiene permisos de escritura de datos en tu cuenta de SFMC.
  • Los eventos aparecen, pero no hay contactos coincidentes: asegúrate de pasar af_sub1=%%subscriberkey%% en tus OneLinks para que los postbacks puedan asociarse a los contactos de SFMC.
  • La Data Extension no se ha creado: ponte en contacto con tu CSM o con el soporte de AppsFlyer para confirmar que el conector se ha aprovisionado correctamente para tu cuenta.