Récupération des métadonnées de segment

Lorsque l’Audience Manager envoie des informations de segment à un partenaire de données, elle les identifie avec des identifiants numériques. En tant que partenaire de données, lorsque vous partagez ces informations avec vos clients (ou travaillez avec eux vous-même), un nom et une description réels offrent une meilleure expérience pour les clients dans les rapports, tableaux de bord ou autres interfaces utilisateur (UI). Les partenaires de données peuvent mettre ces noms conviviaux à la disposition de leurs clients avec les méthodes manuelles ou automatisées décrites dans cette section.

Méthode manuelle

En tant que partenaire de données, vous êtes probablement habitué à obtenir des métadonnées d’audience de vos clients au moyen de processus manuels. Cela peut inclure des fichiers joints à des courriels ou des clients ajoutant ces données par le biais d'une UI que vous avez créée et conservée à cette fin. Ces processus fonctionnent, mais ils sont souvent lourds, prennent du temps et peuvent nécessiter une saisie manuelle des données. Ces méthodes sont souvent utilisées pour aider à mettre rapidement en oeuvre une intégration, mais elles ne fournissent pas la meilleure expérience client à long terme. Vous pouvez également utiliser Audience Manager API pour obtenir automatiquement les métadonnées de segment.

Méthode automatisée

Audience Manager fournit un ensemble d’ API REST qui vous permet de récupérer automatiquement les métadonnées de segment. Avec API, vous pouvez créer des tâches qui récupèrent les métadonnées de segment à intervalles réguliers ou automatiquement, chaque fois que vous traitez les données Audience Manager et que vous trouvez un nouvel ID de segment. Pour plus d’informations, voir les étapes ci-dessous.

Étape 1 : Vérification des API d’Audience Manager

La section Prise en main des API REST contient des informations sur les exigences générales, l'authentification, les méthodes disponibles, etc. C'est un bon point de départ si vous n'avez pas travaillé avec Audience Manager API auparavant.

Étape 2 : Demande d’informations d’identification d’accès OAuth2

Vous avez besoin d'un ID client et d'un secret pour effectuer des appels API. Vous pouvez obtenir un ID de client et un secret auprès de votre spécialiste de l’intégration pendant le processus de configuration de l’intégration. Vous pouvez également envoyer une demande par courrier électronique à Audience Manager Customer Care à amsupport@adobe.com.

Étape 3 : Collecter des informations spécifiques aux clients de chaque client intégré

Demandez à chaque client intégré ce qui suit :

  • Nom d'utilisateur : Il s’agit d’un utilisateur restreint disposant d’autorisations en lecture seule pour la destination associée à une intégration spécifique.
  • Mot de passe : Mot de passe utilisateur.
  • ID de destination : Il s’agit de l’identifiant (entier) associé à la destination créée pour l’intégration serveur à serveur spécifique.

Étape 4 : Récupération des métadonnées de segment avec un appel d’API

Après avoir exécuté les étapes précédentes, vous pouvez utiliser une méthode GET pour récupérer les métadonnées de segment. Pour un exemple de requête et de réponse, voir Correspondances de destination de retour. Cet appel renvoie des données de segment formatées en paires clé-valeur dans un objet JSON. Certains des attributs de segment importants renvoyés dans la réponse sont répertoriés dans le tableau suivant.

Paramètre Description

destinationMappingId

ID de segment Audience Manager.

elementName

Nom du segment.

elementDescription

Texte décrivant brièvement le segment.

elementStatus

Statut actuel du mappage de segments. Les options d’état renvoyées sont les suivantes :

  • active
  • inactive
  • deleted

Sur cette page