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

Le service d’identification des visiteurs (ECID) prend en charge l’algorithme de hachage SHA-256 qui vous permet de transmettre des ID de client ou des adresses e-mail et de distribuer des ID hachés. Il s’agit d’une méthode JavaScript facultative pour envoyer des identifiants hachés à CX Enterprise. 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’ECID, vous pouvez associer d’autres ID de client, un statut 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 charger ces identifiants en tant qu’attributs du client vers l’expérience client d’entreprise 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 entraîne un appel au service d’identification des visiteurs, à dpm.demdex.net, avec l’ajout du paramètre de requête d_cid_ic, qui contient l’ID 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’identification des visiteurs. Séparez le code d’intégration et 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

Ajouter une action dans les balises add-action-launch

Les balises dans la collecte de données Adobe Experience Platform représentent la nouvelle génération des fonctionnalités de gestion des balises d’Adobe. Pour en savoir plus, consultez la documentation sur les balises.

Pour ajouter une action dans les balises, consultez la documentation rules et la capture d’écran ci-dessous :

Après avoir confirmé votre configuration, les balises encapsulent 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"
});

De la même manière que pour la méthode setCustomerIDs décrite dans la première section, il en résulte un appel au service d’identification des visiteurs, avec l’ajout du paramètre de requête d_cid_ic.

recommendation-more-help
id-service-help