Erstellen einer Marketo Engage Quellverbindung und eines Datenflusses für benutzerdefinierte Aktivitätsdaten in der Benutzeroberfläche
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.
- 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.
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.
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.
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.
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.
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.
Nach der Erstellung wird die neue Feldergruppe für die benutzerdefinierte Aktivität im Katalog Feldergruppen angezeigt.
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.
Das neue Feld wird in Ihrem Schema angezeigt.
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.
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.
Daten auswählen
Wählen Sie Aktivitäten aus der Liste Marketo Datensätze aus und klicken Sie dann auf Weiter.
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.
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.
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.
Um ein Zielfeld hinzuzufügen, wählen Sie das Schemasymbol
Wiederholen Sie die Schritte, um den Rest Ihrer benutzerdefinierten Aktivitätszuordnungsfelder hinzuzufügen. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.
Ü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.
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.
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.