> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SFMC Journey Builder

## Overview

Salesforce Marketing Cloud (SFMC) Journey Builder offers visibility into consumer interactions across various marketing channels, including email, mobile, social ads and more. By connecting these actions or conversations, you gain a deeper understanding of your customers, improve message building, design and automate campaigns, deliver a seamless customer experience, and secure customer loyalty.

Integrating with Zeotap enhances these capabilities by enabling marketers to base campaigns on real-time data sent from Zeotap.

## Supported Identifiers/Attributes

This integration allows you to send any identifiers of your choice and custom attributes.

## Prerequisites

Ensure that you have addressed the following prerequisites before starting the integration:

* You must create a data extension table in SFMC Journey Builder with the relevant fields. You can use this data extension as an entry source in Salesforce Marketing Cloud Journey Builder. Note that you have Admin access to SFMC Journey Builder. For more information about how to create a data extension table, refer [here](/articles/integrate-customer/appendix-for-sfmc-journey-builder#create-a-data-extension-table).
* You must create package in SFMC Journey Builder and provide certain API permissions. For more information about how to create a package, refer [here](/articles/integrate-customer/appendix-for-sfmc-journey-builder#create-a-package).
* Obtain the event definition key associated with the journey created in Journey Builder to which you need to push data from Zeotap CDP.
* Ensure that you validate and save the journey in Journey Builder before testing it. Validation confirms that all elements of the journey design are complete and ready for testing. Note that Journey Testing is unavailable for Single Send journeys.

## Components of Salesforce Marketing Cloud - Journey Builder

Ensure that you have the details about the below components of Salesforce Marketing Cloud account before starting this integration.

<CardGroup>
  <Card title="Client ID" href="/articles/integrate-customer/sfmc-journey-builder#client-id-client-secret-and-sfmc-subdomain" icon="id-badge" horizontal />

  <Card title="Client Secret" href="/articles/integrate-customer/sfmc-journey-builder#client-id-client-secret-and-sfmc-subdomain" icon="lock" horizontal />

  <Card title="Account ID" href="/articles/integrate-customer/sfmc-journey-builder#account-id" icon="building" horizontal />

  <Card title="Sub Domain" href="/articles/integrate-customer/sfmc-journey-builder#client-id-client-secret-and-sfmc-subdomain" icon="globe" horizontal />

  <Card title="Event Definition Key" href="/articles/integrate-customer/sfmc-journey-builder#event-definition-key" icon="bolt" horizontal />

  <Card title="Contact Key" href="/articles/integrate-customer/sfmc-journey-builder#contact-key" icon="user" horizontal />
</CardGroup>

### Client ID, Client Secret and SFMC Subdomain

Perform the following steps to obtain the Client ID, Client Secret and Domain details from your Salesforce Marketing Cloud account:

<Steps>
  <Step>
    Log into your SMFC account and navigate to **Journey Builder.**
  </Step>

  <Step>
    Under **Summary** of the installed package, you can find the following components that are essential for creating a Destination:

    a. **Client Id** - Marked as **1** in the below image <br /><br />
    b. **Client Secret** - Marked as **2** in the below image
  </Step>

  <Step>
    **Sub Domain** - Your subdomain is a 28-character string that starts with the letters “mc” in any of your base URIs. For example, in the base URI [https://mc6x3p75x6j07021qz11gk9xg8cq.rest.marketingcloudapis.com](https://mc6x3p75x6j07021qz11gk9xg8cq.rest.marketingcloudapis.com) the subdomain is . You can find it marked as **3** in the below image.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=d81fe0adf6026d8c5da62013497ae63a" alt="" width="2378" height="1276" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06.png" />
    </Frame>
  </Step>
</Steps>

### Account ID

This is the member ID (MID) of your Salesforce Marketing Cloud account. You can obtain this ID in the following two ways:

#### Option 1

<Steps>
  <Step>
    Log into SFMC.
  </Step>

  <Step>
    Hover over your account name in the top right corner.
  </Step>

  <Step>
    Copy the MID value. This is your `account_id`.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-1.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=dec652c63a86b67817300c7000f2b959" alt="" width="1914" height="736" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-1.png" />
    </Frame>
  </Step>
</Steps>

#### Option 2

<Steps>
  <Step>
    Log into SFMC and navigate to **Email Studio.**
  </Step>

  <Step>
    In the top navigation bar, click the **Admin** tab.
  </Step>

  <Step>
    Locate your **Account ID** under the **General Settings** section.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-2.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=04388f1391173c2cc6dabba4d0ba4677" alt="" width="2830" height="1040" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-2.png" />
    </Frame>
  </Step>
</Steps>

### Event Definition Key

This is a unique identifier assigned to a journey created in Journey Builder. This key helps determine which journey in Journey Builder to use when pushing data from Zeotap CDP. Perform the following steps to obtain the Event Definition Key:

<Steps>
  <Step>
    Log in to SFMC and navigate to **Journey Builder**.
  </Step>

  <Step>
    In the top panel, click **Events** > **Entry Source**.
  </Step>

  <Step>
    Select any listed entry source.
  </Step>

  <Step>
    Find the event definition key under the **Properties** tab as shown in the image below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-3.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=911af9b372ea9073429d10bab1f40a9b" alt="" width="601" height="514" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-3.png" />
    </Frame>
  </Step>
</Steps>

### Contact Key

This is a unique ID used to differentiate records in a data extension. This is typically the primary key of the data extension but is not always the case.

## Destination Setup

After you have applied filters or added conditions for your users in Journeys, you can activate them in SFMC Journey Builder under **Send to Destinations.** A new window appears, where you can set up your destination. You can use an already existing destination from the list of available Destinations or create a new one by clicking **+ Add New Destination**.

<Frame>
  <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-4.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=27df29265d56ffd1c6ad7bbd20bdc106" alt="" width="1858" height="1070" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-4.png" />
</Frame>

### Add New Destination

Perform the following steps to add a new destination:

<Steps>
  <Step>
    Click **Add New Destination.**
  </Step>

  <Step>
    Search for **SFMC Journey Builder.**
  </Step>

  <Step>
    Click **SFMC Journey Builder** and enter a name for the Destination.
  </Step>

  <Step>
    Enter the **Client ID, Client Secret, Sub Domain details** obtained from the Salesforce Marketing Cloud Summary Screen. [Learn more](https://zeotap.atlassian.net/wiki/spaces/DD/pages/edit-v2/4078501920#Components-of-Salesforce-Marketing-Cloud---Journey-Builder)
  </Step>

  <Step>
    Enter the **Account ID** associated with your SFMC Journey Builder account.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-5.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=26e3474a745e009e2eb7cd2419fccebf" alt="" width="3502" height="1736" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-5.png" />
    </Frame>
  </Step>

  <Step>
    In the mapping screen that appears, under **Choose your Action**, select **Stream Events to SFMC Journey Builder** as the action for sending data from the workflow created in Journeys. Under **Map the Fields**, use **+ Add Mapping Field** to add any number of identifiers and attributes you wish to send to SFMC Journey Builder.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-11.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=a082d10dd7b2c1fbda27f584507aecff" alt="" width="3528" height="1802" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-11.png" />
    </Frame>
  </Step>

  <Step>
    Once the mapping is complete, click **Create Destination**. The destination is created and made available for activation on Journeys.
  </Step>
</Steps>

## Activate the Destination on Journeys

After creating a destination, next, you need to link it in the **Send to Destination** node within the workflow, as explained below.

<Steps>
  <Step>
    In the workflow, click **+** and choose **Send to Destinations**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-7.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=103329e05d26ff64a946f8ff0c86c78b" alt="" width="1032" height="542" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-7.png" />
    </Frame>
  </Step>

  <Step>
    Choose the destination from the list of available destinations by using the search feature.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-8.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=859ecf9420374c29bc76ba209c13c77c" alt="" width="1896" height="1056" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-8.png" />
    </Frame>
  </Step>

  <Step>
    Under the **Destination Details** tab, the **Client ID, Client Secret, Sub Domain** and **Account ID** fields are automatically populated based on the value that you had entered while creating the destination. However, you need to enter the following values:

    a. **Event Definition Key,** which is a unique identifier assigned to a journey created in Journey Builder. This key helps determine which journey in Journey Builder to use when pushing data from Zeotap. For information about how to obtain this, refer [here](#event-definition-key). <br /><br />
    b. **Contact Key**, which is a unique ID used to differentiate records in a data extension. This is typically the primary key of the data extension but not always the case.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-13.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=2b0bd8bf975758b5ebc0b142dfa1eb4d" alt="" width="1918" height="1824" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-13.png" />
    </Frame>
  </Step>

  <Step>
    Under the **Destination Settings** tab, choose the Action and mapping as per your requirement.
  </Step>

  <Step>
    Upon clicking **Save Destination**. The destination is attached as shown in the image below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/4xl9wnXlFu0GG8Va/articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-10.png?fit=max&auto=format&n=4xl9wnXlFu0GG8Va&q=85&s=64c9a409d572ae07f7fdf96e1056320a" alt="" width="1878" height="1090" data-path="articles/integrate-customer/Storage/integrate-customer/sfmc-journey-builder/sfmc-journey-builder-2024-09-06-10.png" />
    </Frame>
  </Step>
</Steps>
