Erste Schritte

Übersicht

Auf dieser Seite wird beschrieben, wie Sie sich authentifizieren und mit Adobe Experience Platform Destination SDK beginnen. Es enthält Anweisungen zum Abrufen der Anmeldeinformationen für die Adobe I/O-Authentifizierung, eines Sandbox-Namens und der Zugriffssteuerungsberechtigung für die Zielerstellung.

Terminologie

In diesem Handbuch werden plattformspezifische Konzepte wie IMS-Organisation und Sandboxes verwendet. Lesen Sie die Glossar zur Experience Platform für Definitionen dieser und anderer Begriffe.

Erforderliche Authentifizierungsberechtigungen abrufen

Destination SDK verwendet die Adobe I/O Gateway zur Authentifizierung. Um API-Aufrufe an Destination SDK-Endpunkte durchzuführen, müssen Sie bestimmte Kopfzeilen in Ihren API-Aufrufen bereitstellen. Arbeiten Sie mit dem Adobe Exchange-Team zusammen, um die Authentifizierung für die Adobe Developer Console.

Um Destination SDK-API-Endpunkte erfolgreich aufzurufen, folgen Sie dem Tutorial zur Experience Platform-Authentifizierung. Starten Sie das Tutorial über dasAPI-Schlüssel, Kennung der IMS-Organisation und Client-Geheimnis generieren". Das Adobe Exchange-Team übernimmt die vorherigen Schritte für Sie. Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Kopfzeilen in Destination SDK-API-Aufrufen bereitgestellt, wie unten dargestellt:

  • x-api-key: {API_KEY}, auch als Client-ID bezeichnet
  • x-gw-ims-org-id: {IMS_ORG}, auch als Organisations-ID bezeichnet
  • Authorization: Bearer {ACCESS_TOKEN}. Das Zugriffstoken hat eine Ablaufzeit von 24 Stunden, ausgedrückt in Millisekunden, sodass Sie es aktualisieren müssen. Um das Zugriffstoken zu aktualisieren, wiederholen Sie die Schritte, die im Authentifizierungs-Tutorial beschrieben werden.

Zieleigentum und Sandboxes

Alle Ressourcen in Experience Platform sind auf bestimmte virtuelle Sandboxes beschränkt. Für Anfragen an Destination SDK sind Kopfzeilen erforderlich, die den Namen der Sandbox angeben, in der der Vorgang ausgeführt wird:

  • x-sandbox-name: {SANDBOX_NAME}

Das Adobe Exchange-Team stellt Ihnen Ihren Sandbox-Namen zur Verfügung, den Sie bei Aufrufen an die Destination SDK-API-Endpunkte verwenden müssen.

Rollenbasierte Zugriffssteuerung (RBAC)

So verwenden Sie die Destination SDK API-Endpunkte, die im Abschnitt Referenzdokumentation, benötigen Sie die Destination Authoring Zugriffssteuerungsberechtigung. Arbeiten Sie mit dem Adobe Exchange-Team zusammen, um diese Berechtigung Ihnen in Adobe Admin Console.

Berechtigung zur Zielbearbeitung

Weitere Informationen finden Sie in den folgenden Dokumenten zur Zugriffskontrolle der Experience Platform:

Weitere Überlegungen

  • Alle Änderungen, die Sie an Zielkonfigurationen vornehmen, unabhängig davon, ob Sie eine Zielkonfiguration erstellen oder bearbeiten, müssen von Adobe überprüft und genehmigt werden. Ihre Änderungen werden erst nach Abschluss der Überprüfung in Ihren Zielen angezeigt.
  • Nur Benutzer, die derselben Organisation angehören und Zugriff auf die Sandbox haben, können die Zielkonfiguration bearbeiten.

Nächste Schritte

Indem Sie die Schritte in diesem Artikel ausgeführt haben, haben Sie Authentifizierungsberechtigungen für Adobe I/O, einen Sandbox-Namen und die Zugriffssteuerungsberechtigung für die Zielerstellung erhalten. Als Nächstes können Sie ein Ziel mit Destination SDK einrichten.

Auf dieser Seite