[Beta]{class="badge informative"}
Erstellen einer Customer.io Quellverbindung und eines Datenflusses in der Benutzeroberfläche
In diesem Tutorial werden Schritte zum Erstellen einer Customer.io Quellverbindung und eines Datenflusses mithilfe der Adobe Experience Platform-Benutzeroberfläche beschrieben.
Erste Schritte getting-started
Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Experience Platform voraus:
-
Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.
- Grundlagen der Schemakomposition: Machen Sie sich mit den grundlegenden Bausteinen von XDM-Schemata vertraut, einschließlich der wichtigsten Prinzipien und Best Practices bei der Schemaerstellung.
- Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemata mithilfe der Benutzeroberfläche des Schema-Editors erstellen können.
-
Real-Time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.
Voraussetzungen prerequisites
Im folgenden Abschnitt finden Sie Informationen zu Voraussetzungen, die erfüllt sein müssen, bevor Sie eine Customer.io Quellverbindung erstellen können.
Beispiel-JSON zum Definieren des Quellschemas für Customer.io prerequisites-json-schema
Bevor Sie eine Customer.io Quellverbindung erstellen, benötigen Sie ein Quellschema, das bereitgestellt werden muss. Sie können die folgende JSON-Datei verwenden.
{
"event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
"object_type": "customer",
"metric": "subscribed",
"timestamp": 1613063089,
"data": {
"customer_id": "42",
"email_address": "test@example.com",
"identifiers": {
"id": "42",
"email": "test@example.com",
"cio_id": "d9c106000001"
}
}
}
Erstellen eines Platform-Schemas für Customer.io create-platform-schema
Sie müssen auch sicherstellen, dass Sie ein Platform-Schema für Ihre Quelle erstellen. Eine ausführliche Anleitung zum Erstellen Schemas finden SieTutorial zum Erstellen eines Platform Schemas .
Verbinden Ihres Customer.io-Kontos connect-account
Wählen Sie in der Platform Benutzeroberfläche die Option Quellen“ in der linken Navigationsleiste, um auf den Arbeitsbereich Quellen zuzugreifen und einen Quellenkatalog anzuzeigen, der auf Experience Platform verfügbar ist.
Verwenden Sie das Menü Kategorien, um Quellen nach Kategorie zu filtern. Geben Sie alternativ einen Quellnamen in die Suchleiste ein, um eine bestimmte Quelle aus dem Katalog zu finden.
Gehen Sie zur Kategorie Marketing, um die Customer.io anzuzeigen. Wählen Sie zunächst Daten hinzufügen aus.
Daten auswählen select-data
Der Schritt Daten auswählen wird angezeigt und bietet eine Schnittstelle zur Auswahl der Daten, die Sie an Platform übermitteln möchten.
- Der linke Teil der Benutzeroberfläche ist ein Browser, mit dem Sie die verfügbaren Datenströme in Ihrem Konto anzeigen können.
- Im rechten Teil der Benutzeroberfläche können Sie eine Vorschau von bis zu 100 Datenzeilen aus einer JSON-Datei anzeigen.
Wählen Sie Dateien hochladen aus, um eine JSON-Datei von Ihrem lokalen System hochzuladen. Alternativ können Sie die JSON-Datei, die Sie hochladen möchten, per Drag-and-Drop in das Bedienfeld Dateien per Drag-and-Drop .
Nachdem Ihre Datei hochgeladen wurde, wird die Vorschau-Oberfläche aktualisiert, um eine Vorschau des hochgeladenen Schemas anzuzeigen. In der Vorschauoberfläche können Sie den Inhalt und die Struktur einer Datei überprüfen. Sie können auch das Dienstprogramm Suchfeld verwenden, um innerhalb Ihres Schemas auf bestimmte Elemente zuzugreifen.
Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.
Datenflussdetails dataflow-detail
Der Schritt Datenflussdetails wird angezeigt und bietet Ihnen Optionen zum Verwenden eines vorhandenen Datensatzes oder zum Einrichten eines neuen Datensatzes für Ihren Datenfluss sowie die Möglichkeit, einen Namen und eine Beschreibung für Ihren Datenfluss anzugeben. In diesem Schritt können Sie auch Einstellungen für die Profilaufnahme, Fehlerdiagnose, partielle Aufnahme und Warnhinweise konfigurieren.
Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.
Zuordnung mapping
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.
Platform bietet intelligente Empfehlungen für automatisch zugeordnete Felder, die auf dem von Ihnen 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.
Alle unten aufgeführten Zuordnungen sind obligatorisch und sollten eingerichtet werden, bevor Sie mit der Phase Überprüfung fortfahren.
object_typeidemailevent_idcio_idmetrictimestamptest mode keine cio_id zu, da keine zugehörigen Felder von Customer.io gesendet werden.Nachdem Ihre Quelldaten erfolgreich zugeordnet wurden, klicken Sie auf Weiter.
Überprüfung review
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 den Quelltyp, den relevanten Pfad der ausgewählten Quelldatei und die Anzahl der Spalten innerhalb dieser Quelldatei an.
- Datensatz- und Zuordnungsfelder zuweisen: Zeigt an, in welchen Datensatz die Quelldaten aufgenommen werden, einschließlich des Schemas, dem der Datensatz entspricht.
Nachdem Sie Ihren Datenfluss überprüft haben, klicken Sie auf Beenden und gewähren Sie etwas Zeit für die Erstellung des Datenflusses.
Abrufen der Streaming-Endpunkt-URL get-streaming-endpoint
Nachdem Sie Ihren Streaming-Datenfluss erstellt haben, können Sie jetzt Ihre Streaming-Endpunkt-URL abrufen. Dieser Endpunkt wird verwendet, um Ihren Webhook zu abonnieren, sodass Ihre Streaming-Quelle mit Experience Platform kommunizieren kann.
Um die URL zu erstellen, die zum Konfigurieren des Webhooks in Customer.io verwendet wird, müssen Sie Folgendes abrufen:
- Datenfluss-ID
- Streaming-Endpunkt
Um Ihre Datenfluss-ID und den Streaming-Endpunkt abzurufen, gehen Sie zur Seite Datenflussaktivität des soeben erstellten Datenflusses und kopieren Sie die Details am unteren Rand des Bedienfelds Eigenschaften.
Nachdem Sie Ihren Streaming-Endpunkt und Ihre Datenfluss-ID abgerufen haben, erstellen Sie eine URL nach dem folgenden Muster: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Eine erstellte Webhook-URL kann beispielsweise wie folgt aussehen: https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0
Reporting-Webhook in Customer.io einrichten set-up-webhook
Nachdem Sie Ihre Webhook-URL erstellt haben, können Sie jetzt Ihren Reporting-Webhook über die Customer.io-Benutzeroberfläche einrichten. Anweisungen zum Einrichten von Reporting-Webhooks finden Sie im Customer.io Handbuch zum Einrichten von Webhooks.
Geben Sie in der Customer.io-Benutzeroberfläche Ihre Webhook-URL in das Feld WEBHOOK ENDPOINT ein.
Nächste Schritte next-steps
In diesem Tutorial haben Sie erfolgreich einen Streaming-Datenfluss konfiguriert, um Ihre Customer.io-Daten auf Experience Platform zu übertragen. Informationen zum Überwachen der aufgenommenen Daten finden Sie im Handbuch unter Überwachen von Streaming-Datenflüssen mithilfe der Platform-Benutzeroberfläche.
Zusätzliche Ressourcen additional-resources
Die folgenden Abschnitte enthalten zusätzliche Ressourcen, auf die Sie bei Verwendung der Customer.io verweisen können.
Leitplanken guardrails
Informationen zu Leitplanken finden Sie auf der Seite Customer.io Zeitüberschreitungen und Fehler.
Validierung validation
Um zu überprüfen, ob Sie die Quelle richtig eingerichtet haben und Customer.io Nachrichten aufgenommen werden, führen Sie die folgenden Schritte aus:
- Sie können die Seite Customer.io Aktivitätsprotokolle überprüfen, um die von Customer.io erfassten Ereignisse zu identifizieren.
- Wählen Sie in der Platform-Benutzeroberfläche Datenflüsse anzeigen neben dem Menü Customer.io im Quellkatalog aus. Wählen Sie als Nächstes Vorschau des Datensatzes aus, um die Daten zu überprüfen, die für die Ereignisse aufgenommen wurden, die Sie in Customer.io ausgewählt haben.
