Salesforce Marketing Cloud

📘

API

What do you need for integration?

  • Create Salesforce Marketing Cloud Account
  • Create an account of indigitall
  • Create a project in your indigitall account

You will need the App Key of the project, which is the key that our system uses to identify it, so it is unique for each project. You can find it in the administration console within the Configuration section in the Projects tab. You can see it in the following image, and to copy it, it is easy to click on the icon next to the key (App Key)

Adding a new package

Create a new package in your Marketing Cloud account to connect indigitall with Marketing Cloud as follows:

1 - Go to the Setup section, you can see it by placing the mouse over the name of your user.

Setup section

2 - In the side menu, click on the option Installed Packages within Platform Tools> Apps.

Installed Packages

3 - Now you can click on the New button to create your package.

New Button

4 - Write "indigitall" as the name of the package and click on the Save button.

Package Details

5 - Click on the "Add Component" button to add a new component to your package.

Add Component

6 - Select "API integration" and then "Server-to-Server".

7 - Set up the permissions.
Check the following permissions before finalizing:

Permissions

The result should be something like this:

Result

8 - Now add a new component of type "Marketing Cloud App".
Configure it with the following values:

Marketing Cloud App

9 - Finally, add the Journey Builder Activity of the services you are going to use from indigitall.

  • For the Push service:
Name: Push indigitall
Category: Messages
Endpoint URL: https://sfmc-connector.indigitall.com/push

Journey Builder

  • For the Chat service:
Name: Chat indigitall
Category: Messages
Endpoint URL: https://sfmc-connector.indigitall.com/chat
  • For the SMS service:
Name: SMS indigitall
Category: Messages
Endpoint URL: https://sfmc-connector.indigitall.com/sms

Integration with indigitall

Now you will have to perform the integration with indigitall. For this, go to the indigitall console and login.

Inside, go to the "Settings" and, in the "Integrations" tab, press the "New" button. You will see the following screen:

Setting

Select the first option. You will have to fill in the following information:

Salesforce integration

Within the package that we have created in Salesforce Marketing Cloud you can see several of this data. From here you can collect the following: Client Id, Client Secret and Authentication Base URI (Salesforce URL).

Data

If you place the mouse over the name of your account you will see the missing data: MID (Salesforce Account Id).

Salesforce Account Id

With all this you can generate a "Server Key" of indigitall. Which will allow Salesforce Marketing Cloud to communicate with our services. Copy the generated key.

Integrations

Returning to your Marketing Cloud account, you will now have a new option in the AppExchange menu (if not, reload the page) called "indigitall". Click on this to finish configuring the indigitall connector.

AppExchange

In this new screen you will see a form with two fields:

  • ServerKey: Here you must include the ServerKey generated in indigitall and that you had copied.
  • Data extensions: This field is optional and serves to speed up the search for information for the service. If you are clear about the Data Extension that you are going to use as a data source, indicate them here (you can add as many as you want).

Server Key

Once you click on the "Integrate" button you will have completed the configuration.

Link contacIds with externalIds

1 - Access "Contact Builder" from "Audience Builder" on the SalesForce main screen

Contact Builder

2 - If you don't have any group, you can create one doing click on "Create Attribute Group".

Create Attribute Group

If you already have one created, access from the radial menu.

Radial menu

3 - within the group use the button to link your Data Extension with the "Indigitall Conversation" Data Extension through the Contact_Id attribute

If you don't have any data extension created, create one with the contact_id and device_id attributes

Data Extensions

If you already have it, you can link the contact_id attribute of your Customer Data with the same one of the dataextension where you have the contacts.

Customer Data

Statistics

  • ConversationId: It´s an unique identifier of each record in the Data Extension
  • Action: It has two values
  • New: It means that a new push is sent
  • Click: It means that someone clicks push
  • ContactKey: SFMC's own identifier to which each record in one Data Extension relates to another.
  • UniqueCampaignLabel: ID of the campaign sent from a journey and it´s configured within the custom activity of indigitall. It must be unique and unrepeatable.
  • ButtonClicked: The button that the user has pressed on the push. For all Click registration, there are 3 values:
    • 0: The click has been made on the body or image of the push.
    • 1: The click has been made on the first button (optional).
    • 2: The click has been made on the second button (optional).
  • ActionDate: The date and time of sending for all New records and the date and time of pulsing for all Click records. The time relates to UTC format.
  • DeviceId: The unique identifier of each device within indigitall in UUIDv4 format.
  • LatestRecord: It takes 2 values (true or false). Currently it does not provide greater information since it was added in previous versions when 2 immediate clicks were registered by mistake in the same push by the client. Duplicates were identified as true.