Klant-id's en verificatiestatussen customer-ids-and-authentication-states
Naast de Experience Cloud bezoeker-id kunt u aanvullende klant-id's en een verificatiestatus aan elke bezoeker koppelen.
Verificatiestatus section-68ad4065dfaa437d9070832d6e2bf85c
De setCustomerIDs
Deze methode accepteert meerdere klant-id's voor dezelfde bezoeker. Hierdoor kunt u een individuele gebruiker op verschillende apparaten herkennen of als doelgebruiker instellen. U kunt deze id's bijvoorbeeld uploaden als klantkenmerken aan de Experience Cloud en heb toegang tot deze gegevens over de verschillende oplossingen.
setCustomerIDs
(synchronisatie van klant-id) is vereist door klantkenmerken en kernservicefunctionaliteit. Het synchroniseren van klant-id's is een optionele identificatiemethode voor Analytics. Target vereist Visitor.AuthState.AUTHENTICATED
voor Klantkenmerken om te werken. Zie Core Services - Hoe kan ik uw oplossingen inschakelen? voor voorbeelden.Vanaf Experience Cloud Identity Service v1.5+, setCustomerIDs
bevat de optionele AuthState
object. AuthState
identificeert bezoekers volgens hun authentificatiestatus (b.v., het programma geopend, het programma geopend). U stelt de verificatiestatus in met een statuswaarde in de tabel. De verificatiestatus wordt geretourneerd als een geheel getal.
Onbekend of nooit geverifieerd.
Onbekend wordt standaard toegepast wanneer AuthState wordt niet gebruikt met een bezoeker-id of niet expliciet ingesteld op elke pagina- of toepassingscontext.
Voor authentiek verklaard voor een bepaalde instantie, een pagina, of een toepassing.
Let op: Klantkenmerken voor een correcte werking Doel deze status vereisen.
Gevallen gebruiken voor verificatiestatussen section-fe9560cc490943b29dac2c4fb6efd72c
U kunt verificatiestatussen toewijzen aan uw gebruikers, afhankelijk van de handelingen die zij uitvoeren op uw wegeigenschappen en of zij zijn geverifieerd. Zie enkele voorbeelden in de onderstaande tabel:
Deze status kan worden gebruikt voor scenario's zoals:
- Een e-mail lezen (deze handeling betekent mogelijk dat de lezer de beoogde ontvanger is, maar dat de e-mail ook had kunnen worden doorgestuurd).
- Klik van een e-mail aan een landingspagina door.
Klant-id's en geverifieerde statussen instellen section-ec4b367d16ad4ac1a1baca9b01f4ee98
Klant-id's kunnen combinaties van id's en geverifieerde statussen bevatten, zoals in de volgende voorbeelden wordt getoond.
- Id's zijn hoofdlettergevoelig.
- Gebruik alleen ongecodeerde waarden voor uw id's.
- De klant-id's en verificatiestatus worden niet opgeslagen in het cookie van de bezoeker-id. Deze instellingen moeten worden ingesteld voor elke pagina- of toepassingscontext.
- U zou geen Persoonlijk Identificeerbare Informatie (PII) in klant IDs moeten omvatten. Als u PII gebruikt om een bezoeker (zoals een e-mailadres) te identificeren, adviseren wij in plaats daarvan een gehakte of gecodeerde versie van de informatie op te slaan. De ECID-bibliotheek biedt ondersteuning voor het hashen van gebruikers-id's. Zie SHA256 Hashing Support for setCustomerIDs.
// 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
}
});
Klanten-id's en geverifieerde statussen retourneren section-71a610546188478fa9a3185a01d6e83b
Gebruiken getCustomerIDs
om klant IDs en verwante voor authentiek verklaarde staten terug te keren. Deze methode retourneert de geverifieerde status van een bezoeker als een geheel getal.
Syntaxis
getCustomerIDs
retourneert gegevens met de volgende syntaxis.
{
[customerIDType1]:{
"id":[customerID1],
"authState":[authState1]
},
[customerIDType2]:{
"id":[customerID2],
"authState":[authState2]
}
...
}
Voorbeelden
Geretourneerde klant IDs en de gegevens van de authentificatiestatus zouden gelijkaardig aan de volgende voorbeelden moeten kijken.
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-ondersteuning section-861c6b3b1ba645dda133dccb22ec7bb0
De Experience Cloud ID-service ondersteunt klant-id's en verificatiestatus in onze SDK-code voor Android en iOS. Zie de volgende codebibliotheken:
Bericht voor klanten van Analytics en van de Audience Manager section-3a8e9d51e71c4c6e865184b81ed9d99b
Als je gedeclareerde id's doorgeeft aan Audience Managerde userid
-object moet overeenkomen met de integratiecode die aan een gegevensbron is gekoppeld. Zie voor meer informatie de Visitor ID Service in de Code samenvoegregels configureren documentatie.