Import Audience data from any 3rd-party solution (Custom pull)

Send & use your audience to AB Tasty from any sources

This feature is currently part of an Early Adopters program. Please contact your CSM to benefit from it.

Introduction

This guide outlines the steps to send your audience data to AB Tasty, making it available in the Segment Builder for use in your upcoming experiments (A/B tests, personalisations, patches).

Note: This feature is currently exclusive to Experience Optimisation Platform clients.

Overview

The Custom Pull Connector is a new method built on top of our Universal Data Collector (UDC). It allows you to import audiences from your preferred tools, making them easily accessible for segment creation within AB Tasty.

Integration Process

The process consists of three steps:

1

Create a Custom PULL Connector on APP2

The partner_name used when creating the connector must exactly match the partner_name used in the POST request to UDC (step2) This ensures proper matching between your imported data and the connector.

This step is made on the AB Tasty application

1. Access your AB Tasty Account > Integrations > Integrations Hub

2. On the pull section, locate the Custom Pull Card

   

   Custom Pull Card is highlighted when you don't have any
3. Create your custom pull connector:

• Connector Name This name will help you identify your audience source within the Segment Builder.

• Partner Name Used to identify the origin of your data. It must match the partner name when sending data to AB Tasty through UDC.

• Storage Location for Visitor_ID Select where the visitor ID is stored. Our connector will use this to retrieve the ID and match it in UDC:

  • Local Storage – The connector will look for a specific entry in the browser’s Local Storage.

  • Cookie – The connector will look for a specific cookie.

  • AB Tasty Method – Use window.abtasty.setVisitorId('id') to set the visitor ID manually.

  • BYOID – If Bring Your Own ID (BYOID) is implemented, the connector will use the configured method to retrieve the ID.

• Key Enter the name of the key to retrieve the visitor ID, based on the selected storage method above.

2

Send Data to UDC

This Step is made on your end & AB Tasty application

Retrieve your account API Key on AB Tasty

• Access your AB Tasty account > Integrations > API key

• Generate or copy the API key (will be used on the method for UDC)

On your end - Using the API key, send audience data to UDC Following the UDC documentation, choose how & what audience you want to send to AB Tasty Curl example (with the correct CSV file format & your API Key)

curl --location 'https://api-data-connector.abtasty.com/segments/partner_name' \
--header 'X-API-KEY: Your AB TASTY API KEY' \
--header 'Content-Type: text/csv' \
--data 'visitor_id;value;segment;expiration
my_visitor_id;my_value;my_fake_segment;'

Example CSV file content

visitor_id;value;segment;expiration
19102009415591439;SEGMENT_1_VALUE_1;SEGMENT_1;1609136172230
j73xvgwb5yz9re9f;SEGMENT_1_VALUE_2;SEGMENT_1;1609136172230
19051217151193693;SEGMENT_2_VALUE_1;SEGMENT_2;1609136172230

Visitor reconciliation

When a visitor lands on your website and the AB Tasty tag is allowed to execute, our connector will search for the configured visitor_id storage method and check the corresponding data on the UDC.

If a match is found, an event will be sent to our collect endpoint, making the audience available for targeting.

3

Create a Segment to Launch a Test

Once the visitor reconciliation worked, you’ll be able to use the imported data on the AB Tasty Segment Builder.

All audiences imported via the Custom Pull Connector will be listed under the Custom Audiences section. AB tasty>Library>Segments>Create Segment. for more info about segment creation visit How to create a Segment page.