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.
2 - In the side menu, click on the option Installed Packages within Platform Tools> Apps.
3 - Now you can click on the New button to create your package.
4 - Write "indigitall" as the name of the package and click on the Save button.
5 - Click on the "Add Component" button to add a new component to your package.
6 - Select "API integration" and then "Server-to-Server".
7 - Set up the permissions.
Check the following permissions before finalizing:
The result should be something like this:
8 - Now add a new component of type "Marketing Cloud App".
Configure it with the following values:
Name: indigitall Login Endpoint: https://sfmc-connector.indigitall.com/integration Logout Endpoint: https://sfmc-connector.indigitall.com/logout |
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 |
- 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:
Select the first option. You will have to fill in the following information:
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).
If you place the mouse over the name of your account you will see the missing data: MID (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.
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.
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).
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
2 - If you don't have any group, you can create one doing click on "Create Attribute Group".
If you already have one created, access from the 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
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.
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.
Updated 9 months ago