Send query results to Adobe Marketo

Adobe Marketo is marketing automation software that streamlines, automates, and measures marketing tasks and workflows.

Note

Amperity uses the Adobe Marketo API to update the membership of audience lists in Adobe Marketo to match the membership of audience lists that are sent from Amperity. The membership of the list in Adobe Marketo will be updated to match the membership of the audience list that is sent from Amperity. Amperity will add a user when they do not exist in Adobe Marketo.

Amperity does not maintain smart lists and does not remove users from the Adobe Marketo database.

This topic describes the steps that are required to send static audience lists to Adobe Marketo from Amperity:

1. Build a query

2. Add orchestration

3. Run orchestration

Note

Adobe Marketo must be enabled before you can configure an orchestration to send query results. Ask your DataGrid Operator or Amperity representative to enable Adobe Marketo for your tenant.

Build query

You will need to build a query that outputs fields that can be mapped to audience fields in Adobe Marketo. For example, a Adobe Marketo audience may have the following fields:

Amperity column	Marketo field	Description
email	email	Required.
given_name	firstname	Optional.
surname	lastname	Optional.
phone	phone	Optional.
company	company	Optional.

Example

Build a query named “Marketo - Audience List and Attributes” builds an audience list that includes email address, first name, last name, phone, and company:

SELECT
  email AS email
  ,given_name AS firstname
  ,surname AS lastname
  ,phone AS phone
  ,company AS company
FROM Merged_Customers

Add orchestration

An orchestration defines the relationship between query results and a destination, including the location to which those query results will be sent and the frequency at which the orchestration will be run.

Important

Specify the list and folder names as they are defined in Adobe Marketo. This is the list, and then folder names, to which Amperity will send audience list updates.

To add an orchestration

1. From the Destinations tab, click Add Orchestration. This opens the Add Orchestration dialog box.

2. From the Object Type drop-down, select Query.

3. From the Object drop-down, select the query for which results will be sent to Adobe Marketo.

4. From the Destination drop-down, select a destination that is configured for sending data to Adobe Marketo.

5. From the Data Template drop-down, select a data template.

6. Verify all settings.

7. Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)

8. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

To run the orchestration

1. From the Destinations tab, under Orchestrations, open the    menu for the Adobe Marketo orchestration, and then select Run.

2. The Status column for the orchestration will update to say “Waiting to start…”, after which the notifications pane will update to include a notification that shows the current status.

3. When the orchestration has run successfully, the status is updated to “Completed”.