(Beta) Erstellen eines Quell-Connectors Marketo Engage in der Benutzeroberfläche

WICHTIG

Die Quelle Marketo Engage befindet sich derzeit in der Beta-Phase. Die Funktion und Dokumentation ändern sich. Darüber hinaus müssen Sie sicherstellen, dass Sie bei Verwendung des Connectors während des Betaprogramms eine Nicht-Produktions-Sandbox verwenden. Weiterführende Informationen zu Sandboxes finden Sie in der Sandboxes-Dokumentation.

In diesem Tutorial werden Schritte zum Erstellen eines Quell-Connectors für Marketo Engage (nachfolgend als "Marketo"bezeichnet) in der Benutzeroberfläche beschrieben, um Verbraucherdaten in Adobe Experience Platform zu importieren.

Erste Schritte

Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Adobe Experience Platform voraus:

  • Quellen: Experience Platform ermöglicht die Erfassung von Daten aus verschiedenen Quellen und bietet Ihnen gleichzeitig die Möglichkeit, eingehende Daten mithilfe von Platform-Diensten zu strukturieren, zu beschriften und zu erweitern.
  • Experience-Datenmodell (XDM): Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.
  • Identitäts-Namespaces: Identitäts-Namespaces sind eine Komponente von , Identity Service die als Indikatoren für den Kontext dient, auf den sich eine Identität bezieht. Eine vollqualifizierte Identität umfasst einen ID-Wert und einen Namespace.
  • Real-time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.
  • Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Anwendungen für digitale Erlebnisse entwickeln und weiterentwickeln können.

Erforderliche Anmeldedaten sammeln

Um auf Ihr Marketo-Konto in Platform zugreifen zu können, müssen Sie die folgenden Werte angeben:

Berechtigung Beschreibung
munchkinId Die Munchkin-ID ist die eindeutige Kennung für eine bestimmte Marketo-Instanz.
clientId Die eindeutige Client-ID Ihrer Marketo-Instanz.
clientSecret Das eindeutige Client-Geheimnis Ihrer Marketo-Instanz.

Weiterführende Informationen zum Erwerb dieser Werte finden Sie im Marketo Authentifizierungshandbuch.

Nachdem Sie die erforderlichen Anmeldeinformationen gesammelt haben, können Sie die Schritte im nächsten Abschnitt ausführen.

Ihr Marketo-Konto verbinden

Wählen Sie in der Platform-Benutzeroberfläche Quellen aus der linken Navigationsleiste aus, um auf den Arbeitsbereich Quellen zuzugreifen. Der Bildschirm Katalog enthält eine Vielzahl von Quellen, für die Sie ein Konto erstellen können.

Sie können die gewünschte Kategorie aus dem Katalog auf der linken Bildschirmseite auswählen. Alternativ können Sie die gewünschte Quelle über die Suchleiste finden.

Wählen Sie unter der Kategorie Adobe Applications die Option Marketo Engage aus. Wählen Sie dann Daten hinzufügen aus, um einen neuen Marketo-Datenfluss zu erstellen.

Katalog

Die Seite Mit Marketo Engage verbinden wird angezeigt. Auf dieser Seite können Sie entweder ein neues Konto verwenden oder auf ein vorhandenes Konto zugreifen.

Neues Konto

Wenn Sie ein neues Konto erstellen, wählen Sie Neues Konto aus. Geben Sie im angezeigten Formular einen Kontonamen, eine optionale Beschreibung und Ihre Marketo-Authentifizierungsdaten ein. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden aus und lassen Sie dann etwas Zeit für die Einrichtung der neuen Verbindung zu.

new-account

Vorhandenes Konto

Um einen Datenfluss mit einem vorhandenen Konto zu erstellen, wählen Sie Vorhandenes Konto und dann das Marketo-Konto aus, das Sie verwenden möchten. Wählen Sie Weiter aus, um fortzufahren.

vorhandene

Datensatz auswählen

Nachdem Sie Ihr Marketo-Konto erstellt haben, bietet der nächste Schritt eine Oberfläche zum Erkunden von Marketo -Datensätzen.

Die linke Hälfte der Oberfläche ist ein Verzeichnisbrowser, in dem die 10 Marketo Datensätze angezeigt werden. Eine voll funktionsfähige Marketo Quellverbindung erfordert die Aufnahme der neun verschiedenen Datensätze. Wenn Sie auch die Funktion Marketo Konto-basiertes Marketing (ABM) verwenden, müssen Sie auch einen 10. Datenfluss erstellen, um den Datensatz Spezifische Konten zu erfassen.

HINWEIS

Aus Gründen der Kürze wird im folgenden Tutorial Spezifische Konten als Beispiel verwendet. Die unten beschriebenen Schritte gelten jedoch für alle 10 Marketo-Datensätze.

Wählen Sie zuerst den Datensatz aus, den Sie erfassen möchten, und wählen Sie dann Weiter aus.

select-data

Marketo-Schemata Platform zuordnen

Der Schritt Mapping wird angezeigt und stellt eine Schnittstelle bereit, um Marketo-Schemas Platform zuzuordnen.

Wählen Sie einen Datensatz für eingehende Daten aus, die in aufgenommen werden sollen. Sie können entweder einen vorhandenen Datensatz verwenden oder einen neuen Datensatz erstellen.

Vorhandenen Datensatz verwenden

Um Daten in einen vorhandenen Datensatz zu erfassen, wählen Sie Vorhandenen Datensatz und dann das Datensatzsymbol aus.

existing-dataset

Das Dialogfeld Datensatz auswählen wird angezeigt. Suchen Sie den Datensatz mit dem entsprechenden Schema, das Sie verwenden möchten, wählen Sie ihn aus und wählen Sie dann Bestätigen aus.

select-existing-dataset

Verwenden eines neuen Datensatzes

Um Daten in einen neuen Datensatz zu erfassen, wählen Sie Neuer Datensatz aus und geben Sie einen Namen und eine Beschreibung für den Datensatz in die bereitgestellten Felder ein.

Sie können nach einem Schema suchen, indem Sie dessen Namen in die Suchleiste Schema auswählen eingeben. Sie können auch das Dropdown-Symbol auswählen, um eine Liste der vorhandenen Schemas anzuzeigen. Alternativ können Sie Erweiterte Suche auswählen, um auf die Seite vorhandener Schemas mit ihren jeweiligen Details zuzugreifen.

Schalten Sie die Schaltfläche Profildatensatz um, um Ihren Zieldatensatz für Profile zu aktivieren, sodass Sie eine ganzheitliche Ansicht der Attribute und Verhaltensweisen einer Entität erstellen können. Daten aus allen Profile-aktivierten Datensätzen werden in Profile einbezogen und Änderungen werden angewendet, wenn Sie Ihren Datenfluss speichern.

create-new-dataset

Nachdem Sie ein Schema ausgewählt haben, scrollen Sie nach unten, um das Zuordnungsdialogfeld anzuzeigen, um mit der Zuordnung Ihrer Marketo-Datensatzfelder zu den entsprechenden Ziel-XDM-Feldern zu beginnen.

Ordnen Sie Ihre Marketo -Datensatzquellenfelder den XDM-Zielfeldern zu.

Jeder Marketo-Datensatz verfügt über eigene spezifische Zuordnungsregeln, die befolgt werden müssen. Weitere Informationen zum Zuordnen von Marketo-Datensätzen zu XDM finden Sie im Folgenden:

Wählen Sie Vorschau der Daten aus, um die Zuordnungsergebnisse basierend auf Ihrem ausgewählten Datensatz anzuzeigen.

Mapping

Das Vorschau-Popup bietet Ihnen eine Schnittstelle zur Erforschung der Zuordnungsergebnisse von bis zu 100 Zeilen mit Beispieldaten aus dem ausgewählten Datensatz.

Vorschau

Nachdem die Quellfelder den entsprechenden Zielfeldern zugeordnet wurden, wählen Sie Close aus.

Datenflussdetails angeben

Der Schritt Datenfluss-Detail wird angezeigt, mit dem Sie einen Namen und eine kurze Beschreibung zu Ihrem neuen Datenfluss angeben können.

dataflow-detail

Aktivieren Sie den Umschalter Fehlerdiagnose , um die detaillierte Generierung von Fehlermeldungen für neu aufgenommene Batches zu ermöglichen, die Sie über die API herunterladen können. Weitere Informationen finden Sie im Tutorial zum Abrufen der Fehlerdiagnose bei der Datenerfassung a1/>.

errors

Der Connector Marketo verwendet die Batch-Erfassung, um alle historischen Datensätze zu erfassen, und verwendet die Streaming-Erfassung für Echtzeit-Aktualisierungen. Dadurch kann der Connector das Streaming fortsetzen, während er fehlerhafte Datensätze erfasst. Aktivieren Sie den Umschalter Partielle Erfassung und setzen Sie dann den Fehlerschwellenwert % auf "Maximum", um zu verhindern, dass der Datenfluss fehlschlägt.

Die partielle Erfassung bietet die Möglichkeit, Daten mit Fehlern bis zu einem bestimmten Schwellenwert zu erfassen. Weitere Informationen finden Sie unter Übersicht über die partielle Batch-Erfassung.

Nachdem Sie die Details des Datenflusses angegeben und den Fehlerschwellenwert auf max gesetzt haben, wählen Sie Weiter aus.

partielle Erfassung

Überprüfen Sie Ihren Datenfluss.

Der Schritt Überprüfen wird angezeigt, mit dem Sie Ihren neuen Datenfluss überprüfen können, bevor er erstellt wird. Details werden in die folgenden Kategorien eingeteilt:

  • Verbindung: Zeigt den Quelltyp, den relevanten Pfad der ausgewählten Quellentität und die Anzahl der Spalten innerhalb dieser Quellentität an.
  • Zuweisen von Datensatz- und Zuordnungsfeldern: Zeigt, in welchen Datensatz die Quelldaten aufgenommen werden, einschließlich des Schemas, dem der Datensatz entspricht.

Nachdem Sie Ihren Datenfluss überprüft haben, wählen Sie Beenden aus und lassen Sie einige Zeit für die Erstellung des Datenflusses zu.

Überprüfung

Überwachen Ihres Datenflusses

Nachdem Ihr Datenfluss erstellt wurde, können Sie die erfassten Daten überwachen, um Informationen zu Erfassungsraten, Erfolg und Fehlern zu erhalten. Weitere Informationen zum Überwachen von Datenflüssen finden Sie im Tutorial zum Überwachen von Datenflüssen in der Benutzeroberfläche.

Attribute löschen

Benutzerdefinierte Attribute in Datensätzen können nicht rückwirkend ausgeblendet oder entfernt werden. Wenn Sie ein benutzerdefiniertes Attribut aus einem vorhandenen Datensatz ausblenden oder daraus entfernen möchten, müssen Sie einen neuen Datensatz ohne dieses benutzerdefinierte Attribut und ein neues XDM-Schema erstellen und einen neuen Datenfluss für den neuen Datensatz konfigurieren, den Sie erstellen. Sie müssen auch den ursprünglichen Datenfluss deaktivieren oder löschen, der aus dem Datensatz mit dem benutzerdefinierten Attribut besteht, das Sie ausblenden oder entfernen möchten.

Datenfluss löschen

Sie können Datenflüsse löschen, die nicht mehr erforderlich sind oder falsch erstellt wurden, indem Sie die Funktion Delete verwenden, die im Arbeitsbereich Datenflüsse verfügbar ist. Weitere Informationen zum Löschen von Datenflüssen finden Sie im Tutorial zum Löschen von Datenflüssen in der Benutzeroberfläche🔗.

Nächste Schritte

In diesem Tutorial haben Sie erfolgreich einen Datenfluss erstellt, um Marketo-Daten einzubringen. Eingehende Daten können jetzt von nachgelagerten Platform-Diensten wie Real-time Customer Profile und Data Science Workspace verwendet werden. Weitere Informationen finden Sie in den folgenden Dokumenten:

Auf dieser Seite