Show Menu
THEMEN×

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 daran arbeiten), bieten ein tatsächlicher Name und eine Beschreibung eine bessere Benutzererfahrung 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, Zielgruppen-Metadaten von Ihren Kunden durch manuelle Prozesse zu erhalten. Dies kann Dateien umfassen, die an E-Mails oder von Kunden angehängt werden, die diese Daten über eine von UI Ihnen zu diesem Zweck erstellte und verwaltete Datei hinzufügen. 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 verwenden, Audience Manager um Segmentmetadaten automatisch abzurufen API .

Automatisierte Methode

Audience Manager bietet eine Reihe von REST-APIs , mit denen Sie Segmentmetadaten automatisch abrufen können. Mit der APIkönnen Sie Aufträge erstellen, die Segmentmetadaten in planmäßigen Intervallen oder automatisch abrufen, sobald Sie Daten verarbeiten Audience Manager und eine neue Segment-ID finden. Weitere Informationen finden Sie in den unten stehenden 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. Das ist ein guter Anfang, wenn Sie noch nicht mit dem API vorher gearbeitet haben.

Schritt 2: Zugriffsberechtigungen für OAuth2 anfordern

Sie benötigen eine Client-ID und ein Geheimnis, um API Aufrufe zu tätigen. 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 eine Adresse senden amsupport@adobe.com.

Schritt 3: Erfassen kundenspezifischer Informationen von jedem integrierten Kunden

Fordern Sie bei jedem integrierten Kunden Folgendes an:
  • Benutzername: Dies gilt 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 jeweilige 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 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
destinationMappingId
Die Segment-ID von Audience Manager .
elementName
Der Segmentname.
elementDescription
Ein Text, der das Segment kurz beschreibt.
elementStatus
Der aktuelle Status der Segmentzuordnung. Zu den Rückgabestatusoptionen gehören:
  • active
  • inaktiv
  • gelöscht