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.

Selon le type de destination que vous créez (en flux continu ou basé sur des fichiers), gardez à l’esprit les exigences d’espace de noms d’identité suivantes :

  • Lors de la création de destinations en temps réel (streaming) via Destination SDK, vous devez non seulement configurer un schéma de partenaire auquel vous pouvez mapper des attributs de profil et des identités, mais aussi définir au moins un espace de noms d’identité pris en charge par votre plateforme de destination. Par exemple, si votre plateforme de destination accepte les e-mails et les IDFA hachés, vous devez définir ces deux identités comme décrit plus bas dans ce document.

    note important
    IMPORTANT
    Lors de l’activation des audiences vers des destinations de diffusion en continu, vous devez également mapper au moins une identité cible, en plus des attributs de profil cible. Dans le cas contraire, les audiences ne sont pas activées pour 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 facultative.

Pour en savoir plus sur les espaces de noms d’identité dans Experience Platform, consultez la documentation ​ 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 la place de ce composant dans une intégration créée avec Destination SDK, consultez le diagramme de la documentation options de configuration ou consultez le guide sur la utilisation de 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 vous voyez dans l’interface utilisateur de Experience 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 vous pouvez mapper des attributs de profil standard à l’identité que vous êtes en train de configurer.
acceptsCustomNamespaces
Booléen
Facultatif
Indique si vous pouvez mapper des espaces de noms d’identité personnalisés à l’espace de noms d’identité que vous êtes en train de configurer.
acceptedGlobalNamespaces
-
Facultatif
Indique quels espaces de noms d’identité standard (par exemple, IDFA) vous pouvez mapper à l’identité que vous configurez.
transformation
Chaîne
Facultatif
Affiche la case Apply transformation dans l’interface utilisateur Experience Platform, lorsque le champ source est un attribut XDM ou un espace de noms d’identité personnalisée. Utilisez cette option pour hacher les attributs sources lors de l’exportation. Pour activer cette option, définissez la valeur sur sha256(lower($)).
requiredTransformation
Chaîne
Facultatif
Lorsque vous sélectionnez cet espace de noms d’identité source, la case Appliquer la transformation est automatiquement cochée pour le mappage et vous ne pouvez pas la désactiver. 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 les identités Experience Platform que vous pouvez exporter vers la destination. Voici quelques exemples : Experience Cloud ID, e-mail haché, identifiant de l’appareil (IDFA, GAID). Ces valeurs sont Experience Platform espaces de noms d’identité que vous pouvez mapper aux espaces de noms d’identité de la destination.

Les espaces de noms d’identité ne nécessitent pas de correspondance 1-1 entre Experience Platform et votre destination. Par exemple, vous pouvez mapper un espace de noms IDFA Experience Platform à un espace de noms IDFA depuis votre destination ou mapper le même espace de noms IDFA Experience Platform à 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 mapping-considerations

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

Configuration du hachage facultatif des champs sources configure-optional-hashing

Dans Experience Platform, vous pouvez choisir d’ingérer des données au format haché ou en texte brut. Si votre plateforme de destination accepte les données hachées et non hachées, vous pouvez choisir de hacher ou non Experience Platform valeurs des champs sources lorsqu’elles sont exportées vers la destination.

La configuration ci-dessous active l’option facultative Apply transformation dans l’interface utilisateur de Experience 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 lors de l’activation.

Lorsque 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 pour que Adobe Experience Platform hache automatiquement les attributs source au moment de l’activation.

Configuration du hachage obligatoire des champs sources configure-mandatory-hashing

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 Experience 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 savez désormais comment configurer des espaces de noms d’identité pour les destinations créées avec Destination SDK, y compris comment autoriser les mappages d’attributs et d’espaces de noms et comment appliquer un hachage facultatif ou obligatoire sur l’exportation.

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

recommendation-more-help
experience-platform-help-destinations