Abrufen von Segmentmetadaten

Letzte Aktualisierung: 20. Dezember 2024
  • Themen:

Wenn der 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

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

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 der 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:

  • Benutzername: Dies ist für einen eingeschränkten Benutzer, der über schreibgeschützte Berechtigungen für das Ziel verfügt, 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 bestimmte Server-zu-Server-Integration erstellt wurde.

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.

ParameterBeschreibung
destinationMappingIdDer Audience Manager Segment-ID.
elementNameDer Segmentname.
elementDescriptionEin Text, der das Segment kurz beschreibt.
elementStatus

Der aktuelle Status der Segmentzuordnung. Zu den zurückgegebenen Statusoptionen gehören:

  • active
  • inactive
  • deleted
Vorherige SeiteAnsicht der Segmentzusammenfassung
Nächste SeiteAusgesetzte und gelöschte Segmente

Audience Manager