Erstellen einer Marketo Engage-Quellverbindung und eines Datenflusses in der Benutzeroberfläche

IMPORTANT
Bevor Sie eine Marketo Engage -Quellverbindung und einen Datenfluss erstellen, müssen Sie zunächst sicherstellen, dass Sie Ihre Adobe-Organisations-ID🔗 in Marketo mit zugeordnet haben. Außerdem müssen Sie sicherstellen, dass Sie Ihre Marketo B2B-Namespaces und -Schemas automatisch ausgefüllt haben, bevor Sie eine Quellverbindung und einen Datenfluss erstellen.

In diesem Tutorial erfahren Sie, wie Sie einen Marketo Engage-Quell-Connector (im Folgenden als „Marketo“ abgekürzt) in der Benutzeroberfläche erstellen, um B2B-Daten in Adobe Experience Platform einzubringen.

Erste Schritte

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

  • B2B-Namespaces und Dienstprogramm zur automatischen Schemaerstellung: Mit dem Dienstprogramm B2B-Namespaces und dem Dienstprogramm zur automatischen Schemaerstellung können Sie mit Postman automatisch Werte für Ihre B2B-Namespaces und -Schemas generieren. Sie müssen zuerst Ihre B2B-Namespaces und -Schemas abschließen, bevor Sie eine Marketo -Quellverbindung und einen Datenfluss erstellen.
  • Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
  • 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 dienen, 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 Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.

Sammeln erforderlicher Anmeldeinformationen

Um auf Ihr Marketo -Konto auf dem Experience Platform zuzugreifen, müssen Sie die folgenden Werte angeben:

Anmeldedaten
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.

Weitere Informationen darüber, wie Sie diese Werte erhalten, finden Sie im Marketo Authentifizierungshandbuch.

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

Verbinden Ihres Marketo-Kontos

Wählen Sie in der Platform-Benutzeroberfläche in der linken Navigationsleiste die Option Quellen, um auf den Arbeitsbereich Quellen zuzugreifen. Sie können die gewünschte Kategorie aus dem Katalog auf der linken Bildschirmseite auswählen. Alternativ können Sie die gewünschte Quelle mithilfe der Suchoption finden.

Wählen Sie unter der Kategorie Adobe Applications die Option Marketo Engage und dann Add data.

TIP
Quellen im Quellkatalog zeigen die Option Einrichten an, wenn eine Quelle noch kein authentifiziertes Konto hat. Sobald ein authentifiziertes Konto vorhanden ist, wird diese Option in Daten hinzufügen geändert.

Der Quellkatalog mit der ausgewählten Marketo Engage-Quelle.

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

Neues Konto erstellen

Um ein neues Konto zu erstellen, wählen Sie Neues Konto aus und geben Sie einen Namen, eine optionale Beschreibung und Ihre Anmeldeinformationen ein.

Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.

Die neue Kontoschnittstelle für die Authentifizierung eines neuen Marketo-Kontos.

Vorhandenes Konto verwenden

Um ein vorhandenes Konto zu verwenden, wählen Sie Vorhandenes Konto und dann das Konto, das Sie verwenden möchten, aus dem vorhandenen Kontokatalog aus.

Klicken Sie auf Weiter, um fortzufahren.

Die vorhandene Kontoschnittstelle, über die Sie ein vorhandenes Marketo-Konto auswählen können.

Auswählen eines Datensatzes

Nachdem Sie Ihr Marketo-Konto erstellt haben, können Sie im nächsten Schritt Marketo-Datensätze untersuchen.

Die linke Hälfte der Schnittstelle ist ein Verzeichnis-Browser, der die zehn Marketo-Datensätze anzeigt. Eine voll funktionsfähige Marketo-Quellverbindung erfordert das Aufnehmen der neun verschiedenen Datensätze. Wenn Sie außerdem die Funktion Account-Based Marketing (ABM) von Marketo verwenden, müssen Sie auch einen zehnten Datenfluss erstellen, um den Datensatz Benannte Konten aufzunehmen.

NOTE
Der Kürze halber wird im folgenden Tutorial Opportunities als Beispiel verwendet, aber die unten beschriebenen Schritte gelten für jeden der zehn Marketo-Datensätze.

Wählen Sie den Datensatz aus, den Sie erfassen möchten. Dadurch wird die Benutzeroberfläche aktualisiert, um eine Vorschau Ihres Datensatzes anzuzeigen. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.

Die Vorschauoberfläche

Bereitstellen von Datensatz- und Datenflussdetails provide-dataset-and-dataflow-details

Als Nächstes müssen Sie Informationen zu Ihrem Datensatz und Ihrem Datenfluss angeben.

Datensatz-Details dataset-details

Ein Datensatz ist ein Konstrukt zur Datenspeicherung und -verwaltung, in dem Daten (in der Regel) in einer Tabelle erfasst werden, die ein Schema (Spalten) und Felder (Zeilen) beinhaltet. Daten, die erfolgreich in Experience Platform aufgenommen wurden, werden im Data Lake als Datensätze gespeichert. In diesem Schritt können Sie einen neuen Datensatz erstellen oder einen vorhandenen Datensatz verwenden.

Verwenden eines neuen Datensatzes

Um einen neuen Datensatz zu verwenden, wählen Sie Neuer Datensatz aus und geben Sie dann einen Namen und eine optionale Beschreibung für Ihren Datensatz an. Sie müssen auch ein Experience-Datenmodell (XDM)-Schema auswählen, dem Ihr Datensatz entspricht.

Die neue Oberfläche zur Datensatzauswahl.

Verwenden eines vorhandenen Datensatzes

Wenn Sie bereits über einen vorhandenen Datensatz verfügen, wählen Sie Vorhandenen Datensatz und verwenden Sie dann die Option Erweiterte Suche , um ein Fenster mit allen Datensätzen in Ihrer Organisation anzuzeigen, einschließlich der entsprechenden Details, z. B. ob sie für die Aufnahme in das Echtzeit-Kundenprofil aktiviert sind oder nicht.

Die vorhandene Oberfläche zur Datensatzauswahl.

Datenflusskonfigurationen dataflow-configurations

IMPORTANT
Die Quelle Marketo verwendet die Batch-Erfassung, um alle historischen Datensätze zu erfassen, und verwendet die Streaming-Erfassung für Echtzeit-Aktualisierungen. Dadurch kann die Quelle das Streaming fortsetzen, während fehlerhafte Datensätze erfasst werden. Aktivieren Sie den Umschalter Teilweise Aufnahme und setzen Sie dann Fehler-Schwellenwert % auf Maximum, um ein Fehlschlagen des Datenflusses zu verhindern.

Wenn Ihr Datensatz für das Echtzeit-Kundenprofil aktiviert ist, können Sie während dieses Schritts Profildatensatz umschalten, um Ihre Daten für die Profilaufnahme zu aktivieren. Sie können diesen Schritt auch verwenden, um die Fehlerdiagnose und die partielle Erfassung zu aktivieren.

  • Fehlerdiagnose: Wählen Sie Fehlerdiagnose aus, um die Quelle anzuweisen, Fehlerdiagnosen zu erstellen, die Sie später bei der Überwachung der Datensatzaktivität und des Datenflussstatus referenzieren können.
  • Partielle Erfassung: Partielle Batch-Erfassung ist die Möglichkeit, Daten mit Fehlern bis zu einem bestimmten konfigurierbaren Schwellenwert zu erfassen. Mit dieser Funktion können Sie alle Ihre präzisen Daten erfolgreich in Experience Platform erfassen, während all Ihre falschen Daten separat mit Informationen darüber gestapelt werden, warum sie ungültig sind.

In diesem Schritt können Sie Beispiel-Datenfluss aktivieren, um die Datenerfassung zu begrenzen und zusätzliche Kosten zu vermeiden, die durch die Erfassung aller historischen Daten, einschließlich Personen-Identitäten, entstehen.

recommendation-more-help

Kurzanleitung zur Verwendung des Beispiel-Datenflusses

Beispiel-Datenfluss ist eine Konfiguration, die Sie für Ihren Marketo -Datenfluss einrichten können, um Ihre Erfassungsrate zu begrenzen und dann Experience Platform-Funktionen auszuprobieren, ohne große Datenmengen aufnehmen zu müssen.

  • Aktivieren Sie den Beispiel-Datenfluss, um historische Daten durch Aufnahme von bis zu 100.000 Datensätzen (aus der größten Datensatz-ID) oder bis zu den letzten 10 Tagen Aktivität während des Aufstockungsvorgangs zu begrenzen.
  • Bei der Verwendung der Beispiel-Datenfluss-Konfiguration für alle B2B-Entitäten müssen Sie beachten, dass möglicherweise einige verwandte Datensätze fehlen, da der gesamte Verlauf der Quelldaten nicht erfasst wird.

Der Abschnitt mit den Datenfluss-Konfigurationen auf der Datenfluss-Detailseite.

Wenn Sie Daten aus dem Datensatz "Unternehmen"erfassen, können Sie außerdem Nicht beanspruchte Konten ausschließen aktivieren, um nicht beanspruchte Konten von der Erfassung auszuschließen.

Wenn Einzelpersonen ein Formular ausfüllen, erstellt Marketo einen Phantomkontodatensatz, der auf dem Unternehmensnamen basiert, der keine anderen Daten enthält. Bei neuen Datenflüssen ist die Umschaltung zum Ausschließen nicht beanspruchter Konten standardmäßig aktiviert. Für vorhandene Datenflüsse können Sie die Funktion aktivieren oder deaktivieren, wobei Änderungen auf neu aufgenommene Daten und nicht auf vorhandene Daten angewendet werden.

Nicht beanspruchte Konten ausschließen

Zuordnen Ihrer Marketo-Datensatz-Quellfelder zu XDM-Zielfeldern

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.

Für jeden Datensatz des Typs Marketo gibt es eigene spezifische Zuordnungsregeln, die befolgt werden müssen. Weitere Informationen dazu, wie Sie Marketo-Datensätze XDM zuordnen, finden Sie nachstehend:

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 finden Sie im Handbuch zur Datenvorbereitungs-Benutzeroberfläche.

Die Zuordnungsschnittstelle für Marketo-Daten.

Wenn Ihre Mapping-Sets fertig sind, klicken Sie auf Weiter und warten Sie einige Augenblicke, während der neue Datenfluss hergestellt wird.

Überprüfen des Datenflusses

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 Quellentität und die Anzahl der Spalten innerhalb dieser Quellentität 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, wählen Sie Speichern und Aufnehmen und gewähren Sie etwas Zeit für die Herstellung des Datenflusses.

Die Überprüfungsseite, auf der Sie Details Ihres Datenflusses vor der Aufnahme bestätigen können.

Überwachen Ihres Datenflusses

Nachdem Ihr Datenfluss hergestellt worden ist, können Sie Daten, die dadurch aufgenommen werden, überwachen, um Informationen zu Aufnahmegeschwindigkeiten, 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.

Löschen Ihrer Attribute

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 entfernen möchten, müssen Sie einen neuen Datensatz ohne dieses benutzerdefinierte Attribut sowie ein neues XDM-Schema erstellen und für den neuen Datensatz, den Sie erstellen, einen neuen Datenfluss konfigurieren. Außerdem müssen Sie den ursprünglichen Datenfluss deaktivieren oder löschen, der aus dem Datensatz mit dem benutzerdefinierten Attribut besteht, das Sie ausblenden oder entfernen möchten.

Löschen des Datenflusses

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

Nächste Schritte

In diesem Tutorial haben Sie erfolgreich einen Datenfluss erstellt, um B2B-Daten von Ihrer Marketo Engage -Quelle an Experience Platform zu erfassen.

Anhang appendix

Die folgenden Abschnitte enthalten zusätzliche Richtlinien, die Sie bei der Verwendung der Marketo-Quelle befolgen können.

Fehlermeldungen in der Benutzeroberfläche error-messages

Die folgenden Fehlermeldungen werden in der Benutzeroberfläche angezeigt, wenn Platform Probleme mit Ihrem Setup erkennt:

Munchkin ID ist der entsprechenden Organisation nicht zugeordnet

Die Authentifizierung wird verweigert, wenn Ihr Munchkin ID nicht der von Ihnen verwendeten Platform-Organisation zugeordnet ist. Konfigurieren Sie die Zuordnung zwischen Ihrem Munchkin ID und Ihrer Organisation mithilfe der Marketo Benutzeroberfläche.

Eine Fehlermeldung, die anzeigt, dass die Marketo-Instanz der Adobe-Organisation nicht korrekt zugeordnet ist.

Primäre Identität fehlt

Wenn eine primäre Identität fehlt, kann ein Datenfluss nicht gespeichert und erfasst werden. Stellen Sie sicher, dass eine primäre Identität in Ihrem XDM-Schema vorhanden ist, bevor Sie versuchen, einen Datenfluss zu konfigurieren.

Eine Fehlermeldung, die anzeigt, dass die primäre Identität im XDM-Schema fehlt.

337b99bb-92fb-42ae-b6b7-c7042161d089