Übermitteln Ihrer Quelle

Letzte Aktualisierung: 2023-01-10
  • Themen:
  • Sources
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • Developer
    User
    Admin
    Leader

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 Kundenbetreuer wenden.

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

Erste Schritte

Testen der Quelle

Um Ihre Quelle zu testen, müssen Sie die Erfassung und Umgebung der Verifizierung von Self-Serve-Quellen on Postman , während Sie die entsprechenden Umgebungsvariablen für Ihre Quelle angeben.

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

Legen Sie authSpecName

Nachdem Sie die Verbindungs-Spezifikations-ID eingegeben haben, müssen Sie die authSpecName die Sie für Ihre Basisverbindung verwenden. Je nach Ihrer Wahl kann dies entweder OAuth 2 Refresh Code oder Basic Authentication. Sobald Sie Ihre authSpecNamemüssen Sie dann die erforderlichen Anmeldeinformationen in Ihre Umgebung einfügen. Wenn Sie beispielsweise authSpecName as OAuth 2 Refresh Codeangeben, müssen Sie die erforderlichen Anmeldeinformationen für OAuth 2 angeben, die host und accessToken.

Legen Sie sourceSpec

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 Falle der MailChimp Members Beispiel unten: Die einzige erforderliche Eigenschaft ist listId, d. h. listId und der entsprechende ID-Wert für Ihre Postman Umgebung.

"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:

HINWEIS

Alle folgenden Beispielvariablen sind Platzhalterwerte, die Sie aktualisieren müssen, mit Ausnahme von flowSpecificationId und targetConnectionSpecId, die feste Werte sind.

Parameter Beschreibung Beispiel
x-api-key Eine eindeutige Kennung, die zum Authentifizieren von Aufrufen an Experience Platform-APIs verwendet wird. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs Informationen zum Abrufen Ihrer x-api-key. c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id Eine Unternehmenseinheit, die Produkte und Dienste besitzen oder lizenzieren und Zugriff auf ihre Mitglieder gewähren kann. Siehe Tutorial zu Einrichten der Entwicklerkonsole und Postman Anweisungen zum Abrufen Ihrer x-gw-ims-org-id Informationen. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken Das Autorisierungstoken, das zum Abschließen von Aufrufen an Experience Platform-APIs erforderlich ist. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs Informationen zum Abrufen Ihrer authorizationToken. 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 wird zusammen mit der schemaId beim Erstellen eines neuen Schemas. _{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 zu Erstellen eines 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 Erstellen einer neuen Verbindungsspezifikation. 2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId Die Flussspezifikations-ID von 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 mit der Postman -Schnittstelle. Im Postman -Benutzeroberfläche die Auslassungszeichen () neben Sources SSSs Verification Collection und wählen Sie Sammlung ausführen.

runner

Die Runner -Schnittstelle angezeigt, über die Sie die Ausführungsreihenfolge Ihres Datenflusses konfigurieren können. Auswählen Ausführen der SSS-Verification-Sammlung , um die Sammlung auszuführen.

HINWEIS

Sie können Fluss löschen über die Checkliste für die Ausführungsreihenfolge , 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 Integrationsquelle übermitteln.

Auf dieser Seite