Skip to main content
Skip table of contents

Email service provider: Salesforce Marketing Cloud (SFMC)

Account configuration

Provisioning an SFMC Core Account

  1. Request a core account with:

    1. "Sender Authentication Package" (SAP)

    2. "Automated Interaction Management" (AIM)

    3. FTP user and password

  2. Request disabling of the default headers and footers for the account.

  3. Request enabling of "Extract Tracking".

  4. Request enabling of "Secure Link Wrapping".

  5. Confirm that the back-end Business Rule called "Enhanced Sender Profiles" is enabled.

  6. Set the Core Account password and provide to Operations for documenting in the Master Passwords spreadsheet.

Post-provisioning steps

  1. Set up an RPI user for channel configuration in Administration-> Users.

  1. Update Company Information in Settings -> Company Settings -> Account Settings. This defines the information that will be put into merge fields in RPI.

Configuring PGP encryption for events data extract

The following sections describe the steps required to configure PGP encryption for events data extract.

Creating a data extract activity

This section describes how to create a Data Extract Activity in SFMC automation studio, which is used to pull email campaign event data from within RPI. Please follow the steps below:

  1. Open a web browser and login to your SFMC account.

  2. In the Salesforce Marketing Cloud main page, hover over the Journey Builder menu and click Automation Studio.

  1. In the Automation Studio main page, click the Activities tab.

  1. To create a new Data Extract activity, click the Create Activity button located at the upper right corner of the Activities tab.

  1. Select Data Extract activity and click Next.

  1. In the Properties tab, provide values for the required text fields in the Data Extract activity.

    1. Name: descriptive name for the Data Extract activity.

    2. Description: additional information about the Data Extract activity.

    3. File Naming Pattern: a file name used when generating the exported email campaign event data. The file name has the following naming pattern:
      RPI_EVENT_EXTRACT_<Channel Name>.zip
      The <Channel Name> suffix should match the Salesforce Marketing Cloud channel name configured in RPI. If one or more spaces are present in the channel name, they should be replaced by an underscore character when providing the file name.

    4. Extract Type: set to Tracking Extract.

  2. Click Next. In Configuration tab, configure the following.

    1. Rolling Range: set to 30 Days.

    2. Keep other settings with their default values.

  3. Click Next.

  1. Finally, in the Summary tab, click Finish to create the Data Extract activity.

Copying the data extract activity ID

This section describes how to capture and copy the Data Extract Activity ID created in SFMC automation studio and used as a Tracking extract activity ID within the SFMC channel configuration settings in RPI. Please follow the steps below:

  1. Hover over and click the Data Extract activity created in the prior section within the Data Extract Activities list.

  1. In the address bar of a web browser, copy the Data Extract activity ID that can be found in the link as shown below:

Typically, the URL will have the following format:

https://mc.s11.exacttarget.com/cloud/#app/Automation%20Studio/AutomationStudioFuel3/%23ActivityModal /73/11bee2de-630e-41b0-a98f-355af9d5bda8

The underlined text is the assigned Data Extract activity ID.

  1. Paste the value into Tracking extract activity ID field in the RPI SFMC channel configuration settings.

Creating a file transfer activity

This section describes how to create a File Transfer Activity within SFMC automation studio, which is used to initiate the file move from the Safehouse. Please follow the steps below:

  1. Open a web browser and log into your SFMC account.

  2. In the Salesforce Marketing Cloud main page, hover over on Journey Builder menu and click Automation Studio.

  1. To create a new File Transfer activity, click Create Activity (located in the upper right corner of the Activities tab).

  1. Select File Transfer Activity and click Next.

  1. In the Properties tab, provide the required text field values for the File Transfer activity.

    1. Name: descriptive name of the File Transfer activity.

    2. Description: additional information about the File Transfer activity.

    3. External Key: uniquely identifiable key name used to run File Transfer activity via RPI. Note that spaces in the key name are not allowed.

    4. File Action: must always be set to Move a File From Safehouse.

  2. Click Next. In the Configuration tab, configure the following.

    1. File Naming Pattern: file name used when the exported file generated from a safe house to the destination SFTP folder. The file name has the following naming pattern: RPI_EVENT_EXTRACT_<Channel Name>.zip
      The <Channel Name> suffix should match the Salesforce Marketing Cloud channel name configured in RPI. If one or more spaces are present in the channel name, they should be replaced by a underscore characters when providing the file name.

    2. Destination: the SFTP export destination folder where the file is saved.

    3. Transfer Settings: set to Encrypt File and PGP.

    4. Customer Public Key: the customer’s PGP public encryption key.

  1. Click Next. In the Summary tab, click Finish to create the File Transfer Activity.

  1. The External Key in File Transfer activity will be used as the File transfer activity name in SFMC channel configuration in RPI.

Configuring PGP encryption for data extension extracts

These sections describe the steps required to configure PGP encryption for the data extracts used to create the data extension.

Creating file transfer activity

This section describes how to create the File Transfer Activity within SFMC automation studio, which will be used to decrypt the file after landing in the SFMC FTP Import folder. Please follow the steps below:

  1. Open a web browser and login to your SFMC account.

  2. In the Salesforce Marketing Cloud main page, hover over on Journey Builder menu and click Automation Studio.

  1. To create new File Transfer activity, click Create Activity located at the upper right corner of the Activities tab.

  1. Select File Transfer Activity and click Next.

  1. In the Properties tab, provide the required text field values for the File Transfer activity.

    1. Name: descriptive name of the File Transfer activity.

    2. Description: additional information about the File Transfer activity.

    3. External Key: uniquely identifiable key name used to run the File Transfer activity via RPI. Note that spaces in the key name are not allowed.

    4. File Action: must always be set to Manage File.

  2. Click Next. In the Configuration tab, configure the following:

    1. File Naming Pattern: this is used to find the PGP file created by RPI. It must have the following format:<external-key-name>_%%Year%%%%Month%%%%Day%%.txt.pgp

      1. For example, if the external key configured in step 13c is called “RPI_Test_FTA”, the file name convention would be:
        RPI_Test_FTA_%%Year%%%%Month%%%%Day%%.txt.pgp
        %%Year%% = wildcard for year the file was created
        %%Month%% = wildcard for month the file was created
        %%Day%% = wildcard for day the file was created

    2. Source File Location: leave as ExactTarget Enhanced FTP.

    3. File Management Actions: enable the Decrypt file option.

    4. Customer Public Key: customer’s PGP public encryption key.

  1. Click Next. In the Summary tab, click Finish to create the File Transfer Activity.

  1. The External Key in File Transfer activity will be used as the File transfer activity name in the SFMC channel configuration in RPI as shown below:

Enabling OAuth authentication for SFMC

  1. Open a web browser and log into your SFMC account.

  2. In the Settings menu, click Setup.

  1. In the Setup tab, expand Apps under the Platform Tools group setting. Click Installed Packages.

  1. Click the “New” button to create a new OAuth package.

  1. Provide the name and description of the new OAuth package. Click “Save” button.

  1. Below is an example of the Details Summary for a newly created OAuth package.

  1. Modify the default scope of the OAuth package by clicking the “Edit” button.

  1. In the Edit dialog, select the appropriate API permissions for the OAuth package. Click the “Save” button:

  1. Below are the default OAuth scopes required by RPI:

  1. Within the configuration of the SFMC Email and Data Transfer channels, enable “Use OAuth authentication” and enter the Client Id and Client secret values, as shown on the Details Summary page in the SFMC portal.

Additional resources

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.