Configuration de l’espace de noms d’identité

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.

Lors de la création de destinations en temps réel (diffusion en continu) via Destination SDK, en plus des configuration d'un schéma de partenaire pour que les utilisateurs puissent mapper des attributs de profil et des identités à, vous devez également définir des espaces de noms d’identité pris en charge par votre plateforme de destination. Par exemple, si votre plateforme de destination accepte des courriers électroniques hachés et IDFA, vous devez définir ces deux identités comme décrit plus loin dans ce document.

Lors de l’activation d’audiences vers des destinations de diffusion en continu, les utilisateurs doivent également mapper des identités cibles, en plus des attributs de profil cible. Sinon, les audiences ne seront pas activées sur la plateforme de destination.

Lors de la création d’une destination basée sur des fichiers via Destination SDK, la configuration des espaces de noms d’identité est facultative.

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.

Types d’intégration pris en charge supported-integration-types

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.

Paramètres pris en charge supported-parameters

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.

"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 next-steps

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 :