Wenn Audience Manager Segmentinformationen an einen Datenpartner sendet, identifiziert er diese Objekte mit numerischen IDs. Wenn Sie als Datenpartner diese Informationen an Ihre Kunden weitergeben (oder selbst daran arbeiten), bieten ein tatsächlicher Name und eine Beschreibung eine bessere Kundenerfahrung in Berichten, Dashboards oder anderen Benutzeroberflächen (UI). Datenpartner können diese Anzeigenamen ihren Kunden entweder mit den in diesem Abschnitt beschriebenen manuellen oder automatisierten Methoden zur Verfügung stellen.
Als Datenpartner sind Sie wahrscheinlich daran gewöhnt, Audiencen-Metadaten von Ihren Kunden über manuelle Prozesse zu erhalten. Dazu könnten Dateien gehören, die an E-Mails oder von Kunden angehängt werden, die diese Daten über ein UI hinzufügen, das Sie zu diesem Zweck erstellt und gepflegt haben. Diese Prozesse funktionieren, sind aber oft umständlich und zeitaufwendig und erfordern möglicherweise eine manuelle Dateneingabe. Diese Methoden werden häufig verwendet, um eine Integration schnell zu implementieren, bieten aber langfristig nicht die beste Kundenerfahrung. Alternativ können Sie die Audience Manager API verwenden, um Segmentmetadaten automatisch abzurufen.
Audience Manager stellt eine Reihe von REST- APIs bereit, mit denen Sie Segmentmetadaten automatisch abrufen können. Mit dem API können Sie Aufträge erstellen, die Segmentmetadaten in eingeplanten Intervallen oder automatisch abrufen, wenn Sie Audience Manager-Daten verarbeiten und eine neue Segment-ID suchen. Weitere Informationen finden Sie in den unten stehenden Schritten.
Der Abschnitt Erste Schritte mit REST-APIs enthält Informationen zu allgemeinen Anforderungen, Authentifizierung, verfügbaren Methoden usw. Dies ist ein guter Ausgangspunkt, wenn Sie noch nicht mit Audience Manager API gearbeitet haben.
Sie benötigen eine Client-ID und ein Geheimnis, um API-Aufrufe durchzuführen. Sie können während des Integrationsprozesses eine Client-ID und ein Geheimnis von Ihrem Integrationsspezialisten abrufen. Sie können auch eine E-Mail-Anfrage an Audience Manager Customer Care unter amsupport@adobe.com senden.
Fordern Sie bei jedem integrierten Kunden Folgendes an:
Nach Abschluss der vorherigen Schritte können Sie eine GET
-Methode zum Abrufen von Segmentmetadaten verwenden. Eine Beispielanforderung und -antwort finden Sie unter Zuordnungen rückkehrender Ziele. Dieser Aufruf gibt Segmentdaten zurück, die als Schlüssel-Wert-Paare in einem JSON-Objekt formatiert sind. Einige der wichtigen Segmentattribute, die in der Antwort zurückgegeben werden, sind in der folgenden Tabelle aufgeführt.
Parameter | Beschreibung |
---|---|
|
Die Segment-ID des -Audience Managers. |
|
Der Segmentname. |
|
Ein Text, der das Segment kurz beschreibt. |
|
Der aktuelle Status der Segmentzuordnung. Zu den Rückgabestatusoptionen gehören:
|