Erstellen Sie eine Marketo Engage Quellverbindung und Datenfluss für benutzerdefinierte Aktivitätsdaten in der Benutzeroberfläche

Letzte Aktualisierung: 2024-01-25
  • Themen:
  • Sources
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • Developer
HINWEIS

In diesem Tutorial werden spezifische Schritte zum Einrichten und Einführen von benutzerdefinierte Aktivität Daten aus Marketo auf Experience Platform. Schritte zum Standardaktivität -Daten, lesen Sie die Marketo UI-Handbuch.

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

Die Benutzeroberfläche "Benutzerdefinierte Aktivitäten"in der Adobe Marketo Engage-Benutzeroberfläche.

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.

Die Seite "Marketo Custom Activity Fields Details"in der Marketo Engage-Benutzeroberfläche.

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.

TIPP

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

Der Arbeitsbereich "Schemas"in der Experience Platform-Benutzeroberfläche mit dem ausgewählten Schema "B2B-Aktivität".

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

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.

Das Fenster zur Beschriftung und Erstellung einer neuen Feldergruppe.

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

Die Schemastruktur mit einer neuen Feldergruppe, die unter dem Feldergruppenbereich hinzugefügt wird.

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.

Die Schemastruktur mit dem Pluszeichen () ausgewählt, damit 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

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

Eine Gruppe von Unterfeldern, die einem Feld innerhalb des Schemas hinzugefügt werden.

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.

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

Daten auswählen

Auswählen Tätigkeiten aus der Liste der Marketo Datensätze und wählen Sie dann Nächste.

Der Schritt Daten auswählen im Ursprungs-Workflow mit dem ausgewählten Aktivitätendatensatz.

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.

Der Schritt zum Datenfluss-Detail .

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.

Der Zuordnungsschritt mit dem Dropdown-Menü, um ein neues Feld hinzuzufü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.

TIPP

Um Verwirrung zu vermeiden und doppelte Feldnamen zu verarbeiten, wird benutzerdefinierten Aktivitätsfeldern der API-Name vorangestellt.

Die Quelldatenstruktur.

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

Die Struktur des Zielschemas.

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.

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 Schritt zur Überprüfung, der Informationen zu den Feldern für Verbindung, Datensatz und Zuordnung zusammenfasst.

Hinzufügen benutzerdefinierter Aktivitäten zu einem vorhandenen Aktivitäten-Datenfluss

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

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.

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

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.

Auf dieser Seite