Setting up Marketo User Audit Data Stream with Adobe I/O Events

These instructions describe how to set up and get started using Adobe I/O Events for Marketo user-driven change events. You can use Adobe I/O for streaming Marketo user-driven change events such as the modification of emails, campaigns, and landing pages.

Introduction

User Audit Data Stream provides all the user-driven change events that are shown in the MLM Audit Trail as an event stream to which you can subscribe.

data-src=marketo-data-streams-setting-up-ga-stream.md

Setup Adobe I/O

See Getting Started with Adobe I/O Events

For basic instructions for this use case, starting from console.adobe.io:

When prompted, click the designated button to proceed:

• Select Create new project

  

• Select Add event

  

• Filter by Experience Cloud

• Select Marketo User Audit Data Stream

  

• Subscribe to the user driven change events of your choosing

  

• Set up OAuth Server-to-Server Credentials

  

• Set up Event Registration

  

  • Provide a name and description for this event subscription

  • Optionally choose whether to enable Webhook or Runtime action

    • Enable Webhook

      • We recommend batch over single webhooks
      • For Webhook URL a public https endpoint must be provided
      • The endpoint must be able to handle get and post requests
      • The get request must respond with the challenge query if it exists
      • The post request must respond that it received the message or the webhook will re-attempt to send several times before giving up and automatically disabling the webhook sends

    • Enable Runtime action

      • See Setting up your Runtime Environment
      • Select a pre-made runtime action/runtime namespace

• After Saving

  

  • Verify that the Status is Active
  • If Webhook was selected, verify that it successfully passed the challenge without errors

data-src=marketo-data-streams-developer-guidelines.md

data-src=marketo-data-streams-multiple-instances.md

Event Data Structure

Events are structured in JSON format using the CloudEvents spec

Example Event (batch):

[
    {
        "eventid": "cf904f43-56bc-4f80-935d-a484de6e4181",
        "event": {
            "body": {
                "specversion": "1.0",
                "type": "com.adobe.platform.marketo.audit.user.email",
                "source": "urn:mlm",
                "time": "2024-07-11 13:20:42.755",
                "datacontenttype": "application/json",
                "dataschema": "V2.0",
                "data": {
                    "componentId": 232459,
                    "componentType": "Email",
                    "eventAction": "approve",
                    "munchkinId": "123-ABC-456",
                    "imsOrgId": "<your_ims_org_id>@AdobeOrg",
                    "userId": "user@marketo.com"
                }
            }
        },
        "recipientclientid": "<your_client_id>"
    },
    {
        "eventid": "e931c3ec-9d76-406b-ac89-626e9650813a",
        "event": {
            "body": {
                "specversion": "1.0",
                "type": "com.adobe.platform.marketo.audit.user.landingpage",
                "source": "urn:mlm",
                "time": "2024-07-11 13:20:42.755",
                "datacontenttype": "application/json",
                "dataschema": "V2.0",
                "data": {
                    "componentId": 123321,
                    "componentType": "Landing Page",
                    "eventAction": "approve",
                    "munchkinId": "123-ABC-456",
                    "imsOrgId": "<your_ims_org_id>@AdobeOrg",
                    "userId": "user@marketo.com"
                }
            }
        },
        "recipientclientid": "<your_client_id>"
    }
]

Example Event (single):

{
    "eventid": "a9ef9c3c-bafe-48b8-9eae-bc63dfaed28c",
    "event": {
        "body": {
            "specversion": "1.0",
            "type": "com.adobe.platform.marketo.audit.user.email",
            "source": "urn:mlm",
            "time": "2024-07-11 13:20:42.755",
            "datacontenttype": "application/json",
            "dataschema": "V2.0",
            "data": {
                "componentId": 232459,
                "componentType": "Email",
                "eventAction": "approve",
                "munchkinId": "123-ABC-456",
                "imsOrgId": "<your_ims_org_id>@AdobeOrg",
                "userId": "user@marketo.com"
            }
        },
        "recipientclientid": "<your_client_id>"
    }
}

Data Field Definitions

Many of the fields are common across the different types of events. The event.body.data object will contain the specific details of the event.

The data object contains the following fields:

Event List

Note - This is a snapshot listing of most available events. There may be some events that don't show up or no longer exist.

The following events are related to access control and security:

data-src=marketo-data-streams-debug.md