Show Menu
TOPICS×

ID de client et états d’authentification

Avec l’identifiant visiteur Experience Cloud, vous pouvez associer d’autres ID de client et un état d’authentification à chaque visiteur.

États d’authentification

La
setCustomerIDs
méthode accepte plusieurs ID de client pour un même visiteur. Vous pouvez ainsi identifier ou cibler un utilisateur sur différents appareils. Vous pouvez par exemple télécharger ces ID en tant qu’ attributs du client vers Experience Cloud et accéder à ces données à partir de différentes solutions.
setCustomerIDs
(synchronisation des ID de client) est requis pour les fonctionnalités d’attributs du client et des services principaux. La synchronisation des ID de client est une méthode d’identification facultative pour Analytics. Target nécessite
Visitor.AuthState.AUTHENTICATED
pour que les attributs du client fonctionnent. Pour obtenir des exemples, voir Services principaux – Comment activer vos solutions .
À partir de la version 1.5 du service Experience Cloud Identity,
setCustomerIDs
comprend l’objet
AuthState
facultatif.
AuthState
identifie les visiteurs selon leur état d’authentification (connecté ou déconnecté, par exemple). Vous définissez l’état d’authentification avec une valeur d’état répertoriée dans le tableau. L’état d’authentification est renvoyé sous la forme d’un entier.
État d’authentification
Entier d’état
État d’utilisateur
Visitor.AuthState.UNKNOWN
0
Inconnu ou jamais authentifié.
L’état inconnu est appliqué par défaut lorsque
AuthState
n’est pas utilisé avec un ID de visiteur ou qu’il n’est pas défini explicitement sur chaque page ou contexte d’application.
Visitor.AuthState.AUTHENTICATED
1
Authentifié pour une instance, une page ou une application spécifique.
Attention : Pour bien fonctionner, les attributs du client pour
Target
nécessitent cet état.
Visitor.AuthState.LOGGED_OUT
2
Déconnecté.

Cas d’utilisation des états d’authentification

Vous pouvez affecter des états d’authentification à vos utilisateurs selon les actions qu’ils effectuent sur vos propriétés web et selon s’ils sont authentifiés. Voir les exemples dans le tableau ci-dessous :
État d’authentification
Exemple d’utilisation
Visitor.AuthState.UNKNOWN
Cet état peut être utilisé pour des scénarios tels que :
  • La lecture d’un email (cette action signifie probablement que le lecteur est le destinataire d’origine, mais il se peut également que l’email ait été transféré).
  • Le fait de se rendre sur une page de destination en cliquant sur un lien contenu dans un email.
Visitor.AuthState.AUTHENTICATED
L’utilisateur est actuellement authentifié dans une session active sur votre site web ou votre application.
Visitor.AuthState.LOGGED_OUT
L’utilisateur était authentifié, mais actuellement déconnecté. Celui-ci a eu l’intention de se déconnecter de l’état d’authentification. Il ne souhaite plus être considéré comme authentifié.

Définition des ID de client et des états authentifiés

Les ID de client peuvent contenir des combinaisons d’ID et d’états authentifiés comme l’illustrent les exemples ci-après.
  • Les identifiants sont sensibles à la casse.
  • Utilisez uniquement des valeurs non codées pour les identifiants.
  • Les ID de client et les états d’authentification ne sont pas stockés dans le cookie Identifiant visiteur. Ils doivent être définis pour chaque page ou contexte d’application.
  • N’incluez aucune information d’identification personnelle dans les identifiants client. Si vous utilisez des informations d’identification personnelle pour identifier un visiteur (par exemple, une adresse électronique), il est recommandé de stocker plutôt une version hachée ou chiffrée de l’information. La bibliothèque ECID prend en charge le hachage des identifiants utilisateur. Reportez-vous à la section Prise en charge du hachage SHA-256 pour 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 } });

Renvoi des ID de client et des états authentifiés

Utilisez
getCustomerIDs
pour renvoyer les ID de client et les états authentifiés associés. Cette méthode renvoie l’état authentifié d’un visiteur sous la forme d’un entier.
Syntaxe
getCustomerIDs
renvoie les données avec la syntaxe ci-après.
{ [customerIDType1]:{ "id":[customerID1], "authState":[authState1] }, [customerIDType2]:{ "id":[customerID2], "authState":[authState2] } ... }
Exemples
Les ID de client et les données sur l’état d’authentification renvoyés doivent ressembler à ceux des exemples ci-après.
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 } }

Prise en charge du SDK

Le service Experience Cloud ID prend en charge les identifiants et les états d’authentification du client dans le code de nos SDK Android et iOS. Voir les bibliothèques de code suivantes :

Remarque destinée aux clients Analytics et Audience Manager

Si vous transmettez des ID déclarés à Audience Manager, l’objet
userid
doit correspondre au code d’intégration associé à une source de données. Pour plus d’informations, reportez-vous à la section relative au service d’identification des visiteurs de la documentation sur la configuration du code des règles de fusion .