ID de client et états d’authentification customer-ids-and-authentication-states

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

États d’authentification section-68ad4065dfaa437d9070832d6e2bf85c

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 section-fe9560cc490943b29dac2c4fb6efd72c

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 de destination.
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éfinir les ID de client et les états authentifiés section-ec4b367d16ad4ac1a1baca9b01f4ee98

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 e-mail), 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
    }
});

Renvoyer les ID de client et les états authentifiés section-71a610546188478fa9a3185a01d6e83b

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 section-861c6b3b1ba645dda133dccb22ec7bb0

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 section-3a8e9d51e71c4c6e865184b81ed9d99b

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.

recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a