Compartir la identidad de aplicaciones móviles en web/WebViews móviles

Cuando un visitante pasa de una aplicación móvil a una página web WebView o móvil, la aplicación y los contextos web mantienen cada uno su propia identidad. Sin un traspaso explícito, la experiencia web trata al visitante como una persona nueva y desconocida, lo que fragmenta el sistema de informes y reinicia la personalización.

El uso compartido de identidades de móvil a web soluciona esto al pasar el Experience Cloud ID (ECID) del visitante de la aplicación móvil al destino web mediante un parámetro de cadena de consulta adobe_mc. El parámetro lleva el ECID, el ID de organización de Experience Cloud y una marca de tiempo. Cuando el destino web se carga con un parámetro adobe_mc válido, Web SDK lo lee automáticamente y aplica la identidad entregada en su primera solicitud de Edge Network, de modo que ambos contextos comparten el mismo visitante.

Utilice este patrón cuando su aplicación móvil abra una página web WebView o móvil que su organización controle y cuando desee que la actividad de la aplicación y la actividad web permanezcan vinculadas al mismo visitante. Si su objetivo es la continuidad de identidad entre sitios web de dominios diferentes, use uso compartido entre dominios en su lugar.

Requisitos previos

Antes de empezar, asegúrese de que la implementación cumple los siguientes requisitos:

Recuperar identidad de la aplicación móvil retrieve-identity

Utilice la API getUrlVariables de la extensión Identity for Edge Network para recuperar la identidad del visitante como cadena de consulta. A continuación, puede anexar esa cadena a la dirección URL antes de abrir WebView o el explorador.

La cadena devuelta contiene los siguientes parámetros con codificación URL:

Los siguientes ejemplos de código muestran el aspecto que podría tener un envío en su aplicación móvil:

Identity.getUrlVariables { (urlVariables, error) in
    if let error = error {
        // Handle the error
        return
    }

    guard let urlVariables = urlVariables else { return }

    // Construct the full URL by appending the identity query string
    if let url = URL(string: "https://example.com/webapp?\(urlVariables)") {
        // Open the URL in a WebView or browser
        let request = URLRequest(url: url)
        webView.load(request)
    }
}

Identity.getUrlVariables { urlVariables ->
    if (urlVariables != null) {
        // Construct the full URL by appending the identity query string
        val url = "https://example.com/webapp?$urlVariables"

        // Open the URL in a WebView or browser
        webView.loadUrl(url)
    }
}

Recibir identidad en el lado web receive-identity

No se requiere código adicional en el destino web. Cuando Web SDK está presente en la página y la dirección URL contiene un parámetro adobe_mc válido, SDK extrae automáticamente el ECID y lo aplica al mapa de identidad del visitante en la primera solicitud de Edge Network.

Si el destino web usa la extensión de etiquetas Web SDK y necesita redirigir al visitante a otra página preservando al mismo tiempo la identidad, use la acción Redirigir con identidad para reenviar el parámetro adobe_mc a la página siguiente.