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

Dernière mise à jour : 2021-06-01
  • Rubriques :
  • Segments
    Afficher plus sur ce sujet

Lorsque l’Audience Manager envoie des informations de segment à un partenaire de données, elle identifie ces objets à l’aide d’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, 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 par le biais de processus manuels. Cela peut inclure des fichiers joints aux emails ou des clients ajoutant ces données par le biais d’une UI 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 faciliter la mise en service rapide d’une intégration, mais elles ne fournissent pas la meilleure expérience client à long terme. Vous pouvez également utiliser la balise Audience Manager API pour obtenir automatiquement des métadonnées de segment.

Méthode automatisée

Audience Manager fournit un ensemble d’ API REST qui vous permettent 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 des données Audience Manager et recherchez un nouvel identifiant 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 client et un secret auprès de votre spécialiste de l’intégration lors du 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 : Collecter des informations spécifiques aux clients à 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 de l’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 API

Après avoir suivi 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 Mappages de destination des retours. Cet appel renvoie des données de segment formatées en tant que 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 qui décrit brièvement le segment.

elementStatus

État actuel du mappage de segments. Les options d’état renvoyé incluent :

  • active
  • inactive
  • deleted

Sur cette page