Abrufen von Segmentmetadaten retrieving-segment-metadata

Wenn Audience Manager Segmentinformationen an einen Datenpartner sendet, werden diese Objekte mit numerischen IDs identifiziert. Wenn Sie als Datenpartner diese Informationen mit Ihren Kunden teilen (oder selbst damit arbeiten), bieten ein tatsächlicher Name und eine Beschreibung ein besseres Erlebnis für Kunden in Berichten, Dashboards oder anderen Benutzeroberflächen (UI). Datenpartner können diese benutzerfreundlichen Namen ihren Kunden entweder mit den in diesem Abschnitt beschriebenen manuellen oder automatisierten Methoden zur Verfügung stellen.

Manuelle Methode manual-method

Als Datenpartner sind Sie wahrscheinlich daran gewöhnt, Zielgruppen-Metadaten von Ihren Kunden durch manuelle Prozesse zu erhalten. Dazu können Dateien gehören, die an E-Mails angehängt sind oder von Kunden stammen, die diese Daten über eine UI hinzufügen, die Sie zu diesem Zweck erstellt und gepflegt haben. Diese Prozesse funktionieren, sind jedoch häufig umständlich, zeitaufwendig und erfordern möglicherweise eine manuelle Dateneingabe. Diese Methoden werden häufig verwendet, um eine Integration schnell einzurichten und auszuführen, bieten aber auf lange Sicht nicht das beste Kundenerlebnis. Alternativ können Sie den Audience Manager-API verwenden, um Segmentmetadaten automatisch abzurufen.

Automatisierte Methode automated-method

Audience Manager bietet eine Reihe von REST-APIs mit denen Sie Segmentmetadaten automatisch abrufen können. Mit dem API können Sie Aufträge erstellen, die Segmentmetadaten in terminierten Intervallen oder automatisch abrufen, wenn Sie Audience Manager verarbeiten und eine neue Segment-ID finden. Weitere Informationen finden Sie in den folgenden Schritten.

Schritt 1: Überprüfen Sie die Audience Manager-APIs

Der Erste Schritte mit REST-" enthält Informationen zu allgemeinen Anforderungen, Authentifizierung, verfügbaren Methoden usw. Dies ist ein guter Ausgangspunkt, wenn Sie noch nie mit dem Audience Manager API gearbeitet haben.

Schritt 2: OAuth2-Zugriffsberechtigungen anfordern

Sie benötigen eine Client-ID und ein Geheimnis, um API Aufrufe durchzuführen. Sie können während des Einrichtungsprozesses für die Integration eine Client-ID und ein Geheimnis von Ihrem Integrationsspezialisten erhalten. Sie können auch eine E-Mail-Anfrage an Audience Manager Customer Care unter amsupport@adobe.com senden.

Schritt 3: Erfassen kundenspezifischer Informationen von jedem integrierten Kunden

Fordern Sie bei jedem integrierten Kunden Folgendes an:

Schritt 4: Abrufen von Segmentmetadaten mit einem API-Aufruf

Nachdem Sie die vorherigen Schritte abgeschlossen haben, können Sie eine GET-Methode verwenden, um Segmentmetadaten abzurufen. Eine Beispielanfrage und -antwort finden Sie unter Rückgabe von Zielzuordnungen. 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.