Documentation Center

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

To support multichannel delivery, this connector's configuration file defines two connector deployments:
  • 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.
Use the consumer secret of the connector application you defined when setting up OAuth.
clientSecret
API password to be used to authenticate over OAuth.
Use the consumer secret of the connector application you defined when setting up 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.

Each mapping is a pairing of the following two objects:

publicationIds
List of Publication IDs that map to the specified locale.
locale
Locale identifier for the translated and localized HTML snippets in SFMC.
Note:
  • One Publication must be marked as "source" to identify the original language of the form.
  • If no mapping is defined for a certain Publication ID:
    • In Content Manager, all forms will be shown.
    • In Content Delivery, no suffix will be added to SFMC snippets that are published.
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": {}
      }
    }
  }
}