Ü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
- Informationen darüber, wie Sie Platform-APIs erfolgreich aufrufen können, finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.
- Informationen zum Generieren Ihrer Anmeldeinformationen für Platform-APIs finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs.
- Informationen zum Einrichten von Postman für Platform-APIs finden Sie im Tutorial zum Einrichten der Entwicklerkonsole und Postman.
- Laden Sie zur Unterstützung Ihres Test- und Debugging-Prozesses die Überprüfungssammlung und -umgebung für Self-Serve-Quellen hier herunter 🔗 und führen Sie die unten beschriebenen Schritte aus.
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:
flowSpecificationId
und targetConnectionSpecId
, bei denen es sich um feste Werte handelt.x-api-key
x-api-key
finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
x-gw-ims-org-id
-Informationen finden Sie im Tutorial zum Einrichten der Entwicklerkonsole mit und Postman .ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
authorizationToken
finden Sie im Tutorial zum Authentifizieren und 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 beim Erstellen eines neuen Schemas neben dem schemaId
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
RestStorageToAEP
. Dies ist ein fester Wert.6499120c-0b15-42dc-936e-847ea3c24d72
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 -Oberfläche beginnen. Wählen Sie in der Benutzeroberfläche Postman die Auslassungszeichen (…) neben Sources SSSs Verification Collection und dann Sammlung ausführen aus.
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.
Ü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.