Marketo: Import Audiences & Activity Data

Import leads and activity data from Marketo for use in Lytics audiences.

• Implementation Type: Server-side
• Implementation Technique: REST API and File Based Transfer
• Frequency: Batch daily or one time only.
• Resulting data: User profiles and User fields.

This integration utilizes Marketo's REST API to import user data. Once the import is started the job will:

1. Create a Lead Import Job via Marketo's /bulk/v1/leads/export/create.json endpoint.
2. If email and web activity are configured in the import, it will create separate jobs for each.
3. Check the status of the job(s) periodically via the /bulk/v1/leads/export/{exportId}/status.json endpoint.
4. When a job's status is returned as "Completed", retrieve the data via the /bulk/v1/leads/export/{exportId}/file.json endpoint and import the data into the appropriate stream.

The following fields are included in the default mapping of the mo_user stream:

The following fields are included in the default mapping of the mo_activity stream:

Follow these steps to set up an import leads and activities job for Marketo. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

1. Select Marketo from the list of providers.
2. Select the Import Audiences & Activity Data from the list.
3. Select the Authorization you would like to use or create a new one.
4. Enter a Label to identify this job you are creating in Lytics.
5. (Optional) Enter a Description for further context on your job.
6. (Optional) Toggle Show Advanced Options.
   1. Select Keep Updated to continuously import leads and activity from Marketo.
   2. Select the Activity Types to configure the acticity types to import.
   3. Select the Partition IDs to Import to configure Marketo partition IDs to import by adding them to the left column. If no partition IDs are selected, data from all partitions will be imported.
   4. Enter the Import Fields with Prefix to import all user fields that start with this value. NOTE: This will be in addition to all the default user fields and is a case-sensitive value.
   5. Enter the Maximum Number of Calls to make to Marketo per day. By default, accounts have 10,000 calls available per day so Lytics sets this at 9,500. For more information see Marketo Integration Best Practices.
7. Click Start Import.

Lytics uses the Marketo Bulk API, which allows an import of activity and leads data via large CSV files. However, Marketo restricts the amount of data Lytics can import daily. The default value of this limit is 500 MB per day.

For example, if your Marketo account generates a 700 MB file while importing leads and activities, the first 500 MB will be imported the first day and the remaining 200 MB will be imported when the daily limit resets on the following day.

If daily updates are critical for your use cases, spikes in activity volume may affect how timely Lytics can import data. In such scenarios, you can increase the daily limits for your Marketo account by contacting your Marketo customer success manager.

When data is imported from Marketo, it is queried with one of the fields:

• createdAt: Only new leads will be received. Leads with updated fields will be ignored.
• updatedAt: Each time the import runs it will receive leads based on the time they were updated.

NOTE: Importing based on updateAt is preferred so that any new changes are received. However, updatedAt is not available as a filtering field for all Marketo accounts. If createdAt is the only filter field available, this means that any updates made to existing leads will not be reflected in Lytics. See Marketo's documentation regarding Bulk Lead Extract Filters and contact their support to discuss gaining access to the updateAt filter.