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.
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.
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.
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.
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.
Demandez ce qui suit à chaque client intégré :
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 |
---|---|
|
ID de segment Audience Manager. |
|
Nom du segment. |
|
Texte qui décrit brièvement le segment. |
|
État actuel du mappage de segments. Les options d’état renvoyé incluent :
|