Erste Schritte
Übersicht overview
Auf dieser Seite wird beschrieben, wie Sie sich authentifizieren und Adobe Experience Platform Destination SDK verwenden. Sie enthält Anweisungen zum Abrufen der Anmeldedaten für die Adobe I/O-Authentifizierung, eines Sandbox-Namens und der Zugriffskontrolle für die Zielerstellung.
Terminologie terminology
In diesem Handbuch werden plattformspezifische Konzepte wie Organisation und Sandboxes verwendet. Definitionen zu diesen Begriffen finden Sie im Experience Platform-Glossar . Im Destination SDK-Glossar finden Sie Begriffe, die sich direkt auf diese Funktion beziehen.
Erforderliche Authentifizierungs-Anmeldedaten erhalten obtain-authentication-credentials
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 im Schritt "API-Schlüssel, Organisations-ID und Client-Geheimnis erzeugen". 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 bezeichnetx-gw-ims-org-id: {ORG_ID}, auch als Organisations-ID bezeichnetAuthorization: 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 destination-ownership
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) 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.
Weitere Informationen finden Sie in den folgenden Dokumenten zur Zugriffskontrolle in Experience Platform:
Weitere Überlegungen additional-considerations
- 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 next-steps
Wenn Sie die Schritte in diesem Artikel befolgt haben, haben Sie Authentifizierungs-Anmeldedaten 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.
-
Lesen Sie je nach Zieltyp die folgenden Konfigurationshandbücher:
-
Informationen zu allen Vorgängen finden Sie im Abschnitt Dokumentation zur Zielerstellungs-API.
-
Verwenden Sie die Postman-Sammlung der Zielerstellungs-API, um Ihr Ziel mithilfe der Destination SDK-API-Endpunkte zu konfigurieren. Informationen zu den ersten Schritten mit Postman finden Sie unter Schritte zum Importieren von Umgebungen und Sammlungen und im Videoleitfaden zum Erstellen der Postman-Umgebung.