Übermitteln Ihrer Quelle

Der letzte Schritt bei der Integration Ihrer neuen Quelle in Adobe Experience Platform mithilfe von Self-Serve-Quellen (Batch SDK) besteht darin, Ihre Quelle zur Verifizierung zu testen. Nach erfolgreichem Abschluss können Sie Ihre neue Quelle senden, indem Sie sich an Ihren Adobe-Support-Mitarbeiter wenden.

Das folgende Dokument enthält Schritte zum Testen und Debuggen Ihrer Quelle mit der Flow Service API.

Erste Schritte

Testen der Quelle

Um Ihre Quelle zu testen, müssen Sie die Überprüfungssammlung für Self-Serve-Quellen und die Umgebung 🔗 auf Postman ausführen und dabei die entsprechenden Umgebungsvariablen für Ihre Quelle angeben.

Um den Test zu starten, müssen Sie zunächst die Sammlung und Umgebung auf Postman einrichten. Geben Sie als Nächstes die Verbindungsspezifikations-ID an, die Sie testen möchten.

authSpecName angeben

Nachdem Sie Ihre Verbindungsspezifikations-ID eingegeben haben, müssen Sie die authSpecName angeben, die Sie für Ihre Basisverbindung verwenden. Je nach Wahl kann dies entweder OAuth 2 Refresh Code oder Basic Authentication sein. Nachdem Sie Ihren authSpecName angegeben haben, müssen Sie die erforderlichen Anmeldeinformationen in Ihre Umgebung einfügen. Wenn Sie beispielsweise authSpecName als OAuth 2 Refresh Code angeben, müssen Sie die erforderlichen Anmeldeinformationen für OAuth 2 bereitstellen, nämlich host und accessToken.

sourceSpec angeben

Nachdem Sie die Authentifizierungs-Spezifizierungsparameter hinzugefügt haben, müssen Sie als Nächstes die erforderlichen Eigenschaften aus Ihrer Quellspezifikation hinzufügen. Sie finden die erforderlichen Eigenschaften in "sourceSpec.spec.properties". Im folgenden Beispiel für MailChimp Members ist die einzige erforderliche Eigenschaft listId, was listId bedeutet und der entsprechende ID-Wert für Ihre Postman-Umgebung ist.

"spec": {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "description": "Define user input parameters to fetch resource values.",
  "properties": {
    "listId": {
      "type": "string",
      "description": "listId for which members need to fetch."
    }
  }
}

Nachdem Sie die Authentifizierungs- und Quellspezifizierungsparameter angegeben haben, können Sie mit dem Ausfüllen der übrigen Umgebungsvariablen beginnen. Die nachstehende Tabelle enthält eine Referenz:

NOTE
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, mit der Aufrufe an Experience Platform-APIs authentifiziert werden. Informationen zum Abrufen Ihrer x-api-key finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
Eine Unternehmenseinheit, die Produkte und Dienste besitzen oder lizenzieren und Zugriff auf ihre Mitglieder gewähren kann. Anweisungen zum Abrufen Ihrer x-gw-ims-org-id -Informationen finden Sie im Tutorial zum Einrichten der Entwicklerkonsole mit und Postman .
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
Das Autorisierungstoken, das zum Abschließen von Aufrufen an Experience Platform-APIs erforderlich ist. Informationen zum Abrufen Ihrer authorizationToken finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .
Bearer authorizationToken
schemaId
Damit die Quelldaten in 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 beim Erstellen eines neuen Schemas neben dem schemaId 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 eines Zuordnungssatzes mit 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 einer neuen Verbindungsspezifikation generiert haben.
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
Die Flussspezifikations-ID RestStorageToAEP. Dies ist ein fester Wert.
6499120c-0b15-42dc-936e-847ea3c24d72
targetConnectionSpecId
Die Zielverbindungs-ID des Data Lake, in dem die erfassten Daten landen. Dies ist ein fester Wert.
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
Das festgelegte Zeitintervall, das bei der Überprüfung auf den Abschluss eines Flusslaufs eingehalten werden soll.
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 -Oberfläche beginnen. Wählen Sie in der Benutzeroberfläche Postman die Auslassungszeichen () neben Sources SSSs Verification Collection und dann Sammlung ausführen aus.

runner

Die Oberfläche Runner wird angezeigt, über die Sie die Ausführungsreihenfolge Ihres Datenflusses konfigurieren können. Wählen Sie Ausführen der SSS Verification Collection aus, 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 für die Quellenüberwachung in der Platform-Benutzeroberfläche bevorzugen. Sobald Sie jedoch mit dem Test fertig sind, müssen Sie sicherstellen, dass Ihre Testflüsse gelöscht werden.

run-collection

Ü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 übermitteln.

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