Show Menu
SUJETS×

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

Lorsqu’Audience Manager envoie des informations de segment à un partenaire de données, il identifie ces objets avec des ID 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 aux clients dans les rapports, les tableaux de bord ou d’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 qui ajoutent ces données par le biais d’une UI instance que vous avez créée et gérée à cette fin. Ces processus fonctionnent, mais ils sont souvent lourds, prennent du temps et peuvent nécessiter un travail manuel de saisie 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 le Audience Manager pour API obtenir automatiquement les métadonnées de segment.

Méthode automatisée

Audience Manager fournit un ensemble d’API API REST 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 à des intervalles planifiés ou automatiquement, chaque fois que vous traitez Audience Manager des données et recherchez 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 endroit pour commencer si vous n'avez pas travaillé avec le Audience Manager passé API .

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

Vous avez besoin d’un ID client et d’un secret pour passer API des appels. Vous pouvez obtenir un ID 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 l’adresse amsupport@adobe.com.

Étape 3 : Collecte d’informations spécifiques au client à partir de chaque client intégré

Demandez ce qui suit à chaque client intégré :
  • 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’ID (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 API

Après avoir exécuté les étapes précédentes, vous pouvez utiliser une GET méthode pour récupérer les métadonnées de segment. Pour obtenir un exemple de requête et de réponse, voir Mappages des destinations de retour . Cet appel renvoie des données de segment formatées en paires clé-valeur dans un JSON objet. 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é sont les suivantes :
  • actif
  • inactif
  • supprimé