Home Integrations Email Marketing Salesforce Marketing Cloud (ExactTarget) Integration

Table of Contents

Was this article helpful?

Yes No

Thank you for your feedback!

Salesforce Marketing Cloud (ExactTarget) Integration

In this article you'll learn:

  • Complete steps for setting up the Heap Salesforce Marketing Cloud integration
  • How to format data to send events and between Salesforce Marketing Cloud and Heap
This doc is for: Admins Architects

Overview

The Heap Salesforce Marketing Cloud integration automatically captures all of your email journey touchpoints as events in Heap. By integrating Salesforce Marketing Cloud with Heap, you’ll be able to answer the following questions:

  • How effective are different campaigns at driving conversions?
  • How many email touches does it take to re-active cart abandonment?
  • Does engagement in a journey improve retention over time?

Setup

Email Join Key Required

You need to have email addresses attached to your users in Heap to match data between Heap and this source. This property can be set to identity or any custom user property in Heap.

If you are not currently sending email addresses into Heap you will need to use Heap’s APIs to do so. Learn more about attaching email data to users via Heap’s identity API.

If you need help, please post in Heap Community or visit our Get support page.

To connect the SFDC MC source, you’ll need to create a new installed package in your Marketing Cloud Account, and add an API integration component to that package. To do this, you’ll need to perform the following steps in Marketing Cloud:

1. Log in to Marketing Cloud as a user with permission to administer installed packages.

2. Click on your username on the top right, and then Setup (under SETTINGS). If Setup is not available, you’ll need to login as a user with administration permissions.

3. On the Setup page, you’ll find Apps listed under Platform Tools. Click Apps > Installed Packages.

4. Click New and create a new package named Heap.

5. Click Add Component.

6. Choose API Integration.

7. Choose the Server-to-Server integration type.

8. Check off read permissions for:

  • CHANNELS > Email
  • AUTOMATION > Automations
  • CONTACTS > Audiences, List and Subscribers
  • DATA > Data Extensions, Tracking Events
  • HUB > Campaign

Click Save.

View Details of the Heap package by clicking on Heap under Apps > Installed Packages. From the API Integration component, you will need the following:

  • Your Marketing Cloud Subdomain: This is the 28-character string starting with the letters “mc” which forms the shared prefix of the path of the Authentication Base URI, REST Base URI and SOAP Base URI. For more information, see Salesforce’s documentation on Your Subdomain and Endpoints.
  • A Client Id and Client Secret

Now that you have your subdomain, Client ID, and Client Secret, back in Heap, navigate to Integrations > Directory > Salesforce Marketing Cloud, and click Set Up. Enter your information in the fields that appear and click Submit.

You may need to work with our support team to choose a join key. Reach out to support@heap.io with your app ID to get started.

During each Marketing Cloud backfill, we pull in all data where the initial email send was at most a month ago. Once we pull the past month’s “initial sends” then we pull all other events attached to that send.

Data Format

Salesforce Marketing Cloud events are ingested as the event types below in Heap. Please reference the linked Salesforce Marketing Cloud documentation for each event type to see what specific properties Heap ingests and their respective descriptions.

  • Clicked Link: A subscriber clicked on a link within the message.
  • Opened: A message was opened by a subscriber.
  • Sent: A message was sent to a subscriber.