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 :
- Vous permettant de mapper des attributs XDM aux espaces de noms d’identité.
- Vous permettant de mapper des espaces de noms d’identité standard à vos propres espaces de noms d’identité.
- Vous permettant de mapper des espaces de noms d’identité personnalisés à vos propres espaces de noms d’identité.
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.
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.
acceptsAttributesacceptsCustomNamespacesacceptedGlobalNamespacestransformationsha256(lower($)).requiredTransformationsha256(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 :
- Authentification du client
- Autorisation OAuth2
- Champs de données client
- Attributs de l’interface utilisateur
- Configuration du schéma
- Configuration de l’espace de noms d’identité
- Configurations de mappage prises en charge
- Diffusion de destination
- Configuration des métadonnées d’audience
- Politique d’agrégation
- Configuration par lots
- Qualifications des profils historiques