Récupération des métadonnées de segment retrieving-segment-metadata

Lorsqu’Audience Manager envoie des informations sur les segments à un partenaire de données, il identifie ces objets par des identifiants numériques. En tant que partenaire de données, lorsque vous partagez ces informations avec vos clients (ou que vous les utilisez 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 à l’aide des méthodes manuelles ou automatisées décrites dans cette section.

Méthode manuelle manual-method

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. Il peut s’agir de fichiers joints à des e-mails ou provenant de clients qui ajoutent ces données par le biais d’un UI que vous avez créé et géré à cet effet. Ces processus fonctionnent, mais ils sont souvent lourds, longs et peuvent nécessiter un travail de saisie manuelle des données. Ces méthodes sont souvent utilisées pour aider à mettre rapidement en route une intégration, mais elles ne fournissent pas la meilleure expérience client à long terme. Vous pouvez également utiliser l’Audience Manager API pour obtenir automatiquement des métadonnées de segment.

Méthode automatisée automated-method

Audience Manager fournit un ensemble d’API REST qui vous permettent de récupérer automatiquement les métadonnées des segments. Avec le API, vous pouvez créer des tâches qui récupèrent des métadonnées de segment à intervalles planifiés ou automatiquement, chaque fois que vous traitez des données de Audience Manager et recherchez un nouvel identifiant de segment. Pour plus d’informations, reportez-vous aux étapes ci-dessous.

Étape 1 : vérifier les API 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 déjà travaillé avec le Audience Manager API.

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

Vous avez besoin d’un identifiant client et d’un secret pour effectuer des appels API. Vous pouvez obtenir un identifiant 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 e-mail à Audience Manager Customer Care sur amsupport@adobe.com.

Étape 3 : collecter des informations spécifiques au client auprès de chaque client intégré

Demandez les éléments suivants à chaque client intégré :

Étape 4 : récupérer les 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 du segment. Pour obtenir un exemple de requête et de réponse, voir Renvoi des mappages de destination. 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.