Connector for Salesforce Marketing configuration properties
Implementing the Tridion Connector for Salesforce Marketing requires a JSON configuration file, which defines your specific integration of Tridion with Salesforce Marketing Cloud (SFMC).
File structure
- SalesforceConnector — defines the connector for Content Manager environment, including all user interfaces
- SalesforceDeployConnector — defines the connector for all Content Delivery
Both connector deployments are defined in the file as sections at the connector level and both sections require the same general settings for connecting to Salesforce Marketing Cloud. Additional settings are specific to the Content Delivery connector deployment. The Content Manager deployment doesn't require additional settings.
General settings
The following settings must be included in both the SalesforceConnector and SalesforceDeployConnector sections:
- clientId
- API username to be used to authenticate over OAuth.
- clientSecret
- API password to be used to authenticate over OAuth.
- hostUrl
- The host URL used to authenticate and for endpoints, such as the authenticate URL from the package created in SFMC platform.
- accountId
- The SFMC Account ID.
Settings for Content Delivery only
The SalesforeDeployerConnector section also includes the following settings to configure Content Delivery functionality:
- localeMapping
- A section that defines the mapping of Tridion Sites Publication IDs to SFMC locales.
- MarkupUploadCategoryId
- ID of Salesforce Content Builder Folder where HTML snippets will be uploaded. You can obtain this ID using a Postman call or using the inspect feature of your browser on that element.
- ImagesUploadCategoryId
- ID of Salesforce Content Builder Folder where binary assets will be uploaded. You can obtain this ID using a Postman call or using the inspect feature of your browser on that element.
The following sample code illustrates the configuration file of a Connector for Salesforce Marketing:
{
"configuration": {
"SalesforceConnector": {
"configuration": {
"ClientId": "123abc-123abc-123abc",
"ClientSecret": "aFakeClientSecret_secret123",
"HostUrl": "https://samplestring-4-4.auth.marketingcloudapis.com",
"AccountId": 123456789
}
},
"SalesforceDeployerConnector": {
"configuration": {
"ClientId": "123abc-123abc-123abc",
"ClientSecret": "aFakeClientSecret_secret123",
"HostUrl": "https://samplestring-4.auth.marketingcloudapis.com",
"AccountId": 123456789,
"localeMapping": [
{
"publicationIds": [ "4" ],
"locale": "source"
},
{
"publicationIds": [ "1009" ],
"locale": "fr-FR"
}
],
"MarkupUploadCategoryId": 26885,
"ImagesUploadCategoryId": 26885
}
}
},
"sitesCm": {
"isEnabled": true,
"SalesforceConnector": {
"namespaces": {
"saleforceconnector": {
"displayName": "Salesforce Marketing Cloud",
"stubFolders": [ "tcm:2-70-2" ]
}
}
}
},
"staging": {
"isEnabled": true,
"SalesforceConnector": {
"namespaces": {
"saleforceconnector": {}
}
},
"SalesforceDeployerConnector": {
"namespaces": {
"salesforcedeployer": {}
}
}
}
}