Prise en charge du hachage SHA-256 pour setCustomerIDs hashing-support

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 :

Utiliser la méthode setCustomerIDs dans ECID use-setcustomerids-method

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 e-mail « 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 e-mail 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. 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.

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%01 0
  • Authentifié : …d_cid=123%01456%01 1
  • Déconnecté : …d_cid=123%01456%01 2

Ajouter une action dans Adobe Experience Platform Launch add-action-launch

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

Pour ajouter une action à Launch, consultez la documentation sur les règles dans Adobe Launch et reportez-vous à 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.

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