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.

À 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.

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 :

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.

// 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.