Använda Experience Cloud ID i Adobe Pass-autentisering

Vad är Experience Cloud ID och hur skaffar man det? what-exp-cloud-id-obtain

Experience Cloud-id (ECID för kort) är ett unikt id som skapas av Adobe Experience Cloud för varje enskild användare i ditt program/på din webbplats. ECID används i stor utsträckning i alla Experience Cloud-rapporter som används för att länka samman information om en viss användare över flera program/webbplatser.

Om du redan har ett system som tillhandahåller ett besökar-ID bör du använda samma ID för dokumentets omfång.

Ett sätt att få ett ECID är att använda Experience Cloud ID-tjänsten. Du kan använda den implementeringstyp som du föredrar, antingen baserat på TDM, JS-bibliotek, serversidan, direktintegrering eller inbyggda bibliotek för mobila plattformar. En utförlig översikt över tillgängliga tjänster, bibliotek, SDK och implementeringsguider finns på: https://experienceleague.adobe.com/docs/id-service/using/implementation/implementation-guides.html?lang=sv-SE

Vilken är fördelen med att använda Experience Cloud ID i Adobe Pass Authentication? benefit-ex-cloud-id

Om du konfigurerar våra SDK:er och klientlösa REST API:er att använda ditt ECID, kommer du senare att kunna länka data som samlats in av Adobe Pass Authentication till dina befintliga Experience Cloud-lösningar. På så sätt kan ni bättre förstå era kunders resa och upplevelse i alla lösningar som Adobe tillhandahåller.

Hur använder man Experience Cloud-id:t i Adobe Pass Authentication? how-to-ex-cloud-id-authn

När du har fått ett ECID (förklaras ovan) måste du skicka informationen till våra SDK:er och vårt klientlösa REST API. Informationen skickas senare till våra servrar vid varje nätverksanrop som SDK gör. Konfigurationsprocessen är annorlunda för alla SDK:

JS SDK js-sdk

För JavaScript måste du skicka ECID i en karta som den tredje parametern till setRequestor-anropet.

Användningsexempel:

accessEnabler.setRequestor("REQUESTOR_ID", ["ENDPOINT_URL"],
    {
        "visitorID": "THE_ECID_VALUE"
    }
);

iOS/tvOS SDK ios-sdk

För iOS/tvOS SDK finns det en dedikerad metod som kallas setOptions.

Användningsexempel:

accessEnabler.setOptions(
    [
        "visitorID": "THE_ECID_VALUE"
    ]
);

Android/FireTV SDK android-sdk

För Android/FireTV SDK liknar mekanismen iOS. Det är bara parameternamnet som är annorlunda. API:t beskrivs här.

Användningsexempel:

String visitor_id = "THE_ECID_VALUE";

HashMap<String, String> options = new HashMap();
options.put("ap_vi",visitor_id);

accessEnabler.setOptions(options);

Klientlöst API clientless-api

När du använder Adobe Pass via dess REST API v1, ska värdet ECID skickas för alla API:er som en parameter med namnet 'ap_vi'.

Användningsexempel:

GET: https://api.auth.adobe.com/api/v1/authorize?...&ap_vi=THE_ECID_VALUE

REST API V2 rest-api-v2

När du använder Adobe Pass via dess REST API v2, ska värdet ECID skickas för alla API:er som ett huvud med namnet 'AP-Visitor-Identifier'.

Användningsexempel:

POST: https://api.auth.adobe.com/api/v2/${serviceProvider}/sessions/
Sidhuvuden:
AP-Visitor-Identifier: THE_ECID_VALUE