Adobe Marketo Engage

Introduction

Didomi allows you to update your Marketo contact attributes with the preferences collected through your preference management platform (PMP).

Implementation

Connection

Didomi connects to Adobe Marketo Engage on your behalf through the following credentials:

  • Client ID: To get your client ID, navigate to your Marketo Engage Interface -> Admin -> Integration -> Launchpoint menu.

  • Client secret: To get your client ID, navigate to your Marketo Engage Interface -> Admin -> Integration -> Launchpoint menu.

  • Instance: Your instance is the Endpoint provided in Marketo Engage through Interface -> Integration -> Web services -> REST API

Options

  • Upsert mode: You can choose allowing Didomi to create leads in Marketo, by setting upsert_mode to true. Otherwise, when a consent is collected but the organization_user_id value does not match with any lead in Marketo, the consent update will not be propagated to Marketo.

  • Bidirectional flow: Please note that the bidirectional flow is not supported at the moment.

Mapping

Didomi uses the entity Person (Lead) of Marketo and sends the Lead attribute property when updating a lead. Hence consent events are mapped to Marketo's lead attributes.

PropertyDescriptionRequired

Upsert mode

By setting upsert_mode to true you allow Didomi to create leads in Marketo

No, Default value = false

Client ID

A client ID from your Marketo account

Yes

Client secret

A client secret from your Marketo account

Yes

Instance

Your Marketo REST api endpoint

Yes

User identifier

Identifier property for users. Options: email, leadID.

Yes

Mappings

Mapping for properties between Didomi and Marketo

Yes

Example

{
    "type_id": "marketo",
    "authentication": {
        "client_id": "your_client_id",
        "client_secret": "your_client_secret",
	"instance": "your_marketo_endpoint"
    },
    "properties": {
	"user_identifier": ["email"]
    },
    "mappings": [
        {
	    "id": "lead_attribute_api_name",
	    "value": "consents_purposes_newsletter_enabled"
	}
    ],
    "upsert_mode": true
}

The configuration of the Marketo integration can be done in the Didomi Console. First please reach out to support@didomi.io to get the integration's premium feature activated.

Last updated