[Beta]{class="badge informative"}
Erstellen einer PathFactory-Basisverbindung mithilfe der Flow Service-API
Eine Basisverbindung stellt die authentifizierte Verbindung zwischen einer Quelle und Adobe Experience Platform dar.
In diesem Dokument erfahren Sie, wie Sie mit der [Flow Service API] (https://www.adobe.io/experience-platform-apis/references/flow-service/) eine Basisverbindung für PathFactory erstellen.
Erste Schritte
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von 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 Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.
Verwenden von Platform-APIs
Informationen darüber, wie Sie Platform-APIs erfolgreich aufrufen können, finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.
Im folgenden Abschnitt finden Sie weitere Informationen, die Sie benötigen, um mithilfe der Flow Service -API erfolgreich eine Verbindung zu PathFactory herstellen zu können.
Erforderliche Anmeldedaten sammeln gather-credentials
Um auf Ihr PathFactory-Konto in Platform zuzugreifen, müssen Sie die folgenden Werte angeben:
Bestimmte API-Endpunkte für den Zugriff auf Daten: Besucher, Sitzungen und Seitenansichten. Jeder Endpunkt entspricht verschiedenen Datensätzen, die Sie abrufen können. Hinweis: Diese sind durch PathFactory vordefiniert und spezifisch für die Daten, auf die Sie zugreifen möchten:
- Besucherendpunkt:
/api/public/v3/data_lake_apis/visitors.json
- Sitzungsendpunkt:
/api/public/v3/data_lake_apis/sessions.json
- Endpunkt "Seitenansichten":
/api/public/v3/data_lake_apis/page_views.json
Weitere Informationen zum Sichern und Verwenden Ihrer Anmeldeinformationen sowie zum Abrufen und Aktualisieren Ihres Zugriffstokens finden Sie im PathFactory Support-Center. Diese Ressource enthält umfassende Anleitungen zur Verwaltung Ihrer Anmeldedaten und zur Sicherstellung einer effektiven und sicheren API-Integration.
Erstellen einer Basisverbindung
Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen Kennung der Basisverbindung. Mit der Kennung der Basisverbindung können Sie Dateien aus Ihrer Quelle heraus analysieren und darin navigieren und die spezifischen Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu ihren Datentypen und Formaten.
Um eine Basis-Verbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den /connections
-Endpunkt und geben Sie dabei Ihre PathFactory-Authentifizierungsdaten als Teil des Anfragetexts an.
API-Format
POST /connections
Anfrage
Die folgende Anfrage erstellt eine Basisverbindung für PathFactory:
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "PathFactory base connection",
"description": "PathFactory base connection",
"auth": {
"specName": "Basic Authentication",
"params": {
"host": "acme-ab12c3d4e5fg6hijk7lmnop8qrst"
"clientId": "pathfactory",
"clientSecret": "xxxx"
}
},
"connectionSpec": {
"id": "ea1c2a08-b722-11eb-8529-0242ac130003",
"version": "1.0"
}
}'
auth.params.clientId
auth.params.clientSecret
connectionSpec.id
ea1c2a08-b722-11eb-8529-0242ac130003
.Antwort
Eine erfolgreiche Antwort gibt die neu erstellte Verbindung zurück, einschließlich der eindeutigen Verbindungskennung (id
). Diese ID ist erforderlich, um Ihre Daten im nächsten Tutorial zu untersuchen.
{
"id": "2fce94c1-9a93-4971-8e94-c19a93097129",
"etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
Nächste Schritte
In diesem Tutorial haben Sie eine PathFactory-Basisverbindung mithilfe der Flow Service-API erstellt. Sie können diese Basisverbindungs-ID in den folgenden Tutorials verwenden: