[Beta]{class="badge informative"}
Erste Schritte mit Selbstbedienungsquellen (Streaming-SDK)
Mit Selbstbedienungsquellen (Streaming-SDK) können Sie Ihre eigene Quelle integrieren, um Streaming-Daten an Adobe Experience Platform zu übertragen. In diesem Dokument erhalten Sie eine Einführung in die wichtigsten Konzepte, die Sie kennen sollten, bevor Sie Aufrufe an die Flow Service API).
Allgemeine Vorgehensweise
Der schrittweise Prozess zum Konfigurieren Ihrer -Quelle in Experience Platform wird unten beschrieben:
Integration
Dokumentation
- Um mit der Dokumentation Ihrer Quelle zu beginnen, lesen Sie Übersicht über das Erstellen der Dokumentation für Selbstbedienungsquellen.
- Anweisungen zum Erstellen Dokumentation mit GitHub finden Sie im Handbuch unterVerwenden der GitHub-Web-Benutzeroberfläche“.
- Anweisungen zum Erstellen Dokumentation auf Ihrem lokalen Computer finden SieHandbuch unter „Verwenden eines Texteditors“.
- Verwenden Sie die Dokumentationsvorlage für die Streaming-SDK-API , um Ihre Quelle in der API zu dokumentieren.
- Verwenden Sie die Dokumentationsvorlage für die Streaming-SDK-Benutzeroberfläche, um Ihre Quelle in der Benutzeroberfläche zu dokumentieren.
Sie können auch die folgenden Dokumentationsvorlagen herunterladen:
Voraussetzungen
Um Selbstbedienungsquellen (Streaming-SDK) verwenden zu können, müssen Sie sicherstellen, dass Sie Zugriff auf eine Sandbox-Organisation haben, die mit Adobe Experience Platform-Quellen bereitgestellt ist.
Dieses Handbuch setzt außerdem ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:
- Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Experience Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Experience Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse besser entwickeln und weiterentwickeln können.
Lesen von Beispiel-API-Aufrufen
In der Dokumentation zu den Selbstbedienungsquellen (Streaming-SDK) und der Flow Service-API wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. Dazu gehören Pfade, erforderliche Kopfzeilen und ordnungsgemäß formatierte Anfrage-Payloads. Außerdem wird ein Beispiel für eine von der API im JSON-Format zurückgegebene Antwort bereitgestellt. Informationen zu den Konventionen, die in der Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Handbuch zur Fehlerbehebung für Experience Platform.
Sammeln von Werten für erforderliche Kopfzeilen
Um Experience Platform-APIs aufzurufen, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen. Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Header in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alle Ressourcen in Experience Platform, einschließlich der Ressourcen, die zu Flow Service gehören, sind in bestimmten virtuellen Sandboxes isoliert. Bei allen Anfragen an Experience Platform-APIs ist eine Kopfzeile erforderlich, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt werden soll:
x-sandbox-name: {SANDBOX_NAME}
Bei allen Anfragen mit einer Payload (POST, PUT, PATCH) ist eine zusätzliche Kopfzeile erforderlich:
Content-Type: application/json
Nächste Schritte
Informationen zum Erstellen einer neuen Quelle mit Selbstbedienungsquellen (Streaming-SDK) finden Sie im Tutorial Erstellen einer neuen Quelle.