Konfigurieren der Authentifizierung für Adobe Target APIs

Stellen Sie in der Adobe Admin Console sicher, dass Ihrem Adobe-Benutzerkonto sowohl Produktadministrator als auch Entwickler Zugriff auf Target gewährt wurde.

Wählen Sie in der 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 einzige Experience Cloud Organization haben.)

Klicken Sie auf Create new project.

Klicken Sie auf Add API , um Ihrem Projekt eine REST-API für den Zugriff auf Adobe Services und Produkte hinzuzufügen.

Wählen Sie Adobe Target als den Adobe-Service aus, mit dem Sie eine Integration vornehmen möchten. Klicken Sie auf die Next.

Wählen Sie eine Option aus, um öffentliche und private Schlüssel mit der Service-Kontointegration zu verknüpfen, die Sie für Target erstellen. Wählen Sie für dieses Beispiel Option 1: Generate a key pair aus und klicken Sie auf Generate keypair.

Notieren Sie sich wie angewiesen 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, bei dem es sich um die im vorherigen Schritt erstellte komprimierte Konfigurationsdatei handelt. Diese config enthält Ihren privaten Schlüssel, den Sie später benötigen werden. Der genaue Speicherort in Ihrem Dateisystem kann von dem hier gezeigten abweichen.

Zurück in der Adobe Developer Console wählen Sie Produktprofil(e 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 in einem letzten Schritt Ihr Projekt um, sodass es einen aussagekräftigeren Namen hat als das ursprüngliche Project 1. Navigieren Sie dazu mithilfe des angezeigten Navigationspfads zum Projekt, klicken Sie auf Edit project , um auf das Edit Project Modal zuzugreifen, und benennen Sie das Projekt um.

Navigieren Sie noch in der {0🔗Adobe Developer Console}, um die Service Account (JWT) Anmeldedaten Ihres neuen Projekts anzuzeigen. Verwenden Sie entweder den linken Navigationsbereich oder den Credentials, wie abgebildet.

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

Klicken Sie, um zu Informationen über die Adobe Target-API zu navigieren. Verwenden Sie entweder die linke Navigation oder den Abschnitt Verbundene Produkte und Services wie abgebildet.

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.

Postman Klicken Sie im „Umgebungen verwalten auf den Namen der neu importierten Umgebung, um sie zu überprüfen. (Ihr Umgebungsname kann von dem hier gezeigten abweichen. Bearbeiten Sie den Namen nach Bedarf. Es muss nicht unbedingt mit dem Namen des Adobe-Projekts übereinstimmen.)

Beachten Sie, dass CLIENT_SECRET und API_KEY (zusammen mit anderen Variablen) ihre Werte vorab ausgefüllt haben und aus Ihrer Integration stammen, wie in der Adobe Developer Console definiert. (Die Postman-CLIENT_SECRET-Variable sollte mit den CLIENT SECRET Adobe-Anmeldeinformationen übereinstimmen, wie sie in der Developer Console angezeigt werden, und API_KEY in Postman sollten ebenfalls mit den CLIENT ID in der Developer Console übereinstimmen.) Beachten Sie dagegen, dass PRIVATE_KEY, JWT_TOKEN und ACCESS_TOKEN leer sind. Beginnen wir mit der Angabe des PRIVATE_KEY.

Öffnen Sie in Ihrem Dateisystem die config-Datei und öffnen Sie die private.

Wählen Sie den gesamten Inhalt der 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 zur Adobe Identity Management Service-API.

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

Rufen Sie die rohe JSON für diese Sammlung ab, indem Sie auf Raw klicken und dann die resultierende JSON in Ihre Zwischenablage kopieren. (Sie können die rohe JSON auch als JSON-Datei speichern.)

Importieren Sie in Postman die Sammlung, indem Sie die rohe JSON aus der Zwischenablage einfügen und senden. (Sie können auch die JSON-Datei hochladen, die Sie gespeichert haben.) Klicken Sie auf Continue.

Wählen Sie die IMS: JWT Generate + Auth via User Token Anfrage in der Postman-Sammlung zur Erzeugung von Adobe I/O-Zugriffstoken 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 für ACCESS_TOKEN und JWT_TOKEN jetzt ausgefüllt sind.

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

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

Beachten Sie, dass Variablen wie {{access_token}} zunächst nicht aufgelöst werden. Sie können dies auf verschiedene Arten beheben, z. B. indem Sie eine neue Sammlungsvariable mit dem Namen {{access_token}} definieren. In diesem Handbuch ändern Sie jedoch die API-Anfrage, um die zuvor verwendete Postman-Umgebung zu nutzen. Dadurch kann die Umgebung weiterhin als eine einzige, konsistente Konsolidierung aller Variablen dienen, die in allen Adobe-APIs verwendet werden.

Tippen Sie, um {{access_token}} durch {{ACCESS_TOKEN}} zu ersetzen.

Tippen Sie, um {{api_key}} durch {{API_KEY}} zu ersetzen.

Tippen Sie, um {{tenant}} durch {{TENANT_ID}} zu ersetzen. Hinweis {{TENANT_ID}} wird noch nicht erkannt.

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

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

Senden Sie die Anfrage, nachdem Sie sichergestellt haben, dass Sie die richtige Umgebung ausgewählt haben. Sie sollten eine Antwort erhalten, die Ihre Liste der Aktivitäten enthält.