Auf dieser Seite Konfigurieren und verwenden Sie die benutzerdefinierte Aktion von Marketo Engage, damit Sie Personen- und benutzerdefinierte Objektdaten aus Ihren Journey mit Marketo Engage synchronisieren können.
Begeben Sie sich auf eine Reise der nahtlosen Datenintegration mit Marketo Engage. In den Journeys ist eine spezifische benutzerdefinierte Aktion zum Integrieren von Adobe Journey Optimizer und Marketo Engage verfügbar. Diese benutzerdefinierte Aktion unterstützt die Aufnahme von zwei wesentlichen Datentypen:
- Personen (Profile): Marketo wandelt Profile in verwertbare Erkenntnisse um.
- Benutzerdefinierte Objekte: Daten werden mit benutzerdefinierten Objekten (z. B. Produkten) für einen personalisierten Marketing-Ansatz angepasst.
Voraussetzungen prerequisites
Für diese Integration gelten die folgenden Voraussetzungen:
- Die Kundeninstanz von Marketo Engage muss IMS-fähig sein
- Die Marketo Engage-Instanz und die Adobe Experience Platform/Journey Optimizer-Instanz müssen sich in derselben Organisation befinden
- Der Kundin bzw. dem Kunden muss Zugriff auf den MktoSync: Ingestion Service bereitgestellt werden
Konfigurieren der Aktion configure-marketo-action
In Journey Optimizer muss eine benutzerdefinierte Aktion für Marketo Engage konfiguriert werden. Führen Sie folgende Schritte aus:
-
Wählen SIe Konfigurationen im Menüabschnitt ADMINISTRATION aus.
-
Klicken Sie im Abschnitt Aktionen auf Aktion erstellen. Der Bereich für die Aktionskonfiguration wird auf der rechten Seite des Bildschirms geöffnet.
-
Geben Sie Namen und Beschreibung ein und wählen Sie Adobe Marketo Engage als Aktionstyp
-
Klicken Sie für die Payloads Anfrage und Antwort auf Payload bearbeiten.
-
Erstellen Sie Ihre Payload für beide und fügen Sie sie in das entsprechende Popup ein.
-
Überprüfen und Konfigurieren von Payload-Werten
Hinweis: Um Werte dynamisch zu übergeben, ändern Sie für jedes Feld Konstante in Variable.
-
Klicken Sie im Bildschirm „Feldkonfiguration“ auf Speichern und speichern Sie dann die benutzerdefinierte Aktion.
Die benutzerdefinierte Aktion kann jetzt auf der eigenen Journey-Arbeitsfläche verwendet werden.
Payload-Syntax payload-syntax
Person
CustomObject
Payload-Beispiel für Person
{
"munchkinID": "388-KKG-245",
"person": {
"priority": "normal",
"partitionName": "XYZ",
"dedupeFields": {
"field1": "email",
"field2": "firstName"
},
"objects": [
{
"email": "Email address",
"firstName": "First name",
"lastName": "Last name"
}
]
}
}
Payload-Beispiel für benutzerdefiniertes Objekt
{
"munchkinID": "388-KKG-245",
"customObject": {
"priority": "normal",
"objectName": "products",
"objects": [
{
"email": "Email Address",
"productName": "Product Name",
"productQty": "Product Quantity",
"priceTotal": "Price Total"
}
]
}
}
Verwenden der Aktion engage-using
Für jede konfigurierte Aktion ist eine Marketo Engage-Aktionsaktivität in der Journey-Designer-Palette verfügbar.
Gehen Sie wie folgt vor, um diese zu verwenden:
-
Ziehen Sie die benutzerdefinierte Aktion auf die Journey-Arbeitsfläche.
-
Geben Sie Label und Beschreibung dieser Aktion ein.
-
Klicken Sie im Abschnitt Anfrageparameter für jeden Parameter auf das Symbol Bearbeiten und wählen Sie die dynamischen Werte aus, die in der Payload konfiguriert wurden.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to configure and use the Marketo Engage custom action so you can sync person and custom object data from your journeys into Marketo Engage.
Intents:
- Understand which data types the Marketo Engage custom action supports
- Verify the prerequisites required for the integration
- Configure a Marketo Engage custom action from the Configurations administration menu
- Compose the Request and Response payloads and pass values dynamically
- Use the Marketo Engage action activity on the journey canvas
Glossary:
- Marketo Engage custom action: A specific custom action available in your journeys to integrate Adobe Journey Optimizer and Marketo Engage (product-specific)
- Persons (Profiles): One of the two supported data types; Marketo transforms profiles into actionable insights (product-specific)
- Custom Objects: One of the two supported data types, such as products, used for a personalized marketing approach (product-specific)
- munchkinID: A field included in the Person and Custom Object payloads (product-specific)
- Constant / Variable: The setting changed per field so values can be passed dynamically in the payload (product-specific)
Guardrails:
- The customer instance of Marketo Engage must be IMS-enabled.
- The Marketo Engage instance and the Adobe Experience Platform/Journey Optimizer instance must be in the same organization.
- The customer must be provisioned with MktoSync: Ingestion Service access.
- This custom action supports the ingestion of two data types: Persons (Profiles) and Custom Objects.
- To pass values dynamically, each field must be changed from Constant to Variable.
Terminology:
- Canonical name: Adobe Marketo Engage — Acronym: n/a — variants: Marketo Engage, Marketo Engage action, Marketo Engage custom action
- Do not confuse: “Persons (Profiles)” ≠ “Custom Objects” (the two supported data types)
- Do not confuse: “Request” payload ≠ “Response” payload (both are edited when configuring the action)
FAQ:
- Q: What data can the Marketo Engage custom action sync? — It supports the ingestion of two data types: Persons (Profiles) and Custom Objects, such as products.
- Q: What are the prerequisites for this integration? — The Marketo Engage instance must be IMS-enabled, the Marketo Engage and Adobe Experience Platform/Journey Optimizer instances must be in the same organization, and the customer must be provisioned with MktoSync: Ingestion Service access.
- Q: Which action type do I select when configuring the custom action? — Select Adobe Marketo Engage as the Action type.
- Q: How do I pass values dynamically in the payload? — For each field, change Constant to Variable.
- Q: How do I use the action in a journey? — For each configured action a Marketo Engage action activity is available in the journey designer palette; drag it onto the canvas and, in the Request parameters section, select the dynamic values configured in the payload.