Partage d’identité entre des applications mobiles et des vues web/web mobiles

Lorsqu’un visiteur passe d’une application mobile à une page WebView ou web mobile, l’application et les contextes web conservent chacun leur propre identité. Sans transfert explicite, l’expérience web traite le visiteur comme une nouvelle personne inconnue, ce qui fragmente le reporting et redémarre la personnalisation.

Le partage d’identités mobile à web résout ce problème en transmettant l’Experience Cloud ID (ECID) du visiteur de l’application mobile à la destination web via un paramètre de chaîne de requête adobe_mc. Le paramètre est associé à l’ECID, à l’ID d’organisation Experience Cloud et à une date et heure. Lorsque la destination web se charge avec un paramètre de adobe_mc valide, le SDK Web le lit automatiquement et applique l’identité transmise à sa première requête Edge Network, de sorte que les deux contextes partagent le même visiteur.

Utilisez ce modèle lorsque votre application mobile ouvre une page WebView ou web mobile contrôlée par votre organisation et que vous souhaitez que l’activité de l’application et l’activité web restent liées au même visiteur. Si votre objectif est la continuité d’identité entre les sites web de différents domaines, utilisez plutôt le partage inter-domaines.

Conditions préalables

Avant de commencer, assurez-vous que votre implémentation répond aux exigences suivantes :

Récupérer l’identité à partir de l’application mobile retrieve-identity

Utilisez l’API getUrlVariables de l’extension Identity for Edge Network pour récupérer l’identité du visiteur sous forme de chaîne de requête. Vous pouvez ensuite ajouter cette chaîne à l’URL avant d’ouvrir WebView ou le navigateur.

La chaîne renvoyée contient les paramètres codés en URL suivants :

Les exemples de code suivants montrent à quoi pourrait ressembler une remise dans votre application mobile :

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)
    }
}

Recevoir une identité côté web receive-identity

Aucun code supplémentaire n’est requis sur la destination web. Lorsque le SDK Web est présent sur la page et que l’URL contient un paramètre de adobe_mc valide, le SDK extrait automatiquement l’ECID et l’applique au mappage d’identité du visiteur lors de la première requête Edge Network.

Si la destination web utilise l’extension de balise Web SDK et que vous devez rediriger le visiteur vers une autre page tout en préservant l’identité, utilisez l’action Rediriger avec identité pour transférer le paramètre adobe_mc vers la page suivante.