Erstellen Sie eine Marketo Engage Quellverbindung und Datenfluss für benutzerdefinierte Aktivitätsdaten in der Benutzeroberfläche
Zusätzlich zu Standardaktivitäten, können Sie auch die Marketo -Quelle, 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 mit der Marketo -Quelle in der Benutzeroberfläche.
Erste Schritte
Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Adobe Experience Platform voraus:
- B2B-Namespaces und Dienstprogramm zur automatischen Schemaerstellung: Mithilfe der B2B-Namespaces und des Dienstprogramm zur automatischen Schemaerstellung können Sie Postman , um automatisch Werte für Ihre B2B-Namespaces und -Schemas zu generieren. Sie müssen zuerst Ihre B2B-Namespaces und -Schemas abschließen, bevor Sie eine Marketo Quellverbindung und Datenfluss.
- 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 zum Abrufen benutzerdefinierter Aktivitätsdaten aus Marketo zum Experience Platform bezeichnet, um den API-Namen und den Anzeigenamen Ihrer benutzerdefinierten Aktivität abzurufen.
Melden Sie sich mit dem Marketo -Schnittstelle. In der linken Navigation, unter Database Managementauswählen Benutzerdefinierte Marketo-Aktivitäten.
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.
Auswählen Felder aus der oberen Kopfzeile, 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 bei der Erstellung eines Schemas verwendet.
Einrichten von Feldergruppen für benutzerdefinierte Aktivitäten im Schema B2B-Aktivitäten
Im Schemas Dashboard der Experience Platform-Benutzeroberfläche auswählen Durchsuchen und wählen Sie B2B-Aktivität aus der Liste der Schemas.
Neue Feldergruppe für benutzerdefinierte Aktivität erstellen
Fügen Sie als Nächstes eine neue Feldergruppe zum B2B Activity Schema. 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 Feldergruppen Bereich unter Komposition.
Die Feldergruppen hinzufügen angezeigt. Auswählen Neue Feldergruppe erstellen Geben Sie dann denselben Anzeigenamen für die benutzerdefinierte Aktivität an, den Sie in einem früheren Schritt abgerufen haben, und geben Sie eine optionale Beschreibung für die neue Feldergruppe an. Wählen Sie zum Abschluss Feldergruppen hinzufügen.
Nach der Erstellung erscheint Ihre neue Feldergruppe für die benutzerdefinierte Aktivität im Feldergruppen Katalog.
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
und enthält die einzelnen Felder der benutzerdefinierten Aktivität.
Um ein neues Feld hinzuzufügen, wählen Sie das Pluszeichen (+
) neben dem Schemanamen. Ein Eintrag für Unbenanntes Feld | Typ angezeigt. Konfigurieren Sie anschließend die Eigenschaften Ihres Felds mithilfe des Feldeigenschaften Bedienfeld. 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 anschließend den Typ auf object
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
Auswählen Tätigkeiten aus der Liste der Marketo Datensätze und wählen Sie dann Nächste.
Datenflussdetails
Als Nächstes Informationen für Ihren Datenfluss bereitstellen, einschließlich der Namen und Beschreibungen für Ihren Datensatz und Ihren Datenfluss, des von Ihnen verwendeten Schemas und der Konfigurationen für Profile Erfassung, Fehlerdiagnose und partielle Erfassung.
Zuordnung
Zuordnungen für Standard-Aktivitätsfelder werden automatisch ausgefüllt, benutzerdefinierte Aktivitätsfelder müssen jedoch manuell den entsprechenden Zielfeldern zugeordnet werden.
Um mit der Zuordnung Ihrer benutzerdefinierten Aktivitätsfelder zu beginnen, wählen Sie Neuer Feldtyp und wählen Sie Neues Feld hinzufügen.
Navigieren Sie durch die Quelldatenstruktur und suchen Sie das benutzerdefinierte Aktivitätsfeld, das Sie erfassen möchten. Wählen Sie zum Abschluss Auswählen.
Um ein Zielfeld hinzuzufügen, wählen Sie das Schemensymbol aus und wählen Sie dann die benutzerdefinierten Aktivitätsfelder aus dem Zielschema aus.
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 unter Aktualisieren von Datenflüssen in der Benutzeroberfläche.
Verwendung Query Service Filtern von Aktivitäten für benutzerdefinierte Aktivitäten query-service-filter
Sobald Ihr Datenfluss abgeschlossen ist, können Sie Query Service , um Aktivitäten nach Ihren benutzerdefinierten Aktivitätsdaten zu filtern.
Wenn benutzerdefinierte Aktivitäten in Platform erfasst werden, wird der API-Name der benutzerdefinierten Aktivität automatisch zu eventType
. Verwendung 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 zum Filtern mehrerer benutzerdefinierter Aktivitäten:
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 , das nach benutzerdefinierten Aktivitätsdaten filtert.
Nächste Schritte
In diesem Tutorial haben Sie ein Platform-Schema für Marketo benutzerdefinierte Aktivitätsdaten und einen Datenfluss erstellt, um diese Daten an Platform zu übertragen. Allgemeine Informationen über Marketo -Quelle, lesen Sie die Marketo Quellübersicht.