Kund-ID och autentiseringstillstånd customer-ids-and-authentication-states
Tillsammans med besökar-ID:t för Experience Cloud kan du koppla ytterligare kund-ID:n och en autentiseringsstatus till varje besökare.
Autentiseringstillstånd section-68ad4065dfaa437d9070832d6e2bf85c
Metoden setCustomerIDs accepterar flera kund-ID för samma besökare. Detta hjälper er att identifiera eller rikta in er på en enskild användare på olika enheter. Du kan till exempel överföra dessa ID:n som kundattribut till Experience Cloud och få tillgång till dessa data via olika lösningar.
setCustomerIDs (synkronisering av kund-ID) krävs av kundattribut och bastjänstfunktioner. Synkronisering av kund-ID:n är en valfri identifieringsmetod för Analytics. Target kräver Visitor.AuthState.AUTHENTICATED för att kundattribut ska fungera. Se bastjänster - Så här aktiverar du dina lösningar för exempel.Från och med Experience Cloud Identity Service v1.5+ inkluderar setCustomerIDs det valfria AuthState-objektet. AuthState identifierar besökare utifrån deras autentiseringsstatus (t.ex. inloggad, utloggad). Du ställer in autentiseringstillståndet med ett statusvärde i tabellen. Autentiseringsstatus returneras som ett heltal.
Okänd eller aldrig autentiserad.
Okänd används som standard när AuthState inte används med ett besökar-ID eller inte uttryckligen anges på varje sida eller i appkontext.
Autentiserad för en viss instans, sida eller app.
Obs! För att kundattributen för Target ska fungera korrekt krävs den här statusen.
Använd ärenden för autentiseringstillstånd section-fe9560cc490943b29dac2c4fb6efd72c
Du kan tilldela autentiseringstillstånd till dina användare, beroende på vilka åtgärder de utför på dina webbegenskaper och om de är autentiserade. Se några exempel i tabellen nedan:
Det här läget kan användas för scenarier som:
- Läsa ett e-postmeddelande (den här åtgärden innebär troligtvis att läsaren är den avsedda mottagaren, men e-postmeddelandet kan också ha vidarebefordrats).
- Klicka igenom från ett e-postmeddelande till en landningssida.
Ange kund-ID och autentiserade tillstånd section-ec4b367d16ad4ac1a1baca9b01f4ee98
Kund-ID:n kan innehålla kombinationer av ID:n och autentiserade tillstånd, vilket visas i följande exempel.
- ID är skiftlägeskänsliga.
- Använd bara okodade värden för dina ID:n.
- Kund-ID:n och autentiseringstillstånd lagras inte i cookien för besökar-ID. De måste anges för varje sida eller programkontext.
- Du bör inte inkludera någon personligt identifierbar information i kund-ID:n. Om du använder PII för att identifiera en besökare (till exempel en e-postadress) rekommenderar vi att du lagrar en hashad eller krypterad version av informationen i stället. ECID-biblioteket har stöd för att hash-koda användaridentifierare. Se SHA256 Hash-stöd för setCustomerID:n.
// Single ID with a single authentication state
visitor.setCustomerIDs({
"userid":{
"id":"67312378756723456",
"authState":Visitor.AuthState.AUTHENTICATED
}
});
/*
Multiple IDs with only the first ID explicitly assigned an authentication state.
The second ID is not explicitly assigned an authentication state and is implicitly
assigned Visitor.AuthState.Unknown by default.
*/
visitor.setCustomerIDs({
"userid":{
"id":"67312378756723456",
"authState":Visitor.AuthState.AUTHENTICATED
},
"dpuuid":"550e8400-e29b-41d4-a716-446655440000"
});
// Multiple IDs with identical authentication states
visitor.setCustomerIDs({
"userid":{
"id":"67312378756723456",
"authState":Visitor.AuthState.AUTHENTICATED
},
"dpuuid":{
"id":"550e8400-e29b-41d4-a716-446655440000",
"authState":Visitor.AuthState.AUTHENTICATED
}
});
// Multiple IDs with different authentication states
visitor.setCustomerIDs({
"userid":{
"id":"67312378756723456",
"authState":Visitor.AuthState.AUTHENTICATED
},
"dpuuid":{
"id":"550e8400-e29b-41d4-a716-446655440000",
"authState":Visitor.AuthState.LOGGED_OUT
}
});
Returnera kund-ID:n och autentiserade tillstånd section-71a610546188478fa9a3185a01d6e83b
Använd getCustomerIDs för att returnera kund-ID:n och relaterade autentiserade tillstånd. Den här metoden returnerar en besökares autentiserade tillstånd som ett heltal.
Syntax
getCustomerIDs returnerar data med följande syntax.
{
[customerIDType1]:{
"id":[customerID1],
"authState":[authState1]
},
[customerIDType2]:{
"id":[customerID2],
"authState":[authState2]
}
...
}
Exempel
Returnerade kund-ID:n och autentiseringsstatusdata ska se ut ungefär som i följande exempel.
Object customerIDs = visitor.getCustomerIDs();
// No setCustomerIDs call on this instance
{}
// setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456"}}
{
"userid":{
"id":"67312378756723456",
"authState":0
}
}
// setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456","authState":Visitor.AuthState.AUTHENTICATED}}
{
"userid":{
"id":"67312378756723456",
"authState":1
}
}
// setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT}}
{
"userid":{
"authState":2
}
}
// setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT},"dpuuid":{"id":"550e8400-e29b-41d4-a716-446655440000"}}
{
"userid":{
"authState":2
},
"dpuuid":{
"id":"550e8400-e29b-41d4-a716-446655440000",
"authState":0
}
}
SDK-stöd section-861c6b3b1ba645dda133dccb22ec7bb0
ID-tjänsten Experience Cloud stöder kund-ID:n och autentiseringstillstånd i vår Android- och iOS SDK-kod. Se följande kodbibliotek:
Meddelande till Analytics- och Audience Manager-kunder section-3a8e9d51e71c4c6e865184b81ed9d99b
Om du skickar deklarerade ID:n till Audience Manager måste userid-objektet matcha integrationskoden som är associerad med en datakälla. Mer information finns i avsnittet Visitor ID Service i dokumentationen för Konfigurera kod för kopplingsregler.