Konfigurieren der Authentifizierung für Adobe Target -APIs

Stellen Sie in der Adobe Admin Console sicher, dass Ihr Adobe -Benutzerkonto sowohl auf Produktadministrator als auch auf Entwickler -Ebene Zugriff auf Target erhalten hat.

Wählen Sie in Adobe Developer Console die Experience Cloud Organization aus, für die Sie diese Integration erstellen möchten. (Beachten Sie, dass Sie wahrscheinlich nur Zugriff auf eine einzelne Experience Cloud Organization haben.)

Klicken Sie auf Create new project.

Klicken Sie auf "Add API", um Ihrem Projekt eine REST-API hinzuzufügen und auf Adobe Dienste und Produkte zuzugreifen.

Wählen Sie Adobe Target als Adobe-Dienst aus, mit dem Sie die Integration durchführen möchten. Klicken Sie auf die Schaltfläche "Next", die angezeigt wird.

Wählen Sie eine Option zum Verknüpfen öffentlicher und privater Schlüssel mit der Dienstkontointegration aus, die Sie für Target erstellen. Wählen Sie für dieses Beispiel Option 1: Generate a key pair und klicken Sie auf Generate keypair.

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

Überprüfen Sie in Ihrem Dateisystem den Speicherort von config, d. h. die komprimierte Konfigurationsdatei, die im vorherigen Schritt erstellt wurde. Diese config -Datei 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 Produktprofile aus, die den Eigenschaften entsprechen, in denen Sie Adobe Recommendations verwenden. (Wenn Sie keine Eigenschaften verwenden, wählen Sie die Option Standard-Workspace aus.) Klicken Sie auf Save configured API.

Klicken Sie auf Create Integration. 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 um als die ursprünglichen Project 1. Navigieren Sie dazu mithilfe des Navigationspfads zum Projekt, wie angezeigt, klicken Sie auf Edit project , um auf das Modal Edit Project zuzugreifen, und benennen Sie das Projekt um.

Navigieren Sie weiterhin in der Adobe Developer Console, um die Service Account (JWT) -Anmeldedaten Ihres neuen Projekts anzuzeigen. Verwenden Sie entweder die linke Navigation oder den Abschnitt "Credentials", wie dargestellt.

Beachten Sie, dass Sie in Credential details Ihre Public key(s), Client ID und andere Informationen zu Ihrem Dienstkonto anzeigen können.

Klicken Sie auf , um zu Informationen zur Adobe Target-API zu navigieren. Verwenden Sie entweder die linke Navigation oder den Abschnitt "Connected products and services", wie dargestellt.

Klicken Sie auf Download for Postman > Service Account (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 Open.

Klicken Sie im Modal Postman Umgebungen verwalten 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. Sie muss nicht unbedingt mit dem Namen des Projekts Adobe übereinstimmen.)

Beachten Sie, dass die Werte für CLIENT_SECRET und API_KEY (zusammen mit anderen Variablen) vorausgefüllt sind und aus Ihrer Integration gemäß der Definition in Adobe Developer Console entnommen werden. (Die Variable Postman CLIENT_SECRET sollte mit der in der Developer Console angezeigten CLIENT SECRET Adobe-Berechtigung übereinstimmen, und API_KEY in Postman sollte ebenfalls mit CLIENT ID in der Developer Console übereinstimmen.) Im Gegensatz dazu sind die Anmerkungen PRIVATE_KEY, JWT_TOKEN und ACCESS_TOKEN leer. Zunächst geben wir den Wert PRIVATE_KEY an.

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

Wählen Sie den gesamten Inhalt der Schlüsseldatei private aus und kopieren Sie ihn.

Fügen Sie in Postman Ihren privaten Schlüsselwert in die Felder INITIAL VALUE und CURRENT VALUE ein.

Klicken Sie auf Update und schließen Sie das Modal Umgebungen .

Navigieren Sie zu den Beispielaufrufen für die Adobe Identity Management Service-API.

Klicken Sie auf "Adobe I/O Access Token Generation Postman collection".

Rufen Sie die JSON-Rohdaten für diese Sammlung ab, indem Sie auf "Raw"klicken und dann die resultierende JSON in die Zwischenablage kopieren. (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 Continue.

Wählen Sie die IMS: JWT Generate + Auth via User Token -Anfrage in der Postman-Sammlung "Adobe I/O Access Token Generation"aus, stellen Sie sicher, dass Ihre Umgebung ausgewählt ist, und klicken Sie auf Send, um das Token zu generieren.

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

Beachten Sie, dass die Werte ACCESS_TOKEN und JWT_TOKEN jetzt ausgefüllt sind.

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

Erweitern Sie die Sammlung und notieren Sie sich die List activities -Anfrage.

Beachten Sie, dass Variablen wie {{access_token}} zunächst nicht aufgelöst werden. Sie können dies auf verschiedene Weise beheben - Sie können beispielsweise eine neue Erfassungsvariable mit dem Namen {{access_token}} definieren - aber 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.

Typ, der {{access_token}} durch {{ACCESS_TOKEN}} ersetzen soll.

Typ, der {{api_key}} durch {{API_KEY}} ersetzen soll.

Typ, der {{tenant}} durch {{TENANT_ID}} ersetzen soll. Hinweis {{TENANT_ID}} wird noch nicht erkannt.

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

Geben Sie ein, um eine neue {{TENANT_ID}} -Umgebungsvariable hinzuzufügen. Kopieren Sie den Wert Ihrer Mandanten-ID und fügen Sie ihn in die Felder INITIAL VALUE und CURRENT VALUE für Ihre neue Umgebungsvariable TENANT_ID ein.

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.