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.

IMPORTANT

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 Statut de l’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. Vous trouverez quelques 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 :

  • Lecture d’un email (cette action signifie probablement que le lecteur est le destinataire prévu, mais l’email aurait également pu être transféré).
  • Clic d’un email vers une page d’entrée.

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. L’utilisateur ne souhaite plus être traité 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.

IMPORTANT
  • 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 d’état d’authentification renvoyés doivent ressembler aux exemples suivants.

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 codes 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’ID des visiteurs de la documentation sur la configuration du code des règles de fusion.

Sur cette page