Beta
Testen und Senden der Quelle
Erstellt für:
- Entwickler
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.
flowSpecificationId
und targetConnectionSpecId
, bei denen es sich um feste Werte handelt.x-api-key
x-api-key
finden im Tutorial zumund Zugreifen auf Experience Platform-APIs .c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
x-gw-ims-org-id
finden im Tutorial zum Einrichten Postman Entwicklerkonsole und .ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
authorizationToken
finden im Tutorial zumund Zugreifen auf Experience Platform-APIs .Bearer authorizationToken
schemaId
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
meta:altId
, die zusammen mit dem schemaId
beim Erstellen eines neuen Schemas zurückgegeben wird._{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
5f3c3cedb2805c194ff0b69a
mappings
[{"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
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
GenericStreamingAEP
. Dies ist ein fester.e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
40
startTime
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.
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.
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 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.
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.
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 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.
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.
Ü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.