Connections for INFACore > Connections to source and target endpoints > Salesforce Marketing Cloud
  

Salesforce Marketing Cloud

Create a Salesforce Marketing Cloud connection to read from or write to Salesforce Marketing Cloud.

Feature snapshot

Operation
Support
Read
Yes
Write
Yes

Before you begin

Before you configure the connection properties, you'll need to get information from your Salesforce account.
The following video shows you how to get information from your Salesforce account:
https://infa.media/3wAF60F

Connection properties

The following table describes the Salesforce Marketing Cloud connection properties:
Property
Description
Connection Name
Name of the connection.
Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
Maximum length is 255 characters.
Salesforce Marketing Cloud Url
The URL that the agent uses to connect to the Salesforce Marketing Cloud WSDL.
The following URL is an example for OAuth 1.0 URL:
https://webservice.s7.exacttarget.com/etframework.wsdl
The following URL is an example for OAuth 2.0 URL:
https://<SUBDOMAIN>.soap.marketingcloudapis.com/etframework.wsdl
Username
Applies to basic authentication. The user name of the Salesforce Marketing Cloud account.
Password
Applies to basic authentication. The password for the Salesforce Marketing Cloud account.
Client ID
The client ID of Salesforce Marketing Cloud required to generate a valid access token.
Client Secret
The client secret of Salesforce Marketing Cloud required to generate a valid access token.
Use Proxy Server
Connects to Salesforce Marketing Cloud though proxy.
Enable Logging
Enables logging for the task.
When you enable logging, you can view the session log for the log details.
UTC offset
Uses the UTC offset connection property to read data from and write data to Salesforce Marketing Cloud in the UTC offset time zone.
Batch Size
Number of rows that the agent writes in a batch to the target.
When you insert or update data and specify the contact key, the data associated with the specified contact ID is inserted or updated in a batch to Salesforce Marketing Cloud. When you upsert data to Salesforce Marketing Cloud, do not specify the contact key.
Enable Multiple BU
Uses the Salesforce Marketing Cloud connection to access data across all business units.
Select this option if there are multiple business units in your Salesforce Marketing Cloud account.

Read properties

The following table describes the advanced source properties that you can configure in the Python code to read from Salesforce Marketing Cloud:
Property
Description
Batch Size
Minimum number of rows that the Secure Agent reads in a batch. Enter a number greater than 0.
Default is 0.
Read Parameter File
Not applicable.
Tracing Level
Determines the amount of detail that appears in the log file.
Select one of the following options:
  • - Terse
  • - Normal
  • - Verbose Initialization
  • - Verbose Data
Default is Normal.
Note: Tracing level is not applicable for INFACore.

Write properties

The following table describes the advanced target properties that you can configure in the Python code to write to Salesforce Marketing Cloud:
Property
Description
Batch Size
Minimum number of rows that the Secure Agent writes in a batch. Enter a number greater than 0.
Default is 0.
Success File Directory
Directory for the success rows file. You must specify a directory path that is available on each Secure Agent machine in the runtime environment to save the success rows file. Ensure that your administrator has granted you access to this directory.
If you do not specify a directory, the success rows file is not created.
Error File Directory
Directory for the error rows file. By default, the error rows file is written to the following Secure Agent directory:
<Secure Agent installation directory>/apps/Data_Integration_Server/data/error
Specify a directory path that is available on each Secure Agent machine in the runtime environment. Ensure that your administrator has granted you access to this directory.