id:60df6d4c038b872f10c54801

[Correlated](https://www.getcorrelated.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_new"} is the first product-led revenue platform built to help you and your sales teams take action based on how customers are using your product.

[Correlated](https://www.getcorrelated.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank"} is the first product-led revenue platform built to help you and your sales teams take action based on how customers are using your product.

This destination is maintained by Correlated. For any issues with the destination,[contact the CorrelatedSupport team](mailto:support@getcorrelated.com).

This destination is maintained by Correlated. For any issues with the destination,[contact the Correlatedsupport team](mailto:support@getcorrelated.com){:target="_blank"}.

1. Log in to the Correlated application.

2. Go to[Correlated integrations](https://app.getcorrelated.com/integrations){:target="_blank"} and select the Segment integration.

3. Click**Connect to Segment** to connect with OAuth.

4. Select the relevantSources that you want to include (Correlated recommends that you include your website and application)

4. Select the relevantsources that you want to include.Correlated recommends that you include your website and application.

1. From the Destinations catalog page in the Segment App, click**Add Destination**.

2. Search for "Correlated" in the Destinations Catalog, and select the "Correlated" destination.

3. Choose whichSource should send data to the "Correlated" destination.

3. Choose whichsource should send data to the "Correlated" destination.

4. Go to[Correlated integrations](https://app.getcorrelated.com/integrations){:target="_blank"} and click on the "Segment" integration.

5. Copy the "Segment API key".

6. Enter the"Segment APIKey" in the "Correlated" destination settings in Segment.

6. Enter the Segment APIkey in the "Correlated" destination settings in Segment.

Correlated supports the following methods.

analytics.track('Login Button Clicked')

Segment sends Track calls to Correlated as a`track` event. Track events should be flattened whenever possible. For example, rather than "Button Click" as a track event with "Onboarding Form Submit" as a property, use "Onboarding Form Submit Button Click".`Product Events` can be filtered and grouped by identify traits or group traits.

Segment sends Track calls to Correlated as a`track` event. Track events should be flattened whenever possible. For example, rather than "Button Click" as a track event with "Onboarding Form Submit" as a property, use "Onboarding Form Submit Button Click".`Product Events` can be filtered and grouped by identify traits or group traits.

strat:adobe

When you enable Marketo in the Segment web app, your changes appear in the Segment CDN in about 45 minutes, and then Analytics.js starts asynchronously loading Marketo's Munchkin onto your page. This means you should remove Marketo's snippet from your page.

+ Marketo starts automatically recording visitor information.

Our client-side and server-side destinations each require**different** credentials for authentication. Read through the information below on`identify` calls for further information.

For[`Page`](/docs/connections/spec/page/) or[`Track`](/docs/connections/spec/track/) methods, Segment uses[Marketo's Munchkin.js`visitWebPage` method](http://developers.marketo.com/javascript-api/lead-tracking/api-reference/#munchkin_visitwebpage){:target="_blank"}. The URL is built from the Segment event and properties object into the form Marketo expects, so no need to worry about doing that yourself.

For[Page](/docs/connections/spec/page/) or[Track](/docs/connections/spec/track/) methods, Segment uses[Marketo's Munchkin.js`visitWebPage` method](http://developers.marketo.com/javascript-api/lead-tracking/api-reference/#munchkin_visitwebpage){:target="_blank"}. The URL is built from the Segment event and properties object into the form Marketo expects, so no need to worry about doing that yourself.

To associate Track events to a particular Lead in Marketo from a server side library, youwillneed to pass the Munchkin.js cookie with your track calls.

To associate Track events to a particular Lead in Marketo from a server side library, you need to pass the Munchkin.js cookie with your track calls.

When you call[`identify`](/docs/connections/spec/identify/) on Analytics.js,we call Marketo's[`associateLead`](http://developers.marketo.com/documentation/websites/lead-tracking-munchkin-js/){:target="_blank"}. Marketo**requires an email address** for this function, so ifthe`traits` object you include in[`identify`](/docs/connections/spec/identify/) doesn't have an email, the request won't go through. Marketo's client-side library,[Munchkin](http://developers.marketo.com/documentation/websites/lead-tracking-munchkin-js/){:target="_blank"},**requires your API private key** for authentication along with your email, so make sure that you have provided it in your Segment settings.We will not change the casing of traits on client-side identify calls.

When you call[Identify](/docs/connections/spec/identify/) on Analytics.js,Segment calls Marketo's[`associateLead`](http://developers.marketo.com/documentation/websites/lead-tracking-munchkin-js/){:target="_blank"}. Marketo**requires an email address** for this function, so if the`traits` object you include in[Identify](/docs/connections/spec/identify/) doesn't have an email, the request won't go through. Marketo's client-side library,[Munchkin](http://developers.marketo.com/documentation/websites/lead-tracking-munchkin-js/){:target="_blank"},**requires your API private key** for authentication along with your email, so make sure that you have provided it in your Segment settings.Segment doesn't change the casing of traits on client-side identify calls.

analytics.identify('1234', {

});

In order to properly sign the`associateLead` request while keeping your account and data secure,we make a request to our API that calculates the appropriate SHA1 security hash for the user you're identifying.We use this hash to sign the`associateLead` request to Marketo.

In order to properly sign the`associateLead` request while keeping your account and data secure,Segment makes a request to our API that calculates the appropriate SHA1 security hash for the user you're identifying.This hash is used to sign the`associateLead` request to Marketo.

Note thatwe willautomaticallysend`userId` as a trait. Normally, the`userId` was sent as an`id` inside the traits but Marketo silently ignores that field as they use it for their own purposes. So if you create a custom field inside Marketo for`userId`, your leads will automatically have that field populated.

Note thatSegmentautomaticallysends`userId` as a trait. Normally, the`userId` was sent as an`id` inside the traits but Marketo silently ignores that field as they use it for their own purposes. So if you create a custom field inside Marketo for`userId`, your leads automatically have that field populated.

When youcan[`identify`](/docs/connections/spec/identify/) with a`traits` object on any of the server-side languages,we make a call to Marketo's`syncLead` SOAP API action. This call either creates or a updates`traits` on a lead based on the email address either in`userId` or`traits.email`.

When youcall[Identify](/docs/connections/spec/identify/) with a`traits` object on any of the server-side languages,Segment makes a call to Marketo's`syncLead` SOAP API action. This call either creates or a updates`traits` on a lead based on the email address either in`userId` or`traits.email`.

We will attemptto PascalCase server-side traits. So if you send`secondFavoriteColor` as a trait, we will convert thatto`SecondFavoriteColor`, so you should set the trait**API name** in Marketo to`SecondFavoriteColor`. If you send the trait as`second_favorite_color`, we will convert thatto`Second_favorite_color`, so you should set the API name to be`Second_favorite_color` (this is less than ideal; however, we plan to update this behavior in v2 of our Marketo destination, so stay tuned!).

Segment attemptsto PascalCase server-side traits. So if you send`secondFavoriteColor` as a trait it's convertedto`SecondFavoriteColor`, so you should set the trait**API name** in Marketo to`SecondFavoriteColor`. If you send the trait as`second_favorite_color` it's convertedto`Second_favorite_color`, so you should set the API name to be`Second_favorite_color`.

Note that leads can only be synced every 30 seconds using the SOAP API. If you exceed the allowed request amount,you will see`Exceeded lock attempts` errors in your debugger.

Note that leads can only be synced every 30 seconds using the SOAP API. If you exceed the allowed request amount,the`Exceeded lock attempts` errors appear in your debugger.

Our serverside destination with Marketo**requires your encryption key** along with your email for authentication, make sure you have provided it in your Segment settings.

The server-side destination with Marketo**requires your encryption key** along with your email for authentication, make sure you have provided it in your Segment settings.

Remember to provide an email with every call as either the`userId` or as a trait labeled "email". Here's ajava example of that:

Remember to provide an email with every call as either the`userId` or as a trait labeled "email". Here's aJava example of that:

Analytics.identify("hj2kf92ds212",

Marketo uses cookies to keep track of visitors and their sessions while visiting your website. The cookie data is stored in the visitor's browser, and is sent along to Marketo every time a new event occurs. This allows them to show a single unique lead between multiple page reloads.

Your servers also have access to this cookie, so they can re-use it when you send server-side events to Segment. If you don't use the existing cookie Segmentwill useeither the userId or sessionId to make the server-side request to Marketo. Whenwe createa new cookie, the client-side and server-side events from the same userwilllook like two distinct leads when viewed in Marketo. The cookieId takes precedence over all other keys, so if you send both the cookieId and the userId - the cookieId will matchfirst and the userId for that leadwill be updated.

Your servers also have access to this cookie, so they can re-use it when you send server-side events to Segment. If you don't use the existing cookie, Segmentuseseither the`userId` or`sessionId` to make the server-side request to Marketo. When a new cookie is created, the client-side and server-side events from the same user look like two distinct leads when viewed in Marketo. The`cookieId` takes precedence over all other keys, so if you send both the`cookieId` and the`userId` - the`cookieId` matchesfirst and the`userId` for that leadis updated.

To associate leads in server-side Marketo, there are currently three options with Segment:

1. Pass your Marketo cookies to Segment.

2. Use the userId or sessionId when associating leads in Marketo.

3. Ignore the additional visitors generated by passing different types ofids for each call(i.e.cookieId once, then the userId for the same user the second time).

2. Use the`userId` or`sessionId` when associating leads in Marketo.

3. Ignore the additional visitors generated by passing different types ofIDs for each call-`cookieId` once, then the`userId` for the same user the second time.

If you choose to pass the cookie with your calls, it will look like this:

If you want our server-side destination to use your user's Marketo Cookie, pass it tous in the`context['Marketo'].marketoCookie` object.

If you want our server-side destination to use your user's Marketo Cookie, pass it toSegment in the`context['Marketo'].marketoCookie` object.

Here's a Ruby example:

)

**Note:** If you choose to use the cookie approach, make sure to send the cookie along in your`track` calls as well, asMarketowill need it on subsequent calls to tie activity to that user.

**Note:** If you choose to use the cookie approach, make sure to send the cookie along in yourTrack calls as well.Marketoneeds it on subsequent calls to tie activity to that user.

A`track` call might look like this:

ATrack call might look like this:

Analytics.track(

)

For more information about syncronising your Marketo leads,[visittheir documentation](http://developers.marketo.com/documentation/soap/synclead/){:target="_blank"}.

For more information about syncronising your Marketo leads,[visitthe Marketo documentation](http://developers.marketo.com/documentation/soap/synclead/){:target="_blank"}.

To create a custom field in Marketo, follow Marketo's[documentation for creating a custom field](http://docs.marketo.com/display/public/DOCS/Create+a+Custom+Field+in+Marketo){:target="_blank"}. Be sure that the**API Name** is`PascalCase`'d, asour destinationwill account for Marketo's Pascal trait standards.

To create a custom field in Marketo, follow Marketo's[documentation for creating a custom field](http://docs.marketo.com/display/public/DOCS/Create+a+Custom+Field+in+Marketo){:target="_blank"}. Be sure that the**API Name** is`PascalCase`'d, asthe destinationaccounts for Marketo's Pascal trait standards.

For instance, if you configure`SomeTrait` in the**API Name** field (the**Name** value does not matter), you can pass in this field as`someTrait`, and we will convertthis to`SomeTrait` when sending into Marketo. Note that if you configured**API Name** to be`someTrait`, and passed it in as`someTrait` in your call, this would fail to send.

For instance, if you configure`SomeTrait` in the**API Name** field (the**Name** value does not matter), you can pass in this field as`someTrait`. Segment convertsthis to`SomeTrait` when sending into Marketo. Note that if you configured**API Name** to be`someTrait` and passed it in as`someTrait` in your call, this would fail to send.