Implementar Target con AEP Mobile SDK en una aplicación nativa con vistas web

Última actualización: 20 de julio de 2024

Creado para:

  • Desarrollador

Este artículo comparte prácticas recomendadas para implementar Adobe Target en una aplicación móvil que usa código nativo con vistas web mediante Adobe Experience Platform Mobile SDK.

Este artículo usa una aplicación iOS de ejemplo que usa la integración Adobe Experience Platform Mobile SDK y Target escrita en Swift desde el repositorio de GitHub.

En el mundo real, es probable que la aplicación empresarial utilice vistas web en la aplicación móvil. Una vista web es un contenedor que carga una página web mediante una dirección URL. El contenedor es similar a una ventana de explorador sin controles. En iOS, el contenedor de vista web funciona como un explorador Safari al procesar páginas web.

Requisitos previos

Para comenzar con Adobe Experience Platform Mobile SDK, debe realizar algunas tareas previas.

Para obtener más información, consulte Adobe Target en la documentación de Adobe Experience Platform Mobile SDK.

Sincronizar código nativo con vistas web

El desafío que se presenta al implementar Target en una aplicación nativa con vistas web es que Adobe Experience Platform Mobile SDK ya ha generado todos los identificadores necesarios para que las soluciones de Adobe funcionen sin problemas. Sin embargo, los identificadores aún no son visibles para las vistas web porque no están en el entorno de plataforma nativo. Por lo tanto, debe crear un puente para pasar algunos identificadores SDK a las vistas web para que la identidad del visitante persista en el entorno web. Si no lo hace correctamente, se duplican las visitas, lo que afecta a los informes.

Afortunadamente, Adobe Experience Platform Mobile SDK proporciona un método conveniente para generar Adobe parámetros necesarios para que las vistas web se consuman y persistan para el mismo visitante, como se muestra en el siguiente código de ejemplo:

Identity.appendTo(url: URL(string: url), completion: {appendedURL, error in
  print("appendedURL \(String(describing: appendedURL))")
  // load the url with ECID on the main thread
  DispatchQueue.main.async {
    let request = NSMutableURLRequest(url: appendedURL!)
    self.webView.load(request as URLRequest)
  }
});

Para obtener más información acerca del método Identity.appendTo y ver un ejemplo de cómo utilizarlo, vea Swift > Example en la documentación del SDK móvil.

Con Identity.appendTo, esta dirección URL:

https://vadymus.github.io/ateng/at-order-confirmation/index.html?a=1&b=2

se transforma en:

https://vadymus.github.io/ateng/at-order-confirmation/index.html?a=1&b=2&adobe_mc=TS%3D1660667205%7CMCMID%3D69624092487065093697422606480535692677%7CMCORGID%3DEB9CAE8B56E003697F000101%40AdobeOrg

Como puede ver, hay un parámetro adobe_mc anexado a la dirección URL. Este parámetro contiene valores codificados para:

  • TS=1660667205: La marca de tiempo actual. Esta marca de tiempo garantiza que la vista web no reciba valores caducados.
  • MCMID=69624092487065093697422606480535692677: Experience Cloud ID (ECID). También conocido como MID o Marketing Cloud ID, requerido para la identificación de visitantes entre soluciones Adobe.
  • MCORGID=EB9CAE8B56E003697F000101@AdobeOrg: El Adobe Organization ID.

El Identity.getUrlVariables es un método Adobe Experience Platform Mobile SDK alternativo que devuelve una cadena formada correctamente que contiene las variables de dirección URL Experience Cloud Identity Service. Para obtener más información, consulte getUrlVariables en la referencia de API de identidad.