Configuration de l’espace de noms d’identité

Dernière mise à jour : 2024-01-25
  • Créé pour :
  • Admin
    User

Experience Platform utilise des espaces de noms d’identité pour décrire le type d’identités spécifiques. Par exemple, un espace de noms d’identité intitulé Email identifie une valeur telle que name@email.com en tant qu’adresse électronique.

Pendant la création d’une destination avec Destination SDK, vous pouvez non seulement configurer un schéma de partenaire auquel les utilisateurs peuvent mapper des attributs de profil et des identités, mais aussi définir des espaces de noms d’identité pris en charge par votre plateforme de destination.

Dans ce cas, les utilisateurs ont également la possibilité de sélectionner des identités cibles, en plus des attributs de profil cible.

Pour en savoir plus sur les espaces de noms d’identité dans Experience Platform, consultez la documentation relative aux espaces de noms d’identité.

Pendant la configuration des espaces de noms d’identité pour la destination, vous pouvez affiner le mapping de ciblage d’identité pris en charge par la destination, par exemple :

Pour comprendre où ce composant entre dans une intégration créée avec Destination SDK, reportez-vous au diagramme de la section options de configuration ou consulter le guide sur la manière d’effectuer utiliser la Destination SDK pour configurer une destination basée sur des fichiers ;.

Vous pouvez configurer vos espaces de noms d’identité pris en charge via le point d’entrée /authoring/destinations. Pour obtenir des exemples d’appels API détaillés dans lesquels vous pouvez configurer les composants affichés sur cette page, consultez les pages de référence de l’API suivantes.

Cet article décrit toutes les options de configuration de noms d’identité prises en charge que vous pouvez utiliser pour la destination et montre ce que la clientèle verra dans l’interface utilisateur de Platform.

IMPORTANT

Tous les noms et toutes les valeurs de paramètre pris en charge par Destination SDK sont sensibles à la casse. Pour éviter les erreurs de respect de la casse, utilisez les noms et valeurs des paramètres exactement comme indiqué dans la documentation.

Types d’intégration pris en charge

Pour en savoir plus sur les types d’intégration qui prennent en charge les fonctionnalités décrites sur cette page, consultez le tableau ci-dessous.

Type d’intégration Fonctionnalité de prise en charge
Intégrations en temps réel (streaming) Oui
Intégrations basées sur des fichiers (par lots) Oui

Paramètres pris en charge

Pendant la définition des identités cibles prises en charge par la destination, vous pouvez utiliser les paramètres décrits dans le tableau ci-dessous pour configurer leur comportement.

Paramètre Type Obligatoire / Facultatif Description
acceptsAttributes Booléen Facultatif Indique si la clientèle peut mapper des attributs de profil standard à l’identité que vous configurez.
acceptsCustomNamespaces Booléen Facultatif Indique si la clientèle peut mapper des espaces de noms d’identité personnalisés à l’espace de noms d’identité que vous configurez.
acceptedGlobalNamespaces - Facultatif Indique quels espaces de noms d’identité standard (par exemple, la clientèle IDFA) peut mapper l’identité que vous configurez.
transformation Chaîne Facultatif Affiche la case Apply transformation (Appliquer la transformation) dans l’interface utilisateur de Platform, quand le champ source est un attribut XDM ou un espace de noms d’identité personnalisée. Utilisez cette option pour permettre aux utilisateurs de hacher les attributs sources au moment de l’exportation. Pour activer cette option, définissez la valeur sur sha256(lower($)).
requiredTransformation Chaîne Facultatif Quand la clientèle sélectionne cet espace de noms d’identité source, la case Apply transformation (Appliquer la transformation) est automatiquement cochée pour le mappage et il n’est pas possible de la décocher. Pour activer cette option, définissez la valeur sur sha256(lower($)).
"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

Vous devez indiquer quelles identités Platform les clients peuvent exporter vers votre destination. Voici quelques exemples : Experience Cloud ID, e-mail haché, identifiant de l’appareil (IDFA, GAID). Ces valeurs sont des espaces de noms d’identité Platform que la clientèle peut mapper aux espaces de noms d’identité de la destination.

Une correspondance 1 à 1 entre Platform et votre destination n’est pas obligatoire dans les espaces de noms d’identités. Par exemple, les clients peuvent mapper un espace de nom Platform IDFA à un espace de noms IDFA depuis votre destination ou mapper le même espace de noms Platform IDFA à un espace de noms Customer ID dans votre destination.

Apprenez-en plus sur les identités dans la présentation des espaces de noms d’identité.

Considérations relatives au mappage

Si la clientèle sélectionne un espace de noms d’identité source, mais pas de mapping de ciblage, Platform le renseigne automatiquement avec un attribut du même nom.

Configuration du hachage facultatif des champs sources

La clientèle Experience Platform peut choisir d’ingérer des données dans Platform au format haché ou en texte brut. Si votre plateforme de destination accepte les données hachées et non hachées, vous pouvez permettre à la clientèle de choisir si Platform doit hacher les valeurs des champs sources quand elles sont exportées vers la destination.

La configuration ci-dessous active l’option facultative Apply transformation (Appliquer la transformation) dans l’interface utilisateur de Platform, à l’étape Mappage.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
            },
            "Phone":{
            }
         }
      }
   }

Cochez cette option lorsque vous utilisez des champs sources non hachés afin qu’Adobe Experience Platform les hache automatiquement au moment de l’activation.

Quand vous mappez des attributs source non hachés avec des attributs cibles qui sont censés être hachés (par exemple, email_lc_sha256 ou phone_sha256), cochez l’option Apply transformation (Appliquer la transformation) pour qu’Adobe Experience Platform hache automatiquement les attributs source au moment de l’activation.

Configuration du hachage obligatoire des champs sources

Si la destination accepte uniquement les données hachées, vous pouvez configurer les attributs exportés pour qu’ils soient automatiquement hachés par Platform. La configuration ci-dessous vérifie automatiquement l’option Apply transformation (Appliquer la transformation) quand les identités Email et Phone sont mappées.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation": "sha256(lower($))"
            },
            "Phone":{
               "requiredTransformation": "sha256(lower($))"
            }
         }
      }
   }

Étapes suivantes

Vous êtes arrivé au bout de cet article. À présent, vous devriez mieux comprendre comment configurer vos espaces de noms d’identité pour les destinations créées avec Destination SDK.

Pour en savoir plus sur les autres composants de destination, consultez les articles suivants :

Sur cette page