ÃÛ¶¹ÊÓƵ

Create a Marketo Engage source connection and dataflow for custom activity data in the UI

In addition to standard activities, you can also use the Marketo source to bring custom activities data to ÃÛ¶¹ÊÓƵ Experience Platform. This document provides steps on how to create a source connection and dataflow for custom activity data using the Marketo source in the UI.

Getting started

This tutorial requires a working understanding of the following components of ÃÛ¶¹ÊÓƵ Experience Platform:

Retrieve your custom activity details

The first step to bringing custom activity data from Marketo to Experience Platform is to retrieve the API name and the display name of your custom activity.

Login to your account using the interface. In the left navigation, under Database Management, select Marketo Custom Activities.

The interface updates to a display of your custom activities, including information on their respective display names and API names. You can also use the right-rail to select and view other custom activities from your account.

Select Fields from the top header to view the fields associated with your custom activity. In this page, you can view the names, API names, descriptions, and data types of the fields in your custom activity. Details regarding individual fields will be used in a later step, when creating a schema.

Set up field groups for custom activities in the B2B activities schema

In the Schemas dashboard of the Experience Platform UI, select Browse and then select B2B Activity from the list of schemas.

Create a new field group for custom activity

Next, add a new field group to the B2B Activity schema. This field group should correspond with the custom activity that you want to ingest and should use the custom activity’s display name that you retrieved earlier.

To add a new field group, select + Add beside the Field groups panel under Composition.

The Add field groups window appears. Select Create new field group and then provide the same display name for the custom activity that you retrieved in an earlier step and provide an optional description for your new field group. When finished, select Add field groups.

Once created, your new field group for custom activity appears in the Field groups catalog.

Add a new field to your schema structure

Next, add a new field to your schema. This new field must be set to type: object and will contain the individual fields of the custom activity.

To add a new field, select the plus sign (+) beside the schema name. An entry for Untitled Field | Type appears. Next, configure properties of your field using the Field properties panel. Set the field name to be your custom activity’s API name and set the display name to be your custom activity’s display name. Then, set the type as object and assign the field group to the custom activity field group that you created in the previous step. When finished, select Apply.

The new field appears in your schema.

Add sub-fields to the object field add-sub-fields-to-the-object-field

The last step in preparing your schema is to add individual fields inside the field that you created in the previous step.

Create a dataflow

With your schema setup complete, you can now proceed to create a dataflow for your custom activity data.

In the Platform UI, select Sources from the left navigation bar to access the Sources workspace. The Catalog screen displays a variety of sources with which you can create an account.

You can select the appropriate category from the catalog on the left-hand side of your screen. Alternatively, you can find the specific source you wish to work with using the search bar.

Under the ÃÛ¶¹ÊÓƵ applications category, select Marketo Engage. Then, select Add data to create a new Marketo dataflow.

Select data

Select Activities from the list of Marketo datasets and then select Next.

Dataflow detail

Next, provide information for your dataflow, including names and descriptions for your dataset and dataflow, the schema that you will be using, and configurations for Profile ingestion, error diagnostics, and partial ingestion.

Mapping

Mappings for standard activity fields are auto-populated, but custom activity fields must be mapped to their corresponding target fields manually.

To start mapping your custom activity fields, select New field type and then select Add new field.

Navigate through the source data structure and find the custom activity field that you want to ingest. When finished, select Select.

To add a target field, select the schema icon and then select the custom activity fields from the target schema.

Repeat the steps to add the rest of your custom activity mapping fields. When finished, select Next.

Review

The Review step appears, allowing you to review your new dataflow before it is created. Details are grouped within the following categories:

Once you have reviewed your dataflow, select Save & ingest and allow some time for the dataflow to be created.

Add custom activities to an existing activities dataflow add-to-existing-dataflows

To add custom activity data to an existing dataflow, modify the mappings of an existing activities dataflow with the custom activity data that you want to ingest. This allows you to ingest custom activity into the same existing activities dataset. For more information on how to update the mappings of an existing dataflow, read the guide on updating dataflows in the UI.

Use Query Service to filter activities for custom activities query-service-filter

Once your dataflow is complete, you can use Query Service to filter activities for your custom activity data.

When custom activities are ingested into Platform, the API name of the custom activity automatically becomes its eventType. Use eventType={API_NAME} to filter for custom activity data.

SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'

Use the IN clause to filter multiple custom activities:

SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')

The image below shows an example SQL statement in the Query Editor that filters for custom activity data.

Next steps

By following this tutorial, you have set up a Platform schema for Marketo custom activity data and created a dataflow to bring that data to Platform. For general information on the Marketo source, read the Marketo source overview.