Erste Schritte

Übersicht

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

Terminologie

In diesem Handbuch werden plattformspezifische Konzepte wie Organisation und Sandboxes verwendet. Definitionen hierzu und zu anderen Begriffen finden Sie im Experience Platform-Glossar.

Erforderliche Authentifizierungsdaten erhalten

Das Destination SDK verwendet das 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 einzurichten.

Um Destination SDK-API-Endpunkte erfolgreich aufzurufen, folgen Sie dem Tutorial zur Experience Platform-Authentifizierung. Starten Sie das Tutorial über dasAPI-Schlüssel, Organisations-ID und Client-Geheimnis generieren". Das Adobe Exchange-Team übernimmt die vorherigen Schritte für Sie. Im Rahmen 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: {ORG_ID}, auch als Organisations-ID bezeichnet
  • Authorization: Bearer {ACCESS_TOKEN}. Das Zugriffs-Token hat eine Ablaufzeit von 24 Stunden, ausgedrückt in Millisekunden, sodass Sie es aktualisieren müssen. Um das Zugriffs-Token zu aktualisieren, wiederholen Sie die Schritte, die im Authentifizierungs-Tutorial beschrieben werden.

Zielinhaber und Sandboxes

Alle Ressourcen in Experience Platform sind auf bestimmte virtuelle Sandboxes beschränkt. Für Anfragen zum 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 in Aufrufen der Destination SDK-API-Endpunkte verwenden müssen.

Rollenbasierte Zugriffskontrolle (RBAC)

Um Destination SDK-API-Endpunkte, die im Abschnitt Referenzdokumentation beschrieben werden, zu nutzen, benötigen Sie die Zugriffskontrollberechtigung für die Zielerstellung. Arbeiten Sie mit dem Adobe Exchange-Team zusammen, um diese Berechtigung in der Adobe Admin Console zugewiesen zu bekommen.

Berechtigung zur Zielerstellung

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

Weitere Überlegungen

  • Für produktionierte/öffentliche Ziele müssen alle Änderungen, die Sie an Zielkonfigurationen vornehmen, unabhängig davon, ob Sie eine Zielkonfiguration erstellen oder bearbeiten, von Adobe überprüft und genehmigt werden. Ihre Änderungen werden erst nach Abschluss der Überprüfung in Ihren Zielen angezeigt. Dies gilt nicht für private Ziele, die nur für Sie verfügbar sind.
  • Nur Benutzer, die derselben Organisation angehören und Zugriff auf die Sandbox haben, können die Zielkonfiguration bearbeiten.

Nächste Schritte

Wenn Sie die Schritte in diesem Artikel befolgt haben, haben Sie Authentifizierungsdaten für Adobe I/O, einen Sandbox-Namen und die Zugriffskontrolle für die Zielerstellung erhalten. Als Nächstes können Sie mithilfe des Destination SDK ein Ziel einrichten.

Auf dieser Seite