Erstellen einer Marketo Engage Quellverbindung und eines Datenflusses für benutzerdefinierte Aktivitätsdaten in der Benutzeroberfläche

NOTE
In diesem Tutorial erfahren Sie, wie Sie (-Aktivitätsdaten von Marketo auf Experience Platform einrichten und übertragen. Anweisungen zum Einbringen von Daten Standardaktivität finden Sie im Marketo UI-Handbuch.

Zusätzlich zu Standardaktivitäten können Sie auch die Marketo verwenden, um benutzerdefinierte Aktivitätsdaten in Adobe Experience Platform zu übertragen. In diesem Dokument wird beschrieben, wie Sie eine Quellverbindung und einen Datenfluss für benutzerdefinierte Aktivitätsdaten mithilfe der Marketo in der Benutzeroberfläche erstellen.

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

Abrufen von Details zur benutzerdefinierten Aktivität

Um benutzerdefinierte Aktivitätsdaten von Marketo auf Experience Platform zu übertragen, müssen Sie als Erstes den API-Namen und den Anzeigenamen Ihrer benutzerdefinierten Aktivität abrufen.

Melden Sie sich über die Marketo-Oberfläche bei Ihrem Konto an. Wählen Sie in der linken Navigationsleiste unter Database Management die Option Benutzerdefinierte Marketo-Aktivitäten.

Die Benutzeroberfläche wird aktualisiert und zeigt jetzt benutzerdefinierte Aktivitäten an, einschließlich Informationen zu ihren jeweiligen Anzeigenamen und API-Namen. Sie können auch die rechte Leiste verwenden, um andere benutzerdefinierte Aktivitäten in Ihrem Konto auszuwählen und anzuzeigen.

Die Benutzeroberfläche für benutzerdefinierte Aktivitäten in der Adobe Marketo Engage-Benutzeroberfläche.

Wählen Sie Felder in der oberen Kopfzeile aus, um die mit Ihrer benutzerdefinierten Aktivität verknüpften Felder anzuzeigen. Auf dieser Seite können Sie die Namen, API-Namen, Beschreibungen und Datentypen der Felder in Ihrer benutzerdefinierten Aktivität anzeigen. Details zu einzelnen Feldern werden in einem späteren Schritt beim Erstellen eines Schemas verwendet.

Die Detailseite für benutzerdefinierte Aktivitätsfelder von Marketo in der Marketo Engage-Benutzeroberfläche.

Feldergruppen für benutzerdefinierte Aktivitäten im Schema der B2B-Aktivitäten einrichten

Wählen Sie im Dashboard Schemata der Experience Platform-Benutzeroberfläche die Option Durchsuchen und wählen Sie dann B2B- aus der Liste der Schemata aus.

TIP
Verwenden Sie die Suchleiste, um die Navigation durch die Liste der Schemata zu beschleunigen.

Der Arbeitsbereich „Schemata“ in der Experience Platform-Benutzeroberfläche mit ausgewähltem Schema der B2B-Aktivität.

Erstellen einer neuen Feldergruppe für eine benutzerdefinierte Aktivität

Fügen Sie als Nächstes eine neue Feldergruppe zum B2B Activity hinzu. Diese Feldergruppe sollte mit der benutzerdefinierten Aktivität übereinstimmen, die Sie aufnehmen möchten, und den Anzeigenamen der benutzerdefinierten Aktivität verwenden, den Sie zuvor abgerufen haben.

Um eine neue Feldergruppe hinzuzufügen, wählen Sie + Hinzufügen neben dem Feldergruppen unter Komposition.

Die Schemastruktur.

Das Feldergruppen hinzufügen wird angezeigt. Wählen Sie Neue Feldergruppe erstellen und geben Sie dann denselben Anzeigenamen für die benutzerdefinierte Aktivität an, die Sie in einem früheren Schritt abgerufen haben, und geben Sie eine optionale Beschreibung für Ihre neue Feldergruppe an. Wählen Sie abschließend Feldergruppen hinzufügen aus.

Das Fenster zum Kennzeichnen und Erstellen einer neuen Feldergruppe.

Nach der Erstellung wird die neue Feldergruppe für die benutzerdefinierte Aktivität im Katalog Feldergruppen angezeigt.

Die Schemastruktur mit einer neuen Feldergruppe, die unter dem Bedienfeld „Feldergruppe“ hinzugefügt wurde.

Hinzufügen eines neuen Felds zur Schemastruktur

Fügen Sie als Nächstes ein neues Feld zu Ihrem Schema hinzu. Dieses neue Feld muss auf type: object gesetzt werden und enthält die einzelnen Felder der benutzerdefinierten Aktivität.

Um ein neues Feld hinzuzufügen, wählen Sie das Pluszeichen (+) neben dem Schemanamen aus. Ein Eintrag für "Feld“ | Typ wird angezeigt. Konfigurieren Sie anschließend die Eigenschaften Ihres Felds mithilfe des Bedienfelds Feldeigenschaften. Legen Sie den Feldnamen als API-Namen Ihrer benutzerdefinierten Aktivität fest und legen Sie den Anzeigenamen als Anzeigenamen Ihrer benutzerdefinierten Aktivität fest. Legen Sie dann den Typ als object fest und weisen Sie die Feldergruppe der benutzerdefinierten Aktivitätsfeldgruppe zu, die Sie im vorherigen Schritt erstellt haben. Wenn Sie fertig sind, wählen Sie Anwenden aus.

Die Schemastruktur mit ausgewähltem Pluszeichen () , sodass ein neues Feld hinzugefügt werden kann.

Das neue Feld wird in Ihrem Schema angezeigt.

Ein neues Feld wurde zum Schema hinzugefügt.

Hinzufügen von Unterfeldern zum Objektfeld add-sub-fields-to-the-object-field

Der letzte Schritt bei der Vorbereitung Ihres Schemas besteht darin, einzelne Felder in dem Feld hinzuzufügen, das Sie im vorherigen Schritt erstellt haben.

Eine Gruppe von Unterfeldern, die zu einem Feld im Schema hinzugefügt werden.

Erstellen eines Datenflusses

Nachdem Sie Ihr Schema fertig eingerichtet haben, können Sie nun mit dem Erstellen eines Datenflusses für Ihre benutzerdefinierten Aktivitätsdaten fortfahren.

Wählen Sie in der Platform-Benutzeroberfläche die Option Quellen in der linken Navigationsleiste, um auf den Arbeitsbereich Quellen zuzugreifen. Die Katalog zeigt eine Vielzahl von Quellen an, mit denen 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 mithilfe der Suchleiste finden.

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

Der Quellkatalog auf der Experience Platform-Benutzeroberfläche mit der ausgewählten Marketo Engage-Quelle.

Daten auswählen

Wählen Sie Aktivitäten aus der Liste Marketo Datensätze aus und klicken Sie dann auf Weiter.

Der Schritt „Daten auswählen“ im Quell-Workflow mit dem ausgewählten Aktivitäts-Datensatz.

Datenflussdetails

Geben anschließend Informationen für Ihren Datenfluss, einschließlich Namen und Beschreibungen für Ihren Datensatz und Datenfluss, das Schema, das Sie verwenden werden, und Konfigurationen für die Profile, Fehlerdiagnose und partielle Aufnahme.

Der Schritt „Datenflussdetails“.

Zuordnung

Zuordnungen für standardmäßige Aktivitätsfelder werden automatisch ausgefüllt, aber benutzerdefinierte Aktivitätsfelder müssen den entsprechenden Zielfeldern manuell zugeordnet werden.

Um mit der Zuordnung Ihrer benutzerdefinierten Aktivitätsfelder zu beginnen, wählen Sie Neuer Feldtyp und dann Neues Feld hinzufügen aus.

Der Zuordnungsschritt mit dem Dropdown-Menü zum Hinzufügen eines neuen Felds.

Navigieren Sie durch die Quelldatenstruktur und suchen Sie nach dem benutzerdefinierten Aktivitätsfeld, das Sie aufnehmen möchten. Wenn Sie fertig sind, wählen Auswählen.

TIP
Um Verwirrung zu vermeiden und doppelte Feldnamen zu verarbeiten, werden benutzerdefinierte Aktivitätsfelder mit dem Präfix des API-Namens versehen.

Die Struktur der Quelldaten.

Um ein Zielfeld hinzuzufügen, wählen Sie das Schemasymbol Schemasymbol und dann die benutzerdefinierten Aktivitätsfelder aus dem Zielschema aus.

Die Struktur des Zielschemas.

Wiederholen Sie die Schritte, um den Rest Ihrer benutzerdefinierten Aktivitätszuordnungsfelder hinzuzufügen. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.

Alle Zuordnungen für Quell- und Zieldaten.

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

Der letzte Überprüfungsschritt, der Informationen zu den Verbindungs-, Datensatz- und Zuordnungsfeldern zusammenfasst.

Hinzufügen benutzerdefinierter Aktivitäten zu einem vorhandenen Aktivitäts-Datenfluss add-to-existing-dataflows

Um einem vorhandenen Datenfluss benutzerdefinierte Aktivitätsdaten hinzuzufügen, ändern Sie die Zuordnungen eines vorhandenen Aktivitäts-Datenflusses zu den benutzerdefinierten Aktivitätsdaten, die Sie aufnehmen möchten. Auf diese Weise können Sie benutzerdefinierte Aktivitäten in denselben vorhandenen Aktivitätsdatensatz aufnehmen. Weitere Informationen zum Aktualisieren der Zuordnungen eines vorhandenen Datenflusses finden Sie im Handbuch unter Aktualisieren von Datenflüssen in der Benutzeroberfläche.

Verwenden von Query Service zum Filtern von Aktivitäten nach benutzerdefinierten Aktivitäten query-service-filter

Sobald Ihr Datenfluss abgeschlossen ist, können Sie Abfrage-Service verwenden, um Aktivitäten für Ihre benutzerdefinierten Aktivitätsdaten zu filtern.

Wenn benutzerdefinierte Aktivitäten in Platform aufgenommen werden, wird der API-Name der benutzerdefinierten Aktivität automatisch zu ihrer eventType. Verwenden Sie eventType={API_NAME}, um nach benutzerdefinierten Aktivitätsdaten zu filtern.

SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'

Verwenden Sie die IN-Klausel, um mehrere benutzerdefinierte Aktivitäten zu filtern:

SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')

Die folgende Abbildung zeigt eine Beispiel-SQL-Anweisung im Abfrage-Editor die nach benutzerdefinierten Aktivitätsdaten filtert.

Platform-Benutzeroberfläche mit einem Abfragebeispiel für benutzerdefinierte Aktivitäten.

Nächste Schritte

In diesem Tutorial haben Sie ein Platform-Schema für die Marketo benutzerdefinierter Aktivitätsdaten eingerichtet und einen Datenfluss erstellt, um diese Daten in Platform zu übertragen. Allgemeine Informationen zur Marketo finden Sie im Abschnitt Marketo Quelle - Übersicht.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089