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 -Quelle verwenden, um benutzerdefinierte Aktivitätsdaten an 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 -Quelle 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 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.
Abrufen Ihrer benutzerdefinierten Aktivitätsdetails
Der erste Schritt beim Abrufen benutzerdefinierter Aktivitätsdaten von Marketo an Experience Platform besteht darin, den API-Namen und den Anzeigenamen Ihrer benutzerdefinierten Aktivität abzurufen.
Melden Sie sich mit der Oberfläche von Marketo bei Ihrem Konto an. Wählen Sie im linken Navigationsbereich unter Database Management die Option Marketo Custom Activities.
Die Benutzeroberfläche aktualisiert eine Anzeige Ihrer benutzerdefinierten Aktivitäten, einschließlich Informationen zu ihren jeweiligen Anzeigenamen und API-Namen. Sie können auch die rechte Leiste verwenden, um andere benutzerdefinierte Aktivitäten aus Ihrem Konto auszuwählen und anzuzeigen.
Wählen Sie in der oberen Kopfzeile Felder aus, um die Felder anzuzeigen, die mit Ihrer benutzerdefinierten Aktivität verknüpft sind. 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 bei der Erstellung eines Schemas verwendet.
Einrichten von Feldergruppen für benutzerdefinierte Aktivitäten im Schema B2B-Aktivitäten
Wählen Sie im Dashboard Schemas der Experience Platform-Benutzeroberfläche die Option Durchsuchen und wählen Sie dann B2B-Aktivität aus der Schemasiste.
Neue Feldergruppe für benutzerdefinierte Aktivität erstellen
Fügen Sie anschließend eine neue Feldergruppe zum Schema B2B Activity hinzu. Diese Feldergruppe sollte mit der benutzerdefinierten Aktivität übereinstimmen, die Sie erfassen 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 Bereich "Feldergruppen"unter "Zusammensetzung".
Das Fenster Feldgruppen hinzufügen wird angezeigt. Wählen Sie Neue Feldergruppe erstellen und geben Sie dann denselben Anzeigenamen für die benutzerdefinierte Aktivität an, den Sie in einem früheren Schritt abgerufen haben. Geben Sie dann eine optionale Beschreibung für die neue Feldergruppe ein. Wählen Sie abschließend Feldergruppen hinzufügen aus.
Nach der Erstellung erscheint Ihre neue Feldergruppe für die benutzerdefinierte Aktivität im Katalog Feldergruppen .
Hinzufügen eines neuen Felds zur Schemastruktur
Fügen Sie Ihrem Schema als Nächstes ein neues Feld 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 "Unbenanntes Feld" | Typ wird angezeigt. Konfigurieren Sie anschließend die Eigenschaften Ihres Felds mithilfe des Bereichs Feldeigenschaften . Legen Sie den Feldnamen als API-Namen Ihrer benutzerdefinierten Aktivität fest und legen Sie den Anzeigenamen als Anzeigenamen für Ihre benutzerdefinierte Aktivität fest. Legen Sie dann den Typ auf "object"fest und weisen Sie die Feldergruppe der benutzerdefinierten Feldergruppe 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 das Feld einzufügen, das Sie im vorherigen Schritt erstellt haben.
Erstellen eines Datenflusses
Nach Abschluss der Schemaeinrichtung können Sie nun einen Datenfluss für Ihre benutzerdefinierten Aktivitätsdaten erstellen.
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 der Marketo Datensätze und dann Weiter aus.
Datenflussdetails
Zuordnung
Zuordnungen für Standard-Aktivitätsfelder werden automatisch ausgefüllt, benutzerdefinierte Aktivitätsfelder müssen jedoch manuell den entsprechenden Zielfeldern zugeordnet werden.
Um Ihre benutzerdefinierten Aktivitätsfelder zuzuordnen, wählen Sie Neuer Feldtyp und dann Neues Feld hinzufügen aus.
Navigieren Sie durch die Quelldatenstruktur und suchen Sie das benutzerdefinierte Aktivitätsfeld, das Sie erfassen möchten. Wählen Sie abschließend Auswählen aus.
Um ein Zielfeld hinzuzufügen, wählen Sie das Schemasymbol
Wiederholen Sie die Schritte, um den Rest der benutzerdefinierten Felder für die Aktivitätszuordnung 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äten-Datenfluss add-to-existing-dataflows
Um einem vorhandenen Datenfluss benutzerdefinierte Aktivitätsdaten hinzuzufügen, ändern Sie die Zuordnungen eines vorhandenen Aktivitäts-Datenflusses mit den benutzerdefinierten Aktivitätsdaten, die Sie erfassen möchten. Auf diese Weise können Sie benutzerdefinierte Aktivitäten in denselben vorhandenen Aktivitäts-Datensatz aufnehmen. Weitere Informationen zum Aktualisieren der Zuordnungen eines vorhandenen Datenflusses finden Sie im Handbuch zum Aktualisieren der Datenflüsse in der Benutzeroberfläche.
Verwenden Sie Query Service, um Aktivitäten nach benutzerdefinierten Aktivitäten zu filtern. query-service-filter
Sobald Ihr Datenfluss abgeschlossen ist, können Sie Abfragedienst verwenden, um Aktivitäten nach Ihren benutzerdefinierten Aktivitätsdaten zu filtern.
Wenn benutzerdefinierte Aktivitäten in Platform erfasst werden, erhält der API-Name der benutzerdefinierten Aktivität automatisch den Wert "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 benutzerdefinierte Aktivitätsdaten vom Typ Marketo eingerichtet und einen Datenfluss erstellt, um diese Daten an Platform zu übertragen. Allgemeine Informationen zur Quelle Marketo finden Sie in der Marketo Quellübersicht.