Syncing Salesforce Marketing Cloud to Justuno

This article will cover the integration of Salesforce Marketing Cloud with Justuno.

On this page

Introduction: Integration Benefits

Using Salesforce Marketing Cloud in a Workflow

Data Transacted

General Notes

Introduction

Salesforce Marketing Cloud is a customer relationship management (CRM) platform for marketers that allows them to create and manage marketing relationships and campaigns with customers. You'll be able to find new leads and turn them into customers. Salesforce Marketing Cloud is useful for marketing teams who need to keep track of all customer interactions in a single place. They also offer predictive analytics that can help you make marketing decisions. Justuno integration with Salesforce helps users collect information from a wider pool increasing their target audience.

If you have any questions about this integration, contact our support team via ticket or your Justuno Strategist via email for further direction or full set up.

Using Salesforce Marketing Cloud in a Workflow: Step-by-Step

1. You will need three things in order to connect Salesforce Marketing Cloud to Justuno. The client ID, client secret, and your Salesforce Marketing Cloud API subdomain.

Getting the Salesforce Marketing Cloud API subdomain

To integrate Salesforce Marketing Cloud with Justuno, users need get their Salesforce Marketing Cloud API subdomain. You can find your subdomain by following the steps here.

Example for acquiring the subdomain

If these are your endpoints for your Salesforce Marketing Cloud api,

REST API endpoint: mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com
SOAP API endpoint: mc563885gzs27c5t9-63k636ttgm.soap.marketingcloudapis.com

Then mc563885gzs27c5t9-63k636ttgm is your subdomain that should be entered into Justuno when connecting.

Getting the your Client ID and Client Secret

You'll need to create an installed packaged as described here.

Once that is complete, you'll need to "Add a component" under the installed package that is an "API Integration" where the integration type is "Server-to-server".

Below are the options that must be selected/checked during the setup for "Set Server-to-Server Properties"

Access:Offline Access

Email:Read, Write

SMS:Read, Write

Automations:Read, Write, Execute

Journeys:Read, Write, Execute, Activate/Stop/Pause/Resume/Send/Schedule

Audiences:Read, Write

List and Subscribers:Read, Write

Market Audience:Create, View, Update

Market Audience Member:Create, View, Update

Marketing Cloud Connect:Read, Write

Data Extensions:Read, Write

Subscriptions:Read, Create, Update

If you do not select the scopes properly, you will encounter issues with the integration.

Once the component is added, grab the the client ID and client secret. With the subdomain, you are now ready to connect the integration in Justuno's App Marketplace.

2. Setting up a Data Extension for collecting profile with additional properties from Justuno

In order to collect data beyond just the email, you'll have to set up a Data Extension in Marketing Cloud. We support adding/updating rows for both sendable and non-sendable data extensions.

Data extensions are used to collect additional information on the contact, i.e. custom properties like name, zip code, etc. It's important to set up your Data Extension properly BEFORE setting up anything in Justuno.

At a minimum, set up the following fields in the Data Extension to properly associate rows to your subscribers. More details on this are below.

A field for the Justuno Profile ID. The data type should be Text and this field should be a primary field. Data Extension rows created or updated will not work properly if this is not completed.

We use the upsert data extension row API endpoint in order to locate an existing row or create a new row based on the Justuno Profile ID as the primary key.

Additionally, the Justuno Profile ID field should be the field used for the Send Relationship that identifies subscribers by subscriber key. This Send Relationship setting is found during the creation of a Data Extension. This creates the relationship between a row in your Data Extension to the respective subscriber in your system. The reason behind this is that if you are adding email subscribers to lists with our integration, the Key to identify the Subscriber in SFMC will be the Justuno Profile ID.

3. Setting up a Data Extension for SMS Profiles

At a minimum, set up the following fields for properly collecting SMS Profiles in a Data Extension row.

A field to hold the phone, data type should be Phone.
A field for the Justuno Profile ID. The data type should be Text and this field MUST be a primary field. Data Extension rows created or updated will not work properly if this is not completed.
Add any other fields you wish to collect.

4. Setting up a Data Extension for Email Profiles

At minimum, setup the following fields for properly collecting Email Profiles in a Data Extension row.

A field to hold the email, data type should be EmailAddress
A field for the Justuno Profile ID. The data type should be Text and this field MUST be a primary field. Data Extension rows created or updated will not work properly if this is not completed.
You will also want to ensure the Nullable checkbox is checked for this email field.
Add another other fields you wish to collect.

You are now ready to start using Salesforce Marketing Cloud in your Workflow!

Data transacted

The customer data sent from Justuno to Salesforce Marketing Cloud contains:

User data, like your user first and last name, user phone number, email address and address
User subscription data, for example if or not they have chosen to receive marketing communication and which medium they have chosen for communication
Campaign data, such as the campaign name, conversion data, campaign engagement metrics, which includes impressions, time spent, bounce rate, and campaign analytics
User event data, which includes the type of the event, like sign up, abandon cart, unsubscribe and others, event timestamp, i.e. the time of the event, and event parameters, for example the purchase amount, any discounts or promotions applied, the device is use and others
Personalization data like user preferences, behavior data and segmentation data

Learn more from the experts about different zero & first party data to capture and use from our ebook.

You will need to map the Profile ID field you created in the data extension. Using the Sync Another Property button, you can select the Justuno Property for Profile ID, and then select the name you gave the profile ID within the data extension. This will ensure the data arrives in the records and not just in the list.

General Notes

Any subscriber collected in by a Justuno Workflow will have their subscriber key set to the Justuno Profile ID. This is important to note especially if you are using Data Extensions.
The integration supports adding an email subscriber to list, adding rows to data extensions or any combination of both. The clients could set up a workflow that only pushes to a data extension. Alternatively, a possible setup is just email subscriber to list. Or clients could set up a workflow that collects both. There is flexibility here.
We don't support Decimal Data Types at the moment for Data Extensions.