Abrufen von Segmentmetadaten

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.

Manuelle Methode

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.

Automatisierte Methode

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.

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 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.

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 des -Audience Managers.

elementName

Der Segmentname.

elementDescription

Ein Text, der das Segment kurz beschreibt.

elementStatus

Der aktuelle Status der Segmentzuordnung. Zu den Rückgabestatusoptionen gehören:

  • active
  • inactive
  • deleted

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now