Dela identitet från mobilappar till mobil webb/WebViews

När en besökare flyttar från en mobilapp till en WebView- eller mobilwebbsida behåller appar och webbkontexter sin egen identitet. Utan en explicit överlämning behandlar webbupplevelsen besökaren som en ny, okänd person, som fragmenterar rapportering och startar om personaliseringen.

Identitetsdelning från mobilen till webben löser detta genom att skicka besökarens Experience Cloud ID (ECID) från mobilappen till webbdestinationen via en adobe_mc frågesträngsparameter. Parametern innehåller ECID, ditt företags-ID och en tidsstämpel. När webbdestinationen läses in med en giltig adobe_mc-parameter, läser Web SDK automatiskt upp den och använder den överförda identiteten på sin första Edge Network-begäran, så båda kontexterna delar samma besökare.

Använd det här mönstret när mobilappen öppnar en WebView- eller mobilwebbsida som din organisation kontrollerar och du vill att appaktiviteten och webbaktiviteten ska vara knutna till samma besökare. Om ditt mål är identitetskontinuitet mellan webbplatser på olika domäner ska du använda korsdomänsdelning i stället.

Förutsättningar

Innan du börjar kontrollerar du att implementeringen uppfyller följande krav:

Hämta identitet från mobilappen retrieve-identity

Använd API:t getUrlVariables från tillägget Identitet för Edge Network för att hämta besökarens identitet som en frågesträng. Du kan sedan lägga till strängen i URL:en innan du öppnar WebView eller webbläsaren.

Den returnerade strängen innehåller följande URL-kodade parametrar:

I följande kodexempel visas hur en beställning kan se ut i din mobilapp:

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

Ta emot identitet på webbsidan receive-identity

Ingen ytterligare kod krävs på webbmålet. När Web SDK finns på sidan och URL:en innehåller en giltig adobe_mc-parameter extraherar SDK automatiskt ECID:t och tillämpar det på besökarens identitetskarta på den första Edge Network-begäran.

Om webbdestinationen använder taggtillägget Web SDK och du behöver dirigera om besökaren till en annan sida samtidigt som du bevarar identiteten, använder du åtgärden Omdirigera med identitet för att vidarebefordra parametern adobe_mc till nästa sida.