Beta

Erstellen Sie eine Customer.io Quellverbindung und Datenfluss in der Benutzeroberfläche

Letzte Aktualisierung: 2023-11-14
  • Themen:
  • Sources
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • Developer
HINWEIS

Die Customer.io-Quelle befindet sich in der Beta-Phase. Bitte lesen Sie die Quellen - Übersicht für weitere Informationen zur Verwendung von Beta-beschrifteten Quellen.

In diesem Tutorial werden Schritte zum Erstellen eines Customer.io Quellverbindung und Datenfluss über die Adobe Experience Platform-Benutzeroberfläche.

Erste Schritte

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-Schemas vertraut, einschließlich der wichtigsten Prinzipien und Best Practices bei der Schemaerstellung.
    • Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemas 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

Im folgenden Abschnitt finden Sie Informationen zu Voraussetzungen, die erfüllt sein müssen, bevor Sie eine Customer.io Quellverbindung.

JSON-Beispieldatei zum Definieren des Quellschemas für Customer.io

Vor der Erstellung Customer.io Quellverbindung verwenden, müssen Sie ein Quellschema angeben. 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

Sie müssen außerdem sicherstellen, dass Sie ein Platform-Schema erstellen, das für Ihre Quelle verwendet werden soll. Siehe Tutorial zu Erstellen eines Platform-Schemas für umfassende Schritte zum Erstellen eines Schemas.

Screenshot der Platform-Benutzeroberfläche mit einem Beispielschema für Customer.io

Verbinden Ihres Customer.io-Kontos

Wählen Sie in der Platform-Benutzeroberfläche die Option Quellen über die linke Navigationsleiste auf Quellen Arbeitsbereich und sehen Sie sich einen Quellkatalog an, der unter Experience Platform verfügbar ist.

Verwenden Sie die Kategorien Menü zum Filtern von Quellen nach Kategorie. Geben Sie alternativ einen Quellnamen in die Suchleiste ein, um eine bestimmte Quelle aus dem Katalog zu finden.

Navigieren Sie zu Marketing-Automatisierung -Kategorie, um die Customer.io Quellkarte. Wählen Sie zunächst Daten hinzufügen.

Screenshot der Platform-Benutzeroberfläche für Katalog mit Customer.io-Karte

Daten auswählen

Die Daten auswählen angezeigt, um eine Oberfläche zur Auswahl der Daten bereitzustellen, 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 Bereich der Benutzeroberfläche können Sie eine Vorschau von bis zu 100 Zeilen mit Daten aus einer JSON-Datei anzeigen.

Auswählen Dateien hochladen , um eine JSON-Datei von Ihrem lokalen System hochzuladen. Alternativ können Sie die hochzuladende JSON-Datei per Drag-and-Drop in die Dateien per Drag & Drop verschieben Bedienfeld.

Der Schritt Daten hinzufügen des Ursprungs-Workflows.

Nach dem Hochladen Ihrer Datei wird die Vorschau-Oberfläche aktualisiert, um eine Vorschau des hochgeladenen Schemas anzuzeigen. Über die Vorschau-Oberfläche können Sie den Inhalt und die Struktur einer Datei überprüfen. Sie können auch die Suchfeld -Dienstprogramm zum Zugreifen auf bestimmte Elemente aus Ihrem Schema.

Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.

Der Vorschauschritt des Ursprungs-Workflows.

Datenflussdetails

Die Datenflussdetails -Schritt angezeigt, der Ihnen Optionen zur Verwendung eines vorhandenen Datensatzes oder zur Einrichtung eines neuen Datensatzes für Ihren Datenfluss sowie die Möglichkeit bietet, einen Namen und eine Beschreibung für Ihren Datenfluss bereitzustellen. In diesem Schritt können Sie auch Einstellungen für die Profilerfassung, Fehlerdiagnose, partielle Erfassung und Warnhinweise konfigurieren.

Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.

Der Schritt dataflow-detail des Ursprungs-Workflows.

Zuordnung

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 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. Umfassende Schritte zur Verwendung der Mapper-Oberfläche und der berechneten Felder finden Sie im Abschnitt Handbuch zur Datenvorbereitung-Benutzeroberfläche.

Alle unten aufgeführten Zuordnungen sind obligatorisch und sollten eingerichtet werden, bevor Sie mit dem Überprüfen Bühne.

Zielfeld Beschreibung
object_type Der Objekttyp, siehe Customer.io events Dokumentation für die unterstützten Typen.
id Die Kennung des Objekts.
email Die mit dem Objekt verknüpfte E-Mail-Adresse.
event_id Die eindeutige Kennung des Ereignisses.
cio_id Die Customer.io Kennung für das Ereignis.
metric dem Ereignistyp. Weitere Informationen finden Sie im Abschnitt Customer.io events Dokumentation für unterstützte Typen.
timestamp Der Zeitstempel, zu dem das Ereignis aufgetreten ist.
WICHTIG

Nicht zuordnen cio_id beim Ausführen Customer.io Webhook im test mode da keine verknüpften Felder von gesendet werden Customer.io.

Nachdem die Quelldaten erfolgreich zugeordnet wurden, wählen Sie Nächste.

Der Zuordnungsschritt des Ursprungs-Workflows.

Überprüfung

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.

Der Überprüfungsschritt des Ursprungs-Workflows.

Abrufen der Streaming-Endpunkt-URL

Mit dem erstellten Streaming-Datenfluss können Sie jetzt Ihre Streaming-Endpunkt-URL abrufen. Dieser Endpunkt wird zum Abonnieren Ihres Webhooks verwendet, sodass Ihre Streaming-Quelle mit Experience Platform kommunizieren kann.

Um die URL zu erstellen, mit der der Webhook konfiguriert wird Customer.io Sie müssen Folgendes abrufen:

  • Dataflow-ID
  • Streaming-Endpunkt

So rufen Sie Ihre Dataflow-ID und Streaming-Endpunkt, navigieren Sie zu Datenfluss-Aktivität Seite des soeben erstellten Datenflusses und kopieren Sie die Details vom unteren Rand des Eigenschaften Bedienfeld.

Der Streaming-Endpunkt in der Datenfluss-Aktivität.

Nachdem Sie Ihren Streaming-Endpunkt und Ihre Datenfluss-ID abgerufen haben, erstellen Sie eine URL basierend auf dem folgenden Muster: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Beispielsweise könnte eine konstruierte Webhook-URL wie folgt aussehen: https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0

Reporting-Webhook einrichten in Customer.io

Nachdem Sie Ihre Webhook-URL erstellt haben, können Sie jetzt Ihren Berichterstellungs-Webhook mithilfe der Customer.io -Benutzeroberfläche. Anweisungen zum Einrichten von Reporting-Webhooks finden Sie im Abschnitt Customer.io Handbuch über die Einrichtung von Webhooks.

Im Customer.io Benutzeroberfläche, geben Sie Ihre Webhook-URL im WEBHOOK ENDPOINT -Feld.

Die Benutzeroberfläche von Customer.io mit dem Webhook-Endpunktfeld

TIPP

Sie können für Ihren Berichterstellungs-Webhook eine Vielzahl verschiedener Ereignisse abonnieren. Die Nachricht jedes Ereignisses wird in Platform erfasst, wenn eine Customer.io die Kriterien für den Trigger des Aktionsereignisses erfüllt sind. Weitere Informationen zu den verschiedenen Veranstaltungen finden Sie im Abschnitt Customer.io Ereignisdokumentation.

Nächste Schritte

In diesem Tutorial haben Sie erfolgreich einen Streaming-Datenfluss konfiguriert, um Ihre Customer.io Daten an Experience Platform. Informationen zum Überwachen der erfassten Daten finden Sie im Handbuch unter Überwachen von Streaming-Datenflüssen mithilfe der Platform-Benutzeroberfläche.

Zusätzliche Ressourcen

Die folgenden Abschnitte enthalten zusätzliche Ressourcen, auf die Sie bei der Verwendung der Variablen Customer.io -Quelle.

Leitplanken

Informationen zu Limits finden Sie im Abschnitt Customer.io Seite mit Zeitüberschreitungen und Fehlern.

Validierung

Überprüfen, ob Sie die Quelle richtig eingerichtet haben und Customer.io -Nachrichten werden erfasst, führen Sie die folgenden Schritte aus:

  • Sie können die Customer.io Aktivitätsprotokolle Seite, um die Ereignisse zu identifizieren, von denen Customer.io.

Screenshot der Benutzeroberfläche von Customer.io mit Aktivitätsprotokollen

  • Wählen Sie in der Platform-Benutzeroberfläche die Option Datenflüsse anzeigen neben dem Customer.io Kartenmenü im Quellkatalog. Wählen Sie als Nächstes Datensatz-Vorschau , um die Daten zu überprüfen, die für die Ereignisse erfasst wurden, die Sie in Customer.io.

Screenshot der Platform-Benutzeroberfläche mit aufgenommenen Ereignissen

Auf dieser Seite