DokumentationExperience PlatformAnleitung zu Quell-Connectoren

Beta

Testen und Senden der Quelle

Letzte Aktualisierung: 4. April 2025
  • Themen:

Erstellt für:

  • Entwickler
HINWEIS
Selbstbedienungsquellen-Streaming SDK befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Betagekennzeichneten Quellen finden Sie„Quellen - Übersicht“.

Die letzten Schritte zur Integration Ihrer neuen -Quelle in Adobe Experience Platform mithilfe von Selbstbedienungsquellen (Streaming-SDK) bestehen darin, Ihre neue -Quelle zu testen und zu übermitteln. Nachdem Sie Ihre Verbindungsspezifikation abgeschlossen und die Streaming-Flussspezifikation aktualisiert haben, können Sie mit dem Testen der Funktionalität Ihrer Quelle entweder über die API oder die Benutzeroberfläche beginnen. Bei Erfolg können Sie dann Ihre neue Quelle übermitteln, indem Sie sich an Ihren Adobe-Support-Mitarbeiter wenden.

Im folgenden Dokument erfahren Sie, wie Sie Ihre Quelle mit der Flow Service API) testen und.

Erste Schritte

  • Informationen zum erfolgreichen Aufrufen von Experience Platform-APIs finden Sie im Handbuch unter mit Experience Platform-APIs.
  • Informationen zum Generieren Ihrer Anmeldeinformationen für Experience Platform-APIs finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs.
  • Informationen zum Einrichten von Postman für Experience Platform-APIs finden Sie im Tutorial zum von Entwicklerkonsole und Postman.
  • Um Ihren Test- und Debugging-Prozess zu unterstützen, laden Sie die Sammlung und Umgebung für die Selbstbedienungsquellen-Verifizierung hier herunter und führen Sie die folgenden Schritte aus.

Testen der Quelle mithilfe der API

Um Ihre Quelle mithilfe der API zu testen, müssen Sie die Sammlung und Umgebung Selbstbedienungsquellen-Überprüfung auf Postman ausführen und dabei die entsprechenden Umgebungsvariablen angeben, die sich auf Ihre Quelle beziehen.

Um mit dem Testen zu beginnen, müssen Sie zunächst die Sammlung und die Umgebung in Postman einrichten. Geben Sie als Nächstes die Verbindungsspezifikations-ID an, die Sie testen möchten.

HINWEIS
Alle folgenden Beispielvariablen sind Platzhalterwerte, die Sie aktualisieren müssen, mit Ausnahme von flowSpecificationId und targetConnectionSpecId, bei denen es sich um feste Werte handelt.
Parameter
Beschreibung
Beispiel
x-api-key
Eine eindeutige Kennung, die zum Authentifizieren von Aufrufen an Experience Platform-APIs verwendet wird. Informationen zum Abrufen Ihrer x-api-key finden im Tutorial zumund Zugreifen auf Experience Platform-APIs .
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
Eine Unternehmenseinheit, die Produkte und Dienstleistungen besitzen oder lizenzieren und ihren Mitgliedern Zugang gewähren kann. Anweisungen zum Abrufen Ihrer x-gw-ims-org-id finden im Tutorial zum Einrichten Postman Entwicklerkonsole und .
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
Das Autorisierungs-Token, das zum Abschließen von Aufrufen an Experience Platform-APIs erforderlich ist. Informationen zum Abrufen Ihrer authorizationToken finden im Tutorial zumund Zugreifen auf Experience Platform-APIs .
Bearer authorizationToken
schemaId
Damit die Quelldaten in Experience Platform verwendet werden können, muss ein Zielschema erstellt werden, das die Quelldaten entsprechend Ihren Anforderungen strukturiert. Ausführliche Schritte zum Erstellen eines XDM-Zielschemas finden Sie im Tutorial zum Erstellen eines Schemas mithilfe der API.
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
Die eindeutige Version, die Ihrem Schema entspricht.
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
Die meta:altId, die zusammen mit dem schemaId beim Erstellen eines neuen Schemas zurückgegeben wird.
_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
Ausführliche Anweisungen zum Erstellen eines Zieldatensatzes finden Sie im Tutorial zu Erstellen eines Datensatzes mithilfe der API.
5f3c3cedb2805c194ff0b69a
mappings
Mit Zuordnungssätzen lässt sich definieren, wie Daten in einem Quellschema den Daten eines Zielschemas zugeordnet werden sollen. Ausführliche Anweisungen zum Erstellen einer Zuordnung finden Sie im Tutorial zum Erstellen Zuordnungssatzes mithilfe der API.
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
Die eindeutige ID, die Ihrem Zuordnungssatz entspricht.
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
Die Verbindungsspezifikations-ID, die Ihrer Quelle entspricht. Dies ist die ID, die Sie nach dem Erstellen neuen Verbindungsspezifikation generiert.
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
Die Flussspezifikations-ID von GenericStreamingAEP. Dies ist ein fester.
e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
Die Zielverbindungs-ID des Data Lake, in dem die aufgenommenen Daten landen. Dies ist ein fester.
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
Das vorgesehene Zeitintervall, das bei der Überprüfung auf den Abschluss eines Flussdurchgangs einzuhalten ist.
40
startTime
Die vorgesehene Startzeit für Ihren Datenfluss. Die Startzeit muss in Unix-Zeit formatiert sein.
1597784298

Nachdem Sie alle Umgebungsvariablen bereitgestellt haben, können Sie mit der Ausführung der Sammlung über die Postman beginnen. Klicken Sie in der Postman auf die Auslassungspunkte (…) neben Sources SSSs Verification Collection und wählen Sie Sammlung ausführen.

Runner

Die Runner Benutzeroberfläche wird angezeigt, über die Sie die Ausführungsreihenfolge Ihres Datenflusses konfigurieren können. Wählen SSS-Verifizierungssammlung ausführen, um die Sammlung auszuführen.

NOTE
Sie können Fluss löschen in der Checkliste für die Ausführungsreihenfolge deaktivieren, wenn Sie das Dashboard zur Quellenüberwachung in der Experience Platform-Benutzeroberfläche verwenden möchten. Nachdem Sie jedoch mit dem Testen fertig sind, müssen Sie sicherstellen, dass Ihre Testflüsse gelöscht werden.

run-collection

Testen der Quelle mithilfe der Benutzeroberfläche

Um Ihre Quelle in der Benutzeroberfläche zu testen, navigieren Sie zum Quellkatalog der Sandbox Ihres Unternehmens in der Experience Platform-Benutzeroberfläche. Von hier aus sollte Ihre neue Quelle unter der Kategorie Streaming“.

Da Ihre neue Quelle jetzt in Ihrer Sandbox verfügbar ist, müssen Sie dem Quell-Workflow folgen, um die Funktionen zu testen. Wählen Sie zunächst Einrichten aus.

Der Quellkatalog, der die neue Streaming-Quelle anzeigt.

Der Schritt Daten hinzufügen wird angezeigt. Um zu testen, ob Ihre Quelle Daten streamen kann, verwenden Sie die linke Seite der Schnittstelle, um ( JSON-Beispieldaten). Nach dem Hochladen Ihrer Daten wird auf der rechten Seite der Benutzeroberfläche eine Vorschau der Dateihierarchie Ihrer Daten angezeigt. Klicken Sie auf Weiter, um fortzufahren.

Der Schritt „Daten hinzufügen“ im Quell-Workflow, in dem Sie Ihre Daten vor der Aufnahme hochladen und in der Vorschau anzeigen können.

Auf der Seite Datenflussdetails können Sie auswählen, ob Sie einen vorhandenen Datensatz oder einen neuen Datensatz verwenden möchten. Während dieses Vorgangs können Sie auch Ihre Daten für die Aufnahme in Profile konfigurieren und Einstellungen wie Fehlerdiagnose und Partielle Aufnahme aktivieren.

Wählen Sie zum Testen Neuer Datensatz und geben Sie einen Namen für den Ausgabedatensatz an. In diesem Schritt können Sie auch eine optionale Beschreibung angeben, um weitere Informationen zu Ihrem Datensatz hinzuzufügen. Wählen Sie als Nächstes mithilfe der Option Erweiterte Suche oder durch Scrollen durch die Liste der vorhandenen Schemata im Dropdown-Menü ein Schema zum Zuordnen aus. Nachdem Sie ein Schema ausgewählt haben, geben Sie einen Namen und eine Beschreibung für Ihren Datenfluss ein.

Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.

Der Schritt „Datenflussdetails“ im Quell-Workflow.

Es erfolgt der Schritt der Zuordnung, in dem Ihnen eine Schnittstelle zum Zuordnen der Quellfelder aus Ihrem Quellschema zu den entsprechenden XDM-Zielfeldern im Zielschema bereitgestellt wird.

Experience Platform bietet intelligente Empfehlungen für automatisch zugeordnete Felder, die auf dem ausgewählten Zielschema oder Datensatz basieren. Sie können die Zuordnungsregeln manuell an Ihre Anwendungsfälle anpassen. Je nach Bedarf können Sie wahlweise Felder direkt zuordnen oder mithilfe von Datenvorbereitungsfunktionen Quelldaten transformieren, um berechnete oder anderweitig ermittelte Werte abzuleiten. Eine ausführliche Anleitung zur Verwendung der Zuordnungsschnittstelle und berechneter Felder finden Sie im Handbuch zur Datenvorbereitungs-Benutzeroberfläche

Nachdem Ihre Quelldaten erfolgreich zugeordnet wurden, klicken Sie auf Weiter.

Der Zuordnungsschritt des Quell-Workflows.

Der Schritt Überprüfung wird angezeigt, sodass Sie Ihren neuen Datenfluss überprüfen können, bevor er hergestellt wird. Die Details lassen sich wie folgt kategorisieren:

  • Verbindung: Zeigt Ihren Kontonamen, den Quelltyp und andere verschiedene Informationen an, die für die von Ihnen verwendete Streaming-Cloud-Speicherquelle spezifisch sind.
  • Datensatz zuweisen und Felder zuordnen: Zeigt den Zieldatensatz und das Schema an, die Sie für Ihren Datenfluss verwenden.

Nachdem Sie Ihren Datenfluss überprüft haben, klicken Sie auf Beenden und gewähren Sie etwas Zeit für die Erstellung des Datenflusses.

Der Überprüfungsschritt des Quell-Workflows.

Schließlich müssen Sie den Streaming-Endpunkt Ihres Datenflusses abrufen. Dieser Endpunkt wird verwendet, um Ihren Webhook zu abonnieren, sodass Ihre Streaming-Quelle mit Experience Platform kommunizieren kann. Um Ihren Streaming-Endpunkt abzurufen, gehen Sie zur Seite Datenflussaktivität des soeben erstellten Datenflusses und kopieren Sie den Endpunkt am unteren Rand des Bedienfelds Eigenschaften.

Der Streaming-Endpunkt in der Datenflussaktivität.

Übermitteln Ihrer Quelle

Sobald Ihre Quelle den gesamten Workflow abschließen kann, können Sie sich an Ihren Adobe-Support-Mitarbeiter wenden und Ihre Quelle zur Integration in anderen Experience Platform-Organisationen übermitteln.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089