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.

En fonction du type de destination que vous créez (en flux continu ou basé sur un fichier), gardez à l’esprit les exigences d’espace de noms d’identité suivantes :

  • Lors de la création de destinations en temps réel (diffusion en continu) via Destination SDK, en plus de la configuration d’un schéma de partenaire vers lequel les utilisateurs peuvent mapper des attributs de profil et des identités, vous devez également définir au moins un espaces de noms d’identité pris en charge par votre plateforme de destination. Par exemple, si votre plateforme de destination accepte des emails hachés et IDFA, vous devez définir ces deux identités comme décrit plus bas dans ce document.

    note important
    IMPORTANT
    Lors de l’activation d’audiences vers des destinations de diffusion en continu, les utilisateurs doivent également mapper au moins une identité cible, 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 de destinations basées sur des fichiers via Destination SDK, la configuration des espaces de noms d’identité est facultatif.

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 documentation options de configuration ou consultez le guide sur la manière d’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 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.

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

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.

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 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 :

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6