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.
In diesem Handbuch werden plattformspezifische Konzepte wie Organisation und Sandboxes verwendet. Definitionen hierzu und zu anderen Begriffen finden Sie im Experience Platform-Glossar.
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 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.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.
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:
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.
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.