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 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.
- 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 Anmeldeinformationen
Um auf Ihr Marketo -Konto auf dem Experience Platform zuzugreifen, 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 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.
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 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.
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.
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 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.
Bereitstellen von Datensatz- und Datenflussdetails :headding-anchor:provide-dataset-and-dataflow-details
Als Nächstes müssen Sie Informationen zu Ihrem Datensatz und Ihrem Datenfluss angeben.
Datensatz-Details :headding-anchor: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.
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.
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.
Datenflusskonfigurationen :headding-anchor:dataflow-configurations
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.
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.
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.
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 von Ihrer Marketo Engage -Quelle an Experience Platform zu erfassen.
Anhang :headding-anchor:appendix
Die folgenden Abschnitte enthalten zusätzliche Richtlinien, die Sie bei der Verwendung der Marketo-Quelle befolgen können.
Fehlermeldungen in der Benutzeroberfläche :headding-anchor: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.
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.