Erstellen einer Marketo Engage Quellverbindung und eines Datenflusses in der Benutzeroberfläche
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 B2B-Namespace- und dem Dienstprogramm zur automatischen Schemaerstellung können Sie Postman verwenden, um automatisch Werte für Ihre B2B-Namespaces und -Schemas zu generieren. Sie müssen zuerst Ihre B2B-Namespaces und -Schemata 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.
- Erstellen und Bearbeiten von Schemata in der Benutzeroberfläche: Erfahren Sie, wie Sie in der Benutzeroberfläche Schemata erstellen und bearbeiten.
- 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 Anmeldedaten
Um auf Ihr Marketo-Konto auf Experience Platform zugreifen zu können, müssen Sie die folgenden Werte angeben:
munchkinId
clientId
clientSecret
Weitere Informationen darüber, wie Sie diese Werte erhalten, finden Sie im Marketo Authentifizierungshandbuch.
Nachdem Sie die erforderlichen Anmeldedaten 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 Anwendungen} Marketo Engage und dann Daten hinzufügen aus.
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.
Um ein neues Konto zu erstellen, wählen Neues Konto und geben Sie einen Namen, eine optionale Beschreibung und Ihre -Anmeldeinformationen an.
Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.
Um ein vorhandenes Konto zu verwenden, wählen Sie Vorhandenes Konto und dann das Konto, das Sie verwenden möchten, aus dem vorhandenen Kontenkatalog aus.
Klicken Sie auf Weiter, um fortzufahren.
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.
Wählen Sie den Datensatz aus, den Sie aufnehmen möchten. Dadurch wird die Benutzeroberfläche aktualisiert, damit eine Vorschau Ihres Datensatzes angezeigt wird. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.
Datensatz- und Datenflussdetails angeben 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 erfasst werden, werden im Data Lake als Datensätze gespeichert. In diesem Schritt können Sie einen neuen Datensatz erstellen oder einen vorhandenen Datensatz verwenden.
Um einen neuen Datensatz zu verwenden, wählen Neuer Datensatz und geben Sie dann einen Namen und eine optionale Beschreibung für Ihren Datensatz an. Sie müssen auch ein Experience-Datenmodell-Schema (XDM) auswählen, dem Ihr Datensatz entspricht.
Wenn Sie bereits über einen vorhandenen Datensatz verfügen, wählen Sie Vorhandener Datensatz und verwenden Sie dann die Option Erweiterte Suche, um ein Fenster aller Datensätze 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.
Datenflusskonfigurationen dataflow-configurations
Wenn Ihr Datensatz für das Echtzeit-Kundenprofil aktiviert ist, können Sie in diesem Schritt Profildatensatz umschalten, um Ihre Daten für die Profilaufnahme zu aktivieren. Sie können diesen Schritt auch verwenden, um Fehlerdiagnose und Partielle Aufnahme zu aktivieren.
- Fehlerdiagnose: Wählen Sie Fehlerdiagnose aus, um die Quelle anzuweisen, Fehlerdiagnosen zu erstellen, auf die Sie später bei der Überwachung Ihrer Datensatzaktivität und des Datenflussstatus verweisen können.
- Partielle Aufnahme: Partielle Batch-Aufnahme ist die Möglichkeit, Daten mit Fehlern bis zu einem bestimmten konfigurierbaren Schwellenwert aufzunehmen. Mit dieser Funktion können Sie alle Ihre korrekten Daten erfolgreich in Experience Platform aufnehmen, während alle Ihre falschen Daten separat mit Informationen darüber, warum sie ungültig sind, in Batches erfasst werden.
In diesem Schritt können Sie "-Datenfluss“ aktivieren um die Datenaufnahme zu begrenzen und zusätzliche Kosten zu vermeiden, die mit der Aufnahme aller historischen Daten, einschließlich Personenidentitäten, verbunden sind.
Kurzanleitung zur Verwendung von Beispiel-Datenflüssen
Beispieldatenfluss ist eine Konfiguration, die Sie für Ihren Marketo Datenfluss festlegen können, um Ihre Aufnahmegeschwindigkeit zu begrenzen und dann Experience Platform-Funktionen auszuprobieren, ohne große Datenmengen aufnehmen zu müssen.
- Aktivieren Sie den Beispieldatenfluss, um historische Daten zu beschränken, indem Sie bis zu 100.000 Datensätze (von der größten Datensatz-ID) oder die letzten 10 Tage der Aktivität während des Aufstockungsauftrags aufnehmen.
- Bei Verwendung der Beispiel-Datenflusskonfiguration für alle B2B-Entitäten müssen Sie berücksichtigen, dass möglicherweise einige verwandte Datensätze fehlen, da der gesamte Verlauf der Quelldaten nicht aufgenommen wird.
Wenn Sie Daten aus dem Unternehmensdatensatz aufnehmen, können Sie außerdem „Nicht beanspruchte Konten ausschließen aktivieren um nicht beanspruchte Konten von der Aufnahme auszuschließen.
Wenn Einzelpersonen ein Formular ausfüllen, erstellt Marketo einen Phantomkontodatensatz auf Grundlage des Firmennamens, der keine anderen Daten enthält. Bei neuen Datenflüssen ist der Umschalter zum Ausschließen nicht beanspruchter Konten standardmäßig aktiviert. Bei vorhandenen Datenflüssen können Sie die Funktion aktivieren oder deaktivieren, wobei Änderungen auf neu aufgenommene Daten und nicht auf vorhandene Daten angewendet werden.
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.
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.
Ü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 aus Ihrer Marketo Engage in Experience Platform aufzunehmen.
Anhang appendix
Die folgenden Abschnitte enthalten zusätzliche Richtlinien, die Sie bei der Verwendung der Marketo 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 Ihrer Munchkin ID und Ihrer Organisation mithilfe der Marketo Benutzeroberfläche.
Primäre Identität fehlt
Ein Datenfluss kann nicht gespeichert und aufgenommen werden, wenn eine primäre Identität fehlt. Stellen Sie sicher dass in Ihrem XDM-Schema eine primäre Identität vorhanden ist bevor Sie versuchen, einen Datenfluss zu konfigurieren.