App Integrations
      Back to home
      1. Knowledge Base
      2. App Integrations

      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.

      undefined

      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.
      1. 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.
      1. A field to hold the phone, data type should be Phone.
      2. 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.
      3. 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.
      1. A field to hold the email, data type should be EmailAddress
      2. 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.
      3. 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. 
       
      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.