Authentifizierung für Adobe Target APIs

Im Adobe Admin Console, stellen Sie sicher, dass Adobe Das Benutzerkonto wurde sowohl Produktadministrator und Entwickler Zugriff auf Ebene Target.

Im Adobe Developer-Konsole, wählen Sie die Experience Cloud-Organisation für die Sie diese Integration erstellen möchten. (Beachten Sie, dass Sie wahrscheinlich nur Zugriff auf eine Experience Cloud-Organisation.

Klicks Neues Projekt erstellen.

Klicks API hinzufügen , um Ihrem Projekt eine REST-API für den Zugriff auf hinzuzufügen Adobe Dienstleistungen und Produkte.

Auswählen Adobe Target als Adobe Service, mit dem Sie integrieren möchten. Klicken Sie auf Nächste -Schaltfläche angezeigt.

Wählen Sie eine Option zum Verknüpfen öffentlicher und privater Schlüssel mit der Dienstkontointegration aus, für die Sie erstellen Target. Wählen Sie für dieses Beispiel Option 1: Generieren eines Schlüsselpaars und klicken Generieren von keypair.

Notieren Sie sich, wie angegeben, die automatisch heruntergeladene Konfigurationsdatei (config), die Ihren privaten Schlüssel enthält. Klicken Sie auf Weiter.

Überprüfen Sie in Ihrem Dateisystem den Speicherort von config: die komprimierte Konfigurationsdatei, die im vorherigen Schritt erstellt wurde. Auch dies config enthält Ihren privaten Schlüssel, den Sie später benötigen werden. Der genaue Speicherort in Ihrem Dateisystem kann sich von dem hier gezeigten unterscheiden.

Wählen Sie in der Adobe Developer Console die Produktprofil(e) entspricht den Eigenschaften, in denen Sie Adobe Recommendations verwenden. (Wenn Sie keine Eigenschaften verwenden, wählen Sie die Option Standardarbeitsbereich .) Klicks Konfigurierte API speichern.

Klicks Integration erstellen. Sie sollten eine temporäre Meldung erhalten, die angibt, dass Ihre API erfolgreich konfiguriert wurde.

Benennen Sie Ihr Projekt als letzten Schritt in einen aussagekräftigeren Namen als den ursprünglichen. Project 1. Navigieren Sie dazu mithilfe des Navigationspfads wie angezeigt zum Projekt und klicken Sie auf Projekt bearbeiten , um auf die Projekt bearbeiten -Modal verwenden und das Projekt umbenennen.

Noch im Adobe Developer-Konsole, navigieren Sie zu , um die Dienstkonto (JWT) Anmeldedaten. Verwenden Sie entweder die linke Navigation oder die Anmeldeinformationen -Abschnitt angezeigt.

In Details zu Berechtigungen, beachten Sie, dass Sie Ihre Öffentliche Schlüssel, Client-ID und andere Informationen zu Ihrem Dienstkonto.

Klicken Sie auf , um zu Informationen zum Adobe Target API. Verwenden Sie entweder die linke Navigation oder die Verbundene Produkte und Dienste -Abschnitt angezeigt.

Klicks Herunterladen für Postman > Dienstkonto (JWT) , um eine JSON-Datei zu erstellen, die Ihre Authentifizierungsinformationen für eine Postman-Umgebung erfasst.

Notieren Sie die JSON-Datei in Ihrem Dateisystem.

Klicken Sie in Postman auf das Zahnradsymbol, um Ihre Umgebungen zu verwalten, und klicken Sie dann auf Import , um die JSON-Datei (Umgebung) zu importieren.

Wählen Sie Ihre Datei aus und klicken Sie auf Öffnen.

In der Postman Verwalten von Umgebungen modal klicken Sie auf den Namen der neu importierten Umgebung, um sie zu überprüfen. (Ihr Umgebungsname kann sich von dem hier gezeigten unterscheiden. Bearbeiten Sie den Namen nach Bedarf. Es muss nicht unbedingt mit dem Namen der Adobe Projekt.)

Hinweis CLIENT_SECRET und API_KEY (zusammen mit anderen Variablen) deren Werte vorausgefüllt werden, die aus Ihrer Integration stammen, wie in der Adobe Developer-Konsole definiert. (Die Postman CLIENT_SECRET sollte mit der Variablen CLIENT SECRET Adobe-Anmeldedaten, wie in der Developer Console angezeigt, und API_KEY in Postman sollte ebenfalls CLIENT ID in der Entwicklerkonsole.) Beachten Sie hingegen PRIVATE_KEY, JWT_TOKEN, und ACCESS_TOKEN leer sind. Beginnen wir mit der Bereitstellung der PRIVATE_KEY -Wert.

Öffnen Sie in Ihrem Dateisystem Ihre config und öffnen Sie die private Schlüsseldatei.

Gesamten Inhalt der private Schlüsseldatei.

Fügen Sie in Postman Ihren privaten Schlüsselwert in die ERSTER WERT und AKTUELLER Wert -Felder.

Klicks Aktualisieren und schließen Sie das Modal Umgebungen .

Navigieren Sie zum Beispielaufrufe für Adobe Identity Management Service-API.

Klicken Sie auf Postman-Sammlung zur Generierung von Adobe I/O-Zugriffstoken.

Rufen Sie die JSON-Rohdaten für diese Sammlung ab, indem Sie auf Roh, kopieren Sie dann die resultierende JSON in die Zwischenablage. (Alternativ können Sie die JSON-Rohdatei als JSON-Datei speichern.)

Importieren Sie die Sammlung in Postman, indem Sie die JSON-Rohdaten aus der Zwischenablage einfügen und senden. (Alternativ können Sie die von Ihnen gespeicherte JSON-Datei hochladen.) Klicken Sie auf Weiter.

Wählen Sie die IMS: JWT-Generierung + Auth über Benutzer-Token Anforderung in der Postman-Sammlung "Adobe I/O Access Token Generation", stellen Sie sicher, dass Ihre Umgebung ausgewählt ist, und klicken Sie auf Senden , um das Token zu generieren.

Öffnen Sie erneut das Modal Umgebungen verwalten und wählen Sie Ihre Umgebung aus.

Beachten Sie die ACCESS_TOKEN und JWT_TOKEN -Werte werden nun ausgefüllt.

Importieren Sie Adobe Target Postman-Sammlung für Admin-APIs. Befolgen Sie alle Anweisungen, bis die Sammlung in Postman importiert wurde.

Erweitern Sie die Sammlung und beachten Sie die Aktivitäten auflisten -Anfrage.

Beachten Sie, dass Variablen wie {{access_token}} zunächst ungelöst sind. Sie können dies auf verschiedene Weise beheben. Beispielsweise können Sie eine neue Kollektionsvariable mit dem Namen {{access_token}}- In diesem Handbuch ändern Sie stattdessen die API-Anfrage, um die zuvor verwendete Postman-Umgebung zu nutzen. Dadurch kann die Umgebung auch weiterhin als einheitliche, konsistente Konsolidierung aller Variablen dienen, die in allen Adobe-APIs verwendet werden.

Ersetzender Typ {{access_token}} mit {{ACCESS_TOKEN}}.

Ersetzender Typ {{api_key}} mit {{API_KEY}}.

Ersetzender Typ {{tenant}} mit {{TENANT_ID}}. Hinweis {{TENANT_ID}} noch nicht erkannt wurde.

Öffnen Sie das Modal Umgebungen verwalten und wählen Sie Ihre Umgebung aus.

Typ zum Hinzufügen eines neuen {{TENANT_ID}} Umgebungsvariable. Kopieren Sie den Wert Ihrer Mandanten-ID und fügen Sie ihn in die ERSTER WERT und AKTUELLER Wert -Felder für Ihre neue TENANT_ID Umgebungsvariable.

Senden Sie Ihre Anfrage, nachdem Sie sichergestellt haben, dass Sie die richtige Umgebung ausgewählt haben. Sie sollten eine Antwort mit Ihrer Aktivitätenliste erhalten.