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