Skip to content
Last updated

Salesforce Marketing Cloud Output Data Streaming

Salesforce Marketing Cloud (SFMC) is a digital marketing platform that automates marketing across email, social media, mobile apps, SMS, websites, and more.

With this integration you can send transactional emails messages with real-time trigger activations

This feature is in BETA version. For more information, contact your Customer Success Representative.

Prerequisites

  • Basic knowledge of Treasure Data
  • Basic knowledge of SFMC, including knowledge about Transactional Messaging features
  • Login credentials for your Salesforce Marketing Cloud account

API Information

Treasure Data uses the Transactional Message API to direct SFMC to send email messages. The documentation on the Request Body of this API can be very helpful in setting up email on SFMC.

Use Cases

The primary use case for this streaming integration is to incorporate it into a real-time activation workflow to:

  • Trigger an email delivery on SFMC
  • Trigger a pre-defined Customer Journey on SFMC

Here is an overview of how to configure that workflow to trigger an email delivery:

  1. On the SFMC website, configure the Transactional Messaging features necessary to send emails.
  2. On the SFMC website, create and install an Enhanced Functionality Package.
  3. Create an authentication for this integration to communicate with Salesforce Marketing Cloud.
  4. In a Real-time Journey, select this authentication for a new triggered activation.

To trigger a SFMC Customer Journey, the target journey must be predefined on the SFMC Journey Builder using the API Event as an entry event.

Requirements and Limitations

  • Currently, this connector does not support OAUTH authentication.
  • Currently, this connector does not support Transactional SMS messages.
  • You cannot use this connector to import data into Treasure Data
  • You cannot issue queries to Treasure Data using this connector.
  • The connector communicates with the SFMC v2 server/instance endpoint via HTTPS.
  • The HTTPS and SSL/TLS encryption are enforced by SFMC v2 servers and are checked by TD before processing.

Static IP Address of Treasure Data Integration

If your security policy requires IP whitelisting, you must add Treasure Data's IP addresses to your allowlist to ensure a successful connection.

Please find the complete list of static IP addresses, organized by region, at the following link:
https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/

Obtaining the SFMC Client ID and Client Secret

If you have not already done so, you will need to create and install an Enhanced Functionality Package in SFMC before you can retrieve your Client ID and Client Secret.

  1. Log in to your Salesforce Marketing Cloud account.
  2. On the Welcome Page, select your name in the top right corner and select Setup.

3. On the left side menu of new screen, navigate to App > Installed Packages.

4. On the Installed Packages screen, scroll down to the Components panel. 5. Take note of the Client Id,Client Secret, and Authentication Base URI. You use this information to create the authentication for the TD Console.

Use the TD Console to Create Your Connection

You must create and configure the data connection in Treasure Data. As part of the data connection, you provide authentication credentials to access the integration.

  1. Open the TD Console.
  2. Navigate to Integrations Hub > Catalog.
  3. Select the search icon on the far right of the Catalog screen, and type Salesforce Marketing Cloud Output Data Streaming.
  4. Hover over the Salesforce Marketing Cloud Output Data Streaming connector and select Create Authentication.

  1. Enter the required credentials.

  2. Select Continue.

  3. Enter a name for your connection.

  4. Select Done.

New Authentication Fields

ParameterDescription
Client IdThe Client ID of your Salesforce Marketing Cloud. See Obtaining SFMC Client ID and Client Secret.
Client SecretThe Client Secret of your Salesforce Marketing Cloud. See Obtaining SFMC Client ID and Client Secret.
Authentication Base URIThe URI where the authentication will be performed. See Obtaining SFMC Client ID and Client Secret.
Account Identifier or MIDMarketing Cloud Member ID. See How to Find Your Marketing Cloud Member ID (MID).

After configuring the Salesforce Marketing Cloud Output Data Streaming integration, it is now available to be incorporated into real-time customer journey activations. See Creating a Real-time Triggered Activation for additional information.