Prise en charge du hachage SHA-256 pour setCustomerIDs

Le service Experience Cloud ID (ECID) prend en charge l’algorithme de hachage SHA-256 qui vous permet de transmettre des ID de client ou des adresses électroniques, et transmet des identifiants hachés. Il s’agit d’une méthode JavaScript facultative pour envoyer des identifiants hachés à Experience Cloud. Vous pouvez continuer à utiliser vos propres méthodes de hachage avant d’envoyer les ID de client.
Il existe deux façons de mettre en œuvre la prise en charge du hachage avec setCustomerIDs, comme décrit dans les sections ci-dessous :

Utilisation de la méthode setCustomerIDs dans ECID

La première méthode utilise la méthode setCustomerIDs (customerIDs<object>, hashType<string>).

Avant de procéder au hachage, la bibliothèque ECID effectue une normalisation des données sur les customerIDs. Ce processus supprime les espaces des customerIDs à chaque extrémité et convertit tous les caractères en minuscules. Par exemple, l’adresse électronique «  ecid@adobe.com  » devient « ecid@adobe.com »

Vous trouverez ci-dessous un exemple de code illustrant comment définir un identifiant client unique (l’adresse électronique mentionnée ci-dessus) avec un hachage SHA-256.

// Set single customerID with SHA-256 hashing
visitor.setCustomerIDs({email: {id: "ecid@adobe.com", authState: 1}}, "SHA-256");

 

Avec l’identifiant visiteur Experience Cloud, vous pouvez associer d’autres ID de client, un état d’authentification et un type de hachage (SHA-256) à chaque visiteur. Si vous ne spécifiez aucun type de hachage, ce dernier n’aura pas lieu.

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. Par exemple, vous pouvez télécharger ces identifiants sous la forme attributs du client vers l’Experience Cloud et accéder à ces données dans les différentes solutions.

Les ID de client, les états authentifiés et le type de hachage ne sont pas stockés dans un cookie à utiliser ultérieurement. Au lieu de cela, les ID de client, les états authentifiés et le type de hachage doivent être stockés dans une variable d’instance, qui peut être récupérée en utilisant getCustomerIDs, comme illustré ci-dessous :

> visitor.getCustomerIDs();
< {email: {…}}
    email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"}
    __proto__: Object

 

L’utilisation de la méthode setCustomerIDs génère un appel au service Experience Cloud ID, à dpm.demdex.net, auquel est ajouté le paramètre de requête d_cid_ic qui contient l’ID de client haché. Un appel type pourrait ressembler à ce qui suit. Des sauts de ligne ont été ajoutés pour plus de clarté.

http://dpm.demdex.net/id?d_visid_ver=4.4.0&d_fieldgroup=AAM&d_rtbd=json&d_ver=2&
d_orgid=12A3F3F459CE0AD80A495CBE%40AdobeOrg&d_nsid=0&d_mid=12349850857640731290890207735189050123&
d_blob=6G1ynYcLPuiQxYZrsz_pkqfLG9yMXBpb2zX5dvJdYQJzPXImdj0y&
d_cid_ic=email%a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097%011&
ts=1563299964843

 

Reportez-vous au tableau ci-dessous pour obtenir une description du paramètre d_cid_ic et de l’état d’authentification.

Paramètre Description
d_cid_ic Transmet le code d’intégration, l’ID d’utilisateur unique (DPUUID) et un ID d’état authentifié au service d’ID. Séparez le code d’intégration et le DPUUID par le caractère de contrôle non imprimable %01 :
Exemple : d_cid_ic=Integration_code%01DPUUID%01Authentication_state
État d’authentification
Il s’agit d’un ID facultatif dans le paramètre d_cid_ic. Exprimé sous la forme d’un entier, il identifie les utilisateurs en fonction de leur état d’authentification comme indiqué ci-dessous :
  • 0 (inconnu ou jamais authentifié)
  • 1 (actuellement authentifié pour cette instance, cette page ou ce contexte d’application)
  • 2 (déconnecté)

Exemples :
  • Inconnu : …d_cid=123%01456%010
  • Authentifié : …d_cid=123%01456%011
  • Déconnecté : …d_cid=123%01456%012

Ajout d’une Action dans Adobe Experience Platform Launch

Experience Platform Launch représente la nouvelle génération des fonctionnalités de gestion des balises d’Adobe. Pour en savoir plus sur le lancement, consultez la documentation du produit de lancement.

Pour ajouter une action dans Lancement, consultez la documentation des règles dans Lancement d'Adobe et consultez la capture d'écran ci-dessous :


 

Après avoir confirmé votre configuration, Launch place les données dans un objet, comme ci-dessous :

{
    integration_code: {
        id: "value",
        authState: auth_state,
        hashType: "hash_algorithm"
    }
}

Voici un exemple de code :

// Set single customer ID with hash type
setCustomerIDs(Ingeration code: {
    id: "string_value",
    authState: auth_state,
    hashType: "hash_algorithm"
});

Comme pour la méthode setCustomerIDs décrite dans la première section, il en découle un appel au service Experience Cloud ID, auquel est ajouté le paramètre de requête d_cid_ic.

Sur cette page