SalesForce Marketing Cloud (Pull)

220px-Sf-marketingcloud-logo.png

This guide outlines the steps to integrate AB Tasty with Salesforce Marketing Cloud (SFMC) and pull audience data into AB Tasty from a designated Data Extension (DE) in SFMC.

 

Overview

Salesforce Marketing Cloud (SFMC) is a digital marketing platform that supports multichannel campaigns, including email, social media, and advertising. By integrating SFMC with AB Tasty you can leverage SFMC-created segments to personalise your website campaigns.

The SFMC Pull integration enables AB Tasty to retrieve audience data from a dedicated Data Extension in SFMC, allowing for targeted experiences on your website.

 

Integration

Definition and Process

The SFMC Pull integration establishes a connection between your SFMC Data Extension and AB Tasty, enabling AB Tasty to retrieve audience data for website personalisation. Below is an illustrative graph showing how the integration works.

Requirements

Visitor Identification

Since SFMC lacks native visitor identification for websites, visitors must be uniquely identified using one of the following methods:

2 Methods which imply a modification on your side by creating either a cookie or adding a key on your Local Storage

  1. Local Storage: Store the visitor ID under the SFMC_VISITOR_ID key.
  2. Cookie: Store the visitor ID under the SFMC_VISITOR_ID key.

A third method can be used and added within the Account JS of your AB Tasty Account 

AB Tasty Method: Use window.ABTasty.setSFMCVisitorID to assign the ID.

Data Extension Setup

The dedicated Data Extension (DE) should be created and made available to AB Tasty.
AB Tasty will retrieve data from this DE daily.


Below is the required structure for the DE:

Field Name Type Details
SubscriberKey String The subscriber key associated with one or more audiences (Primary Key).
Audience String The name of the audience linked to the subscriber key.
Value Optional The audience-specific value (if applicable).
Date String Current date in MM/DD/YYYY format (Primary Key).
is_include Boolean The default is TRUE. Set to FALSE if a visitor has been removed from an audience after being included earlier.

Example Records

ID SubscriberKey Audience Value Date is_include
1 idVisitorId1 audience 1 value 1 12/25/2024 TRUE
2 idVisitorId2 audience 1 value 2 12/25/2024 TRUE
3 idVisitorId2 audience 2   12/26/2024 TRUE
4 idVisitorId3 audience 3   12/26/2024 FALSE
5 idVisitorId2 audience 2   12/26/2024 FALSE

The records must be structured as follows: 

  • SubscriberKey, Audience and date must be inserted inside the keys field (of the data extension
  • Value and is_include must be included inside the values field (of the data extension)

Here is an example of the correct structure of a dedicated Data Extension for AB tasty
Capture d’écran 2025-03-17 à 13.10.22.png

 

How to Set Up the Integration

Step 1: Configure the Connector in AB Tasty

  1. Log in to your AB Tasty account.

  2. Go to Integrations > Integration Hub.

  3. Search for and select Salesforce Marketing Cloud (Pull section).
    Capture d’écran 2025-01-29 à 11.40.48.png
  4. Click Setup Connector and provide the following details:

    Connector Name: A unique name to identify the connector.
    Client ID: Your SFMC clientId.
    Client Secret: Your SFMC clientSecret.
    Account ID: Your SFMC account ID (sometimes called Merchant ID).
    Subdomain: Your SFMC subdomain.
    Data Extension ID: The ID of the Data Extension created in Step 1
    Visitor ID Location: The method used to store the SFMC_VISITOR_ID (e.g., Local Storage, Cookie, or AB Tasty Method).
  5. Create the connector

Step 2: Verify the Integration (usually at J+1)

  1. Ensure that your website includes the AB Tasty tag.
  2. Test the visitor identification process (e.g., through login or form submission).
  3. Based on your choice preference / Cookie - Local Storage - AB tasty method

    Verify that AB Tasty is retrieving audience data from the specified DE.

    Go to your website and enable debug mode by running the following command in the browser console:

document.cookie="abTastyDebug=true;path=/;";

Refresh your browser and act to become a registered visitor (like login or form submission).
If you fall in the right Audience criterion
you'll see a matching VisitorID capture_d___e__cran_2025-02-17_a___16.29.05_720-1.png

And a success linked to SFMC ( if the table appears empty, it's simply because our bridge retrieve audience one time per day)

capture_d___e__cran_2025-02-17_a___16.30.21_720-1.png

4. Then the Audience should be available from AB Tasty Segment builder
under External Data>SFMC
Capture d’écran 2025-02-17 à 17.57.41.png

Good to Know 💡

  • Mandatory Fields: All fields are required.
    The clientId, clientSecret, accountId, subDomain, and DataExtension ID fields are required to authenticate the integration and enable data push. SFMC_VISITOR_ID  will allow AB Tasty to identify your visitors during a campaign
  • Data Accuracy: Ensure your Data Extension includes up-to-date information for reliable audience targeting.
  • Known Visitors Only: The integration only applies to "known" visitors with a subscriber key 

 

Heads Up ⚡

  • Primary Keys: Do not modify the SubscriberKey or Date fields in the Data Extension, as they are critical for syncing data.
  • Customisations: You can filter or arrange the Data Extension data to suit your marketing needs, as long as the required structure is maintained.
  • The SubscriberKeys in the Data Extension must be identical to those you provide via the AB Tasty method (or Local Storage or Cookies) for proper matching. Otherwise, the integration will fail.

Following these steps, you’ll successfully integrate AB Tasty with SFMC, enabling personalised audience targeting on your website! 🎉

Was this article helpful?

/