Abrufen von Segmentmetadaten

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 Anzeigenamen ihren Kunden entweder mit den in diesem Abschnitt beschriebenen manuellen oder automatisierten Methoden zur Verfügung stellen.

Manuelle Methode

Als Datenpartner sind Sie wahrscheinlich daran gewöhnt, durch manuelle Prozesse Zielgruppen-Metadaten von Ihren Kunden abzurufen. Dazu können Dateien gehören, die an E-Mails angehängt sind, oder von Kunden, die diese Daten über ein UI hinzufügen, das 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 zu implementieren, bieten aber langfristig nicht das beste Kundenerlebnis. Alternativ können Sie Audience Manager API verwenden, um Segmentmetadaten automatisch abzurufen.

Automatisierte Methode

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

Schritt 1: Überprüfen der Audience Manager-APIs

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.

Schritt 2: Zugriffsberechtigungen für OAuth2 anfordern

Sie benötigen eine Client-ID und ein Geheimnis, um API -Aufrufe durchzuführen. Sie können während der Einrichtung der 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:

Benutzername: Dies ist für einen eingeschränkten Benutzer mit schreibgeschützten Berechtigungen für das Ziel, das mit einer bestimmten Integration verknüpft ist.
Kennwort: Das Benutzerkennwort.
Ziel-ID: Dies ist die ID (eine Ganzzahl), die mit dem Ziel verknüpft ist, das für die spezifische Server-zu-Server-Integration erstellt wurde.

Schritt 4: Abrufen von Segmentmetadaten mit einem API-Aufruf

Nach Abschluss der vorherigen Schritte können Sie eine GET-Methode verwenden, um Segmentmetadaten abzurufen. Eine Beispielanfrage und -antwort finden Sie unter Rückkehrziel-Zuordnungen. 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
`destinationMappingId`	Die Segment-ID Audience Manager.
`elementName`	Der Segmentname.
`elementDescription`	Ein Text, der das Segment kurz beschreibt.
`elementStatus`	Der aktuelle Status der Segmentzuordnung. Zu den zurückgegebenen Statusoptionen gehören: `active` `inactive` `deleted`