Verbinden Sie sich mit Streaming-Zielen und aktivieren Sie Daten über die Flow Service-API
In diesem Tutorial erfahren Sie, wie Sie API-Aufrufe verwenden, um eine Verbindung zu Ihren Adobe Experience Platform-Daten herzustellen, eine Verbindung zu einem Streaming-Cloud-Speicher-Ziel (Amazon Kinesis oder Azure Event Hubs) herzustellen, einen Datenfluss zu Ihrem neu erstellten Ziel zu erstellen und Daten für Ihr neu erstelltes Ziel zu aktivieren.
In diesem Tutorial wird für alle Beispiele das Amazon Kinesis verwendet, die Schritte sind jedoch für Azure Event Hubs identisch.
Wenn Sie die Benutzeroberfläche von Platform bevorzugen, um eine Verbindung zu einem Ziel herzustellen und Daten zu aktivieren, finden Sie weitere Informationen in den Tutorials Verbinden eines Ziels und Aktivieren von Zielgruppendaten für Streaming-Zielgruppenexportziele .
Erste Schritte
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:
- Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten ordnet.
- Catalog Service: Catalog ist das „System of Record“ für den Speicherort und die Herkunft von Daten auf Experience Platform.
- 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.
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um Daten für Streaming-Ziele in Platform aktivieren zu können.
Sammeln erforderlicher Anmeldedaten
Um die Schritte in diesem Tutorial abzuschließen, sollten Sie über die folgenden Anmeldeinformationen verfügen, je nachdem, mit welchem Zieltyp Sie Zielgruppen verbinden und aktivieren.
- Für Amazon Kinesis Verbindungen:
accessKeyId
,secretKey
,region
oderconnectionUrl
- Für Azure Event Hubs Verbindungen:
sasKeyName
,sasKey
,namespace
Lesen von Beispiel-API-Aufrufen reading-sample-api-calls
In diesem Tutorial 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.
Werte für erforderliche und optionale Kopfzeilen sammeln gather-values
Um Platform-APIs aufrufen zu können, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen. Im Rahmen des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Kopfzeilen 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}
Ressourcen in Experience Platform lassen sich in spezifischen virtuellen Sandboxes isolieren. Bei Anfragen an Platform-APIs können Sie den Namen und die Kennung der Sandbox angeben, in der der Vorgang ausgeführt werden soll. Dies sind optionale Parameter.
- x-sandbox-name:
{SANDBOX_NAME}
Bei allen Anfragen, die eine Payload enthalten (POST, PUT, PATCH), ist eine zusätzliche Medientyp-Kopfzeile erforderlich:
- Content-Type:
application/json
Swagger-Dokumentation swagger-docs
Eine zugehörige Referenzdokumentation für alle API-Aufrufe finden Sie in dieser Anleitung in Swagger. Siehe die Flow Service-API-Dokumentation auf Adobe I/O. Es wird empfohlen, diese Anleitung sowie die Seite mit der Swagger-Dokumentation parallel zu verwenden.
Abrufen der Liste der verfügbaren Streaming-Ziele get-the-list-of-available-streaming-destinations
Als ersten Schritt sollten Sie entscheiden, für welches Streaming-Ziel Daten aktiviert werden sollen. Führen Sie zunächst einen Aufruf durch, um eine Liste der verfügbaren Ziele anzufordern, mit denen Sie Zielgruppen verbinden und aktivieren können. Führen Sie die folgende GET-Anfrage an den connectionSpecs
-Endpunkt aus, um eine Liste der verfügbaren Ziele zu erhalten:
API-Format
GET /connectionSpecs
Anfrage
curl --location --request GET 'https://platform.adobe.io/data/foundation/flowservice/connectionSpecs' \
--header 'accept: application/json' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'
Antwort
Eine erfolgreiche Antwort enthält eine Liste der verfügbaren Ziele und ihre eindeutigen Kennungen (id
). Notieren Sie sich den Wert des Ziels, das Sie verwenden möchten, da Sie ihn in weiteren Schritten benötigen werden. Wenn Sie beispielsweise Zielgruppen mit Amazon Kinesis oder Azure Event Hubs verbinden und bereitstellen möchten, suchen Sie in der Antwort nach folgendem Code-Ausschnitt:
{
"id": "86043421-563b-46ec-8e6c-e23184711bf6",
"name": "Amazon Kinesis",
...
...
}
{
"id": "bf9f5905-92b7-48bf-bf20-455bc6b60a4e",
"name": "Azure Event Hubs",
...
...
}
Verbindung zu Ihren Experience Platform-Daten herstellen connect-to-your-experience-platform-data
Als Nächstes müssen Sie eine Verbindung zu Ihren Experience Platform-Daten herstellen, um Profildaten exportieren und in Ihrem bevorzugten Ziel aktivieren zu können. Das umfasst zwei Unterschritte, die nachfolgend beschrieben werden.
- Sie müssen zunächst einen Aufruf ausführen, um den Zugriff auf Ihre Daten in Experience Platform zu autorisieren, indem Sie eine Basisverbindung einrichten.
- Anschließend führen Sie mit der Kennung der Basisverbindung einen weiteren Aufruf aus, mit dem Sie eine Quellverbindung einrichten, die die Verbindung zu Ihren Experience Platform-Daten herstellt.
Zugriff auf Ihre Daten in Experience Platform genehmigen
API-Format
POST /connections
Anfrage
curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/connections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Base connection to Experience Platform",
"description": "This call establishes the connection to Experience Platform data",
"connectionSpec": {
"id": "{CONNECTION_SPEC_ID}",
"version": "1.0"
}
}'
{CONNECTION_SPEC_ID}
: Verwenden Sie die Verbindungsspezifikations-ID für Profile Service -8a9c3494-9708-43d7-ae3f-cda01e5030e1
.
Antwort
Eine erfolgreiche Antwort enthält die eindeutige Kennung der Basisverbindung (id
). Notieren Sie sich diesen Wert, da Sie ihn im nächsten Schritt zum Erstellen der Quellverbindung benötigen werden.
{
"id": "1ed86558-59b5-42f7-9865-5859b552f7f4"
}
Verbindung zu Ihren Experience Platform-Daten herstellen connect-to-platform-data
API-Format
POST /sourceConnections
Anfrage
curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Connecting to Profile Service",
"description": "Optional",
"connectionSpec": {
"id": "{CONNECTION_SPEC_ID}",
"version": "1.0"
},
"baseConnectionId": "{BASE_CONNECTION_ID}",
"data": {
"format": "json"
},
"params": {}
}'
{BASE_CONNECTION_ID}
: Verwenden Sie die Kennung, die Sie im vorherigen Schritt erhalten haben.{CONNECTION_SPEC_ID}
: Verwenden Sie die Verbindungsspezifikations-ID für Profile Service -8a9c3494-9708-43d7-ae3f-cda01e5030e1
.
Antwort
Bei einer erfolgreichen Antwort wird die eindeutige Kennung (id
) für die neu erstellte Quellverbindung zum Profil-Service zurückgegeben. Dadurch wird bestätigt, dass Sie erfolgreich eine Verbindung zu Ihren Experience Platform-Daten hergestellt haben. Notieren Sie sich diesen Wert, da Sie ihn in einem späteren Schritt benötigen werden.
{
"id": "ed48ae9b-c774-4b6e-88ae-9bc7748b6e97"
}
Mit Streaming-Ziel verbinden connect-to-streaming-destination
In diesem Schritt richten Sie eine Verbindung zu Ihrem gewünschten Streaming-Ziel ein. Dies umfasst zwei Unterschritte, die nachfolgend beschrieben werden.
- Sie müssen zunächst einen Aufruf ausführen, um den Zugriff auf das Streaming-Ziel zu autorisieren, indem Sie eine Basisverbindung einrichten.
- Mithilfe der Kennung der Basisverbindung führen Sie dann einen weiteren Aufruf aus, mit dem Sie eine Zielverbindung erstellen. In dem Aufruf sind der Ort in Ihrem Speicherkonto, an dem die exportierten Daten bereitgestellt werden, sowie das Format der zu exportierenden Daten angegeben.
Autorisieren des Zugriffs auf das Streaming-Ziel
API-Format
POST /connections
Anfrage
//
. Diese Kommentare zeigen, wo für verschiedene Streaming-Ziele unterschiedliche Werte verwendet werden müssen. Bitte entfernen Sie die Kommentare, bevor Sie das Snippet verwenden.curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/connections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Connection for Amazon Kinesis/ Azure Event Hubs",
"description": "summer advertising campaign",
"connectionSpec": {
"id": "{_CONNECTION_SPEC_ID}",
"version": "1.0"
},
"auth": {
"specName": "{AUTHENTICATION_CREDENTIALS}",
"params": { // use these values for Amazon Kinesis connections
"accessKeyId": "{ACCESS_ID}",
"secretKey": "{SECRET_KEY}",
"region": "{REGION}"
},
"params": { // use these values for Azure Event Hubs connections
"sasKeyName": "{SAS_KEY_NAME}",
"sasKey": "{SAS_KEY}",
"namespace": "{EVENT_HUB_NAMESPACE}"
}
}
}'
{CONNECTION_SPEC_ID}
: Verwenden Sie die Verbindungsspezifikations-ID, die Sie im Schritt Liste der verfügbaren Ziele anfordern erhalten haben.{AUTHENTICATION_CREDENTIALS}
: Geben Sie den Namen Ihres Streaming-Ziels ein:Aws Kinesis authentication credentials
oderAzure EventHub authentication credentials
.{ACCESS_ID}
: Für Amazon Kinesis. Ihre Zugriffs-ID für Ihren Speicherort in Amazon Kinesis.{SECRET_KEY}
: Für Amazon Kinesis. Sie Ihren geheimen Schlüssel für Ihren Speicherort in Amazon Kinesis.{REGION}
: Für Amazon Kinesis. Die Region in Ihrem Amazon Kinesis-Konto, in der Platform Ihre Daten streamt.{SAS_KEY_NAME}
: Für Azure Event Hubs. Geben Sie den Namen Ihres SAS-Schlüssels ein. Erfahren Sie mehr über die Authentifizierung bei Azure Event Hubs mit SAS-Schlüsseln in der Dokumentation zu Microsoft.{SAS_KEY}
: Für Azure Event Hubs. Geben Sie Ihren SAS-Schlüssel ein. Erfahren Sie mehr über die Authentifizierung bei Azure Event Hubs mit SAS-Schlüsseln in der Dokumentation zu Microsoft.{EVENT_HUB_NAMESPACE}
: Für Azure Event Hubs. Füllen Sie den Azure Event Hubs-Namespace aus, in den Platform Ihre Daten streamen soll. Weitere Informationen finden Sie unter Erstellen eines Event Hubs-Namespace in der Microsoft.
Antwort
Eine erfolgreiche Antwort enthält die eindeutige Kennung der Basisverbindung (id
). Notieren Sie sich diesen Wert, da Sie ihn im nächsten Schritt benötigen, um eine Zielverbindung zu erstellen.
{
"id": "1ed86558-59b5-42f7-9865-5859b552f7f4"
}
Speicherort und Datenformat angeben
API-Format
POST /targetConnections
Anfrage
//
. Diese Kommentare zeigen, wo für verschiedene Streaming-Ziele unterschiedliche Werte verwendet werden müssen. Bitte entfernen Sie die Kommentare, bevor Sie das Snippet verwenden.curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/targetConnections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Amazon Kinesis/ Azure Event Hubs target connection",
"description": "Connection to Amazon Kinesis/ Azure Event Hubs",
"baseConnectionId": "{BASE_CONNECTION_ID}",
"connectionSpec": {
"id": "{CONNECTION_SPEC_ID}",
"version": "1.0"
},
"data": {
"format": "json"
},
"params": { // use these values for Amazon Kinesis connections
"stream": "{NAME_OF_DATA_STREAM}",
"region": "{REGION}"
},
"params": { // use these values for Azure Event Hubs connections
"eventHubName": "{EVENT_HUB_NAME}"
}
}'
{BASE_CONNECTION_ID}
: Nutzen Sie die Kennung der Basisverbindung, die Sie im obigen Schritt erhalten haben.{CONNECTION_SPEC_ID}
: Verwenden Sie die Verbindungsspezifikation, die Sie im Schritt Liste der verfügbaren Ziele abrufen erhalten haben.{NAME_OF_DATA_STREAM}
: Für Amazon Kinesis. Geben Sie den Namen Ihres vorhandenen Datenstroms in Ihrem Amazon Kinesis-Konto an. Platform exportiert Daten in diesen Stream.{REGION}
: Für Amazon Kinesis. Die Region in Ihrem Amazon Kinesis-Konto, in die Platform Ihre Daten streamt.{EVENT_HUB_NAME}
: Für Azure Event Hubs. Geben Sie den Azure Event Hub ein, in den Platform Ihre Daten streamen soll. Weitere Informationen finden Sie unter Erstellen eines Ereignis-Hub in der Microsoft.
Antwort
Bei einer erfolgreichen Antwort wird die eindeutige Kennung (id
) für die neu erstellte Zielverbindung zu Ihrem Streaming-Ziel zurückgegeben. Notieren Sie sich diesen Wert, da Sie ihn in späteren Schritten benötigen werden.
{
"id": "12ab90c7-519c-4291-bd20-d64186b62da8"
}
Datenfluss erstellen
Mithilfe der Kennungen, die Sie in den vorherigen Schritten erhalten haben, können Sie jetzt einen Datenfluss zwischen Ihren Experience Platform-Daten und dem Ziel erstellen, für das Sie Daten aktivieren möchten. Stellen Sie sich diesen Schritt als Bau einer Pipeline vor, durch die später Daten zwischen Experience Platform und dem gewünschten Ziel fließen werden.
Um einen Datenfluss zu erstellen, führen Sie eine POST-Anfrage durch (wie unten dargestellt) und geben Sie dabei die unten genannten Werte in der Payload an.
Führen Sie die folgende POST-Anfrage aus, um einen Datenfluss zu erstellen.
API-Format
POST /flows
Anfrage
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/flows' \
-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": "Azure Event Hubs",
"description": "Azure Event Hubs",
"flowSpec": {
"id": "{FLOW_SPEC_ID}",
"version": "1.0"
},
"sourceConnectionIds": [
"{SOURCE_CONNECTION_ID}"
],
"targetConnectionIds": [
"{TARGET_CONNECTION_ID}"
],
"transformations": [
{
"name": "GeneralTransform",
"params": {
"profileSelectors": {
"selectors": [
]
},
"segmentSelectors": {
"selectors": [
]
}
}
}
]
}
{FLOW_SPEC_ID}
: Die Flussspezifikations-ID für profilbasierte Ziele ist71471eba-b620-49e4-90fd-23f1fa0174d8
. Verwenden Sie diesen Wert im -Aufruf.{SOURCE_CONNECTION_ID}
: Verwenden Sie die Quellverbindungs-ID, die Sie im Schritt Verbindung zu Ihren Experience Platform-Daten herstellen erhalten haben.{TARGET_CONNECTION_ID}
: Verwenden Sie die Zielverbindungs-ID, die Sie im Schritt " mit Streaming-Ziel herstellen“ erhalten.
Antwort
Bei einer erfolgreichen Antwort werden die Kennung (id
) des neu erstellten Datenflusses und ein etag
zurückgegeben. Notieren Sie sich beide Werte. So wie Sie es im nächsten Schritt tun, um Zielgruppen zu aktivieren.
{
"id": "8256cfb4-17e6-432c-a469-6aedafb16cd5",
"etag": "8256cfb4-17e6-432c-a469-6aedafb16cd5"
}
Daten an Ihr neues Ziel aktivieren activate-data
Nachdem Sie alle Verbindungen und den Datenfluss erstellt haben, können Sie jetzt Ihre Profildaten für die Streaming-Plattform aktivieren. In diesem Schritt legen Sie fest, welche Zielgruppen und Profilattribute Sie an das Ziel senden, und Sie können Daten planen und an das Ziel senden.
Um Zielgruppen für Ihr neues Ziel zu aktivieren, müssen Sie einen JSON-PATCH-Vorgang ausführen, ähnlich dem folgenden Beispiel. Sie können mehrere Zielgruppen und Profilattribute in einem Aufruf aktivieren. Weiterführende Informationen zu JSON PATCH finden Sie in der RFC-Spezifikation.
API-Format
PATCH /flows
Anfrage
curl --location --request PATCH 'https://platform.adobe.io/data/foundation/flowservice/flows/{DATAFLOW_ID}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'Content-Type: application/json' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'If-Match: "{ETAG}"' \
--data-raw '[
{
"op": "add",
"path": "/transformations/0/params/segmentSelectors/selectors/-",
"value": {
"type": "PLATFORM_SEGMENT",
"value": {
"name": "Name of the audience that you are activating",
"description": "Description of the audience that you are activating",
"id": "{SEGMENT_ID}"
}
}
},
{
"op": "add",
"path": "/transformations/0/params/profileSelectors/selectors/-",
"value": {
"type": "JSON_PATH",
"value": {
"operator": "EXISTS",
"path": "{PROFILE_ATTRIBUTE}"
}
}
}
]
{DATAFLOW_ID}
{ETAG}
Rufen Sie die {ETAG}
aus der Antwort im vorherigen Schritt ab Erstellen eines Datenflusses. Das Antwortformat im vorherigen Schritt wurde in Anführungszeichen gesetzt. Sie müssen die Werte ohne Escape-Zeichen im Header der Anfrage verwenden. Siehe folgendes Beispiel:
- Anwendungsbeispiel für eine Antwort:
"etag":""7400453a-0000-1a00-0000-62b1c7a90000""
- In Ihrer Anfrage zu verwendender Wert:
"etag": "7400453a-0000-1a00-0000-62b1c7a90000"
Der eTag-Wert wird bei jeder erfolgreichen Aktualisierung eines Datenflusses aktualisiert.
{SEGMENT_ID}
{PROFILE_ATTRIBUTE}
"person.lastName"
op
add
, replace
und remove
. Um eine Zielgruppe zu einem Datenfluss hinzuzufügen, verwenden Sie den Vorgang add
.path
value
id
name
Antwort
Suchen Sie nach einer „202 OK“-Antwort. Es wird kein Antworttext zurückgegeben. Um zu überprüfen, ob die Anfrage korrekt war, lesen Sie den nächsten Schritt „Datenfluss validieren“.
Datenfluss validieren
Als letzten Schritt im Tutorial sollten Sie überprüfen, ob die Zielgruppen und Profilattribute dem Datenfluss korrekt zugeordnet wurden.
Führen Sie zur Validierung die folgende GET-Anfrage aus:
API-Format
GET /flows
Anfrage
curl --location --request PATCH 'https://platform.adobe.io/data/foundation/flowservice/flows/{DATAFLOW_ID}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'Content-Type: application/json' \
--header 'x-sandbox-name: prod' \
--header 'If-Match: "{ETAG}"'
{DATAFLOW_ID}
: Verwenden Sie den Datenfluss aus dem vorherigen Schritt.{ETAG}
: Verwenden Sie das eTag aus dem vorherigen Schritt.
Antwort
Die zurückgegebene Antwort sollte im transformations
die Zielgruppen und Profilattribute enthalten, die Sie im vorherigen Schritt gesendet haben. Ein Beispielparameter transformations
in der Antwort könnte wie folgt aussehen:
"transformations": [
{
"name": "GeneralTransform",
"params": {
"profileSelectors": {
"selectors": [
{
"type": "JSON_PATH",
"value": {
"path": "personalEmail.address",
"operator": "EXISTS"
}
},
{
"type": "JSON_PATH",
"value": {
"path": "person.lastname",
"operator": "EXISTS"
}
}
]
},
"segmentSelectors": {
"selectors": [
{
"type": "PLATFORM_SEGMENT",
"value": {
"name": "Men over 50",
"description": "",
"id": "72ddd79b-6b0a-4e97-a8d2-112ccd81bd02"
}
}
]
}
}
}
],
Exportierte Daten
{
"person": {
"email": "yourstruly@adobe.com"
},
"segmentMembership": {
"ups": {
"72ddd79b-6b0a-4e97-a8d2-112ccd81bd02": {
"lastQualificationTime": "2020-03-03T21:24:39Z",
"status": "exited"
},
"7841ba61-23c1-4bb3-a495-00d695fe1e93": {
"lastQualificationTime": "2020-03-04T23:37:33Z",
"status": "realized"
}
}
},
"identityMap": {
"ecid": [
{
"id": "14575006536349286404619648085736425115"
},
{
"id": "66478888669296734530114754794777368480"
}
],
"email_lc_sha256": [
{
"id": "655332b5fa2aea4498bf7a290cff017cb4"
},
{
"id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
}
]
}
}
Verwenden Postman Sammlungen zum Herstellen einer Verbindung zu Streaming-Zielen collections
Um eine schnellere Verbindung zu den in diesem Tutorial beschriebenen Streaming-Zielen herzustellen, können Sie Postman verwenden.
Postman ist ein Tool, mit dem Sie API-Aufrufe durchführen und Bibliotheken vordefinierter Aufrufe und Umgebungen verwalten können.
Für dieses spezifische Tutorial wurden die folgenden Postman angehängt:
- AWS Kinesis Postman
- Azure Event Hubs Postman
Klicken Sie hier, um das Sammlungsarchiv herunterzuladen.
Jede Sammlung enthält die erforderlichen Anforderungen und Umgebungsvariablen für AWS Kinesis bzw. Azure Event Hub.
Verwendung der Postman Sammlungen how-to-use-postman-collections
Gehen Sie wie folgt vor, um mithilfe der angehängten Postman eine Verbindung zu den Zielen herzustellen:
- Herunterladen und Installieren von Postman
- Herunterladen und Entpacken der angehängten Sammlungen
- Importieren Sie die Sammlungen aus den entsprechenden Ordnern in Postman.
- Füllen Sie die Umgebungsvariablen gemäß den Anweisungen in diesem Artikel aus.
- Führen Sie die API Anfragen von Postman aus, basierend auf den Anweisungen in diesem Artikel.
Umgang mit API-Fehlern api-error-handling
Die API-Endpunkte in diesem Tutorial folgen den allgemeinen Grundsätzen für Experience Platform-API-Fehlermeldungen. Weitere Informationen Interpretieren von Fehlerantworten finden Sie unterAPI-Status-Codes undFehler in der Anfragekopfzeile im Handbuch zur Platform-Fehlerbehebung .
Nächste Schritte next-steps
In diesem Tutorial haben Sie Platform erfolgreich mit einem Ihrer bevorzugten Streaming-Ziele verbunden und einen Datenfluss zum jeweiligen Ziel eingerichtet. Ausgehende Daten können jetzt im Ziel für Kundenanalysen oder andere Datenvorgänge verwendet werden, die Sie möglicherweise durchführen möchten. Weiterführende Informationen finden Sie auf den folgenden Seiten: