Gérer les métadonnées d’audience
Utilisez les modèles de métadonnées d’audience pour créer, mettre à jour ou supprimer des audiences par programmation dans votre destination. Adobe fournit un modèle de métadonnées d’audience extensible que vous pouvez configurer en fonction des spécifications de votre API marketing. Une fois la configuration définie, testée et envoyée, elle sera utilisée par Adobe pour structurer les appels API vers votre destination.
Vous pouvez configurer les fonctionnalités décrites dans ce document à l’aide du point d’entrée de lʼAPI /authoring/audience-templates
. Consultez la section Création d’un modèle de métadonnées pour obtenir une liste complète des opérations que vous pouvez effectuer sur le point d’entrée.
Quand utiliser le point d’entrée de la gestion des métadonnées d’audience when-to-use
Selon la configuration de votre API, vous devrez peut-être utiliser le point d’entrée de la gestion des métadonnées d’audience, car vous configurez votre destination dans Experience Platform. Utilisez le diagramme d’arborescence de décision ci-dessous pour savoir quand utiliser le point d’entrée des métadonnées d’audience et comment configurer un modèle de métadonnées d’audience pour votre destination.
Cas d’utilisation pris en charge par la gestion des métadonnées d’audience use-cases
Grâce à la prise en charge des métadonnées d’audience dans Destination SDK, lors de la configuration de votre destination Experience Platform, vous pouvez proposer aux utilisateurs et utilisatrices de Platform de choisir entre plusieurs options lorsqu’ils mappent et activent des audiences vers votre destination. Vous pouvez contrôler les options disponibles pour l’utilisateur via les paramètres de la section Configuration des métadonnées d’audience de la configuration de destination.
Cas d’utilisation 1 : vous disposez d’une API tierce et les utilisateurs et utilisatrices n’ont pas besoin de saisir les identifiants de mappage
Si vous disposez d’un point d’entrée de l’API pour créer/mettre à jour/supprimer des audiences, vous pouvez utiliser des modèles de métadonnées d’audience pour configurer Destination SDK afin qu’il corresponde aux spécifications de votre point d’entrée de création/mise à jour/suppression d’audiences. Experience Platform peut créer/mettre à jour/supprimer des audiences par programmation et synchroniser les métadonnées avec Experience Platform.
Lors de l’activation d’audiences vers votre destination dans l’interface utilisateur (IU) dʼExperience Platform, les personnes n’ont pas besoin de remplir manuellement un champ d’identifiant de mappage d’audiences dans le workflow d’activation.
Cas d’utilisation 2 : les personnes doivent d’abord créer une audience dans votre destination et saisir manuellement l’identifiant de mappage
Si des audiences et d’autres métadonnées doivent être créées manuellement par des partenaires ou des personnes dans votre destination, les personnes doivent renseigner manuellement le champ identifiant de mappage d’audiences dans le workflow d’activation pour synchroniser les métadonnées d’audiences entre votre destination et Experience Platform.
Cas d’utilisation 3 : votre destination accepte l’identifiant d’audience Experience Platform et les personnes n’ont pas besoin de saisir manuellement l’identifiant de mappage
Si votre système de destination accepte l’identifiant de l’audience Experience Platform, vous pouvez le configurer dans votre modèle de métadonnées d’audience. Les personnes n’ont pas à renseigner d’identifiant de mappage d’audience lors de l’activation d’un segment.
Modèle d’audience générique et extensible generic-and-extensible
Afin de prendre en charge les cas d’utilisation répertoriés ci-dessus, Adobe fournit un modèle générique qui peut être personnalisé pour s’adapter aux spécifications de votre API.
Vous pouvez utiliser le modèle générique pour créer un modèle d’audience si votre API prend en charge les éléments suivants :
- Méthodes HTTP : POST, GET, PUT, DELETE et PATCH
- Types d’authentification : OAuth 1, OAuth 2 avec jeton d’actualisation et OAuth 2 avec jeton porteur
- Fonctions : créer une audience, mettre à jour une audience, obtenir une audience, supprimer une audience et valider des informations d’identification
L’équipe d’ingénieurs Adobe peut collaborer avec vous pour développer le modèle générique avec des champs personnalisés si vos cas d’utilisation le demandent.
Événements de modèle pris en charge supported-events
Le tableau ci-dessous décrit les événements pris en charge par les modèles de métadonnées d’audience.
create
update
delete
validate
notify
createDestination
updateDestination
deleteDestination
Exemples de configurations configuration-examples
Cette section comprend des exemples de configurations de métadonnées d’audience génériques, à titre de référence.
Notez les différences entre l’URL, les en-têtes et les corps de requête entre les trois exemples de configuration. Cela est dû aux différentes spécifications de l’API marketing des trois exemples de plateformes.
Notez que dans certains exemples les champs de macro tels que {{authData.accessToken}}
ou {{segment.name}}
sont utilisés dans l’URL et que dans d’autres exemples ils sont utilisés dans les en-têtes ou dans le corps de la requête. Leur utilisation dépend de vos spécifications d’API marketing.
code language-json |
---|
|
code language-json |
---|
|
code language-json |
---|
|
code language-json |
---|
|
Recherchez des descriptions de tous les paramètres du modèle dans la référence de l’API Création d’un modèle d’audience.
Macros utilisées dans les modèles de métadonnées d’audience macros
Afin de transmettre des informations telles que des ID d’audience, des jetons d’accès, des messages d’erreur, etc. entre Experience Platform et votre API, les modèles d’audience incluent des macros que vous pouvez utiliser. Lisez ci-dessous une description des macros utilisées dans les trois exemples de configuration de cette page :
{{segment.alias}}
{{segment.name}}
{{segment.id}}
{{customerData.accountId}}
{{oauth2ServiceAccessToken}}
{{authData.accessToken}}
{{authData.accessToken}}
si Experience Platform doit utiliser des jetons non expirants pour se connecter à votre destination, sinon utilisez {{oauth2ServiceAccessToken}}
pour générer un jeton d’accès.{{body.segments[0].segment.id}}
externalAudienceId
.{{error.message}}
{{{segmentEnrichmentAttributes}}}
create
, update
et delete
. Les attributs d’enrichissement sont disponibles uniquement pour les audiences de chargement personnalisées. Consultez le guide d’activation de l’audience par lot pour voir comment fonctionne la sélection des attributs d’enrichissement.{{destination.name}}
{{destination.sandboxName}}
{{destination.id}}
{{destination.imsOrgId}}
{{destination.enrichmentAttributes}}
createDestination
, updateDestination
et deleteDestination
. Les attributs d’enrichissement sont disponibles uniquement pour les audiences de chargement personnalisées. Consultez le guide d’activation de l’audience par lot pour voir comment fonctionne la sélection des attributs d’enrichissement.{{destination.enrichmentAttributes.<namespace>.<segmentId>}}