Condividere l’identità dalle app mobili al web/webViews per dispositivi mobili

Quando un visitatore si sposta da un’app mobile a una pagina Web Web WebView o mobile, l’app e i contesti web mantengono ognuno la propria identità. Senza un handoff esplicito, l’esperienza web tratta il visitatore come una persona nuova e sconosciuta, che frammenta il reporting e riavvia la personalizzazione.

La condivisione di identità da dispositivo mobile a Web risolve questo problema passando il ID Experience Cloud (ECID) del visitatore dall'app mobile alla destinazione Web tramite un parametro della stringa di query adobe_mc. Il parametro contiene l’ECID, l’ID organizzazione Experience Cloud e una marca temporale. Quando la destinazione Web viene caricata con un parametro adobe_mc valido, il Web SDK lo legge automaticamente e applica l'identità consegnata alla sua prima richiesta Edge Network, in modo che entrambi i contesti condividano lo stesso visitatore.

Utilizza questo modello quando l’app mobile apre una pagina Web Web WebView o mobile controllata dalla tua organizzazione e desideri che l’attività dell’app e l’attività web rimangano associate allo stesso visitatore. Se l'obiettivo è la continuità delle identità tra siti Web di domini diversi, utilizza invece condivisione tra domini diversi.

Prerequisiti

Prima di iniziare, assicurati che l’implementazione soddisfi i seguenti requisiti:

Recuperare l’identità dall’app mobile retrieve-identity

Utilizzare l'API getUrlVariables dall'estensione Identity for Edge Network per recuperare l'identità del visitatore come stringa di query. È quindi possibile aggiungere la stringa all'URL prima di aprire WebView o il browser.

La stringa restituita contiene i seguenti parametri con codifica URL:

Gli esempi di codice seguenti mostrano l’aspetto di un handoff nell’app 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)
    }
}

Ricevi identità sul lato web receive-identity

Non è richiesto alcun codice aggiuntivo nella destinazione web. Quando il Web SDK è presente nella pagina e l'URL contiene un parametro adobe_mc valido, SDK estrae automaticamente l'ECID e lo applica alla mappa di identità del visitatore alla prima richiesta di Edge Network.

Se la destinazione Web utilizza l'estensione tag Web SDK e devi reindirizzare il visitatore a un'altra pagina mantenendo l'identità, utilizza l'azione Reindirizza con identità per inoltrare il parametro adobe_mc alla pagina successiva.