# Integrations general information

This article will help you configure the integration of AB Tasty using your web analytics tool or any other tools or platforms for which integration is made possible within the AB Tasty interface.

## Concept and Definition <a href="#h_01hdh7drnx1rshx8atem3prqy0" id="h_01hdh7drnx1rshx8atem3prqy0"></a>

Integration is a connection between AB Tasty and a third-party tool (Analytics tools, DMPs, CDPs,…). When the connection is established, tools can exchange data.

The integration allows the realization of specific use cases involving both tools. A basic example would be to create an audience in a third-party tool and to display an AB Tasty variation to the same audience.

Integrations are set up directly within the interfaces (AB Tasty + Partner) and require no specific programming skills.

Your integrations are listed in the **Global dashboard** as [**Connected Apps**](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/dashboard/global-experience-dashboard-discovery#h_01jp23gvrmt5bj3yen0a8sz6kq):

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-36008c1fd8f3bb700f42cecca44f46ea91b359ef%2Fb534722dbefcaf3a370c8c98cc424974.png?alt=media)

## The Integration Hub <a href="#h_01hdh7drnxdc2jd7ap8x8ht114" id="h_01hdh7drnxdc2jd7ap8x8ht114"></a>

The [**Integration Hub**](https://app2.abtasty.com/settings/integration/integration-hub) enables you to create, set up, and manage the integrations with the third-party tools available.

To access the integration page, in the left menu click **Integrations**.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-e4a3220c11457bfd7209b992da97f08933bf050c%2Fe46a5d7489414f088fa9cfc3328f35fd.png?alt=media)

The **Integration Hub** page is split into categories that reflect the different types of integrations you can use:

* ***Push integrations***
* ***Pull integrations***
* ***Data Warehouse integrations***
* ***Productivity tools (available soon)***

## Push data Integration General Set-up <a href="#h_01hdh7drnx3n4nehxsv1x6b3w1" id="h_01hdh7drnx3n4nehxsv1x6b3w1"></a>

AB Tasty offers a very simple and detailed report interface. However, you may prefer to read your test results directly in the Analytics tool you are used to, and where you have already defined your objectives.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-6e2350e12ffcbf328ea81c7b6e2100c36b843823%2F92b54241a0b6abe0288f1ea726198593.png?alt=media)

This section is used to create, set up, and manage the integrations that send campaign information viewed by your website visitors to your web analytic tools. This will process them directly in their reporting interface.

### Configuration <a href="#h_01hdh7drny66x8bnem6461c2cm" id="h_01hdh7drny66x8bnem6461c2cm"></a>

To configure an integration, select the desired integration and click create connector, then follow the setup steps.

{% hint style="success" %}
Details on setup for each connector is available here [Push integrations](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/integrations/push-integrations)
{% endhint %}

When setting up a connector in the Integration Hub, you can decide to automatically send campaign data to your connector. To do so, check the box in the *Options* section, and your connector will be automatically added to the *Advanced step* of your future campaigns (it's not retroactive).

This can be useful if you want to receive all your (future) campaign data in your tool without having to add the connector for each campaign.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-b58bbb01a3dd5a65e4579b1226ce5be834415218%2F0f89aac5279e1b66407446f89314ea34.png?alt=media)

By default, the box is not checked, meaning that when you create a campaign, the connector won't be added to the advanced step. You can still select this connector for specific campaign(s).

Once your connector has been created at the account level in the Integration Hub, it is available at the campaign level.

The campaign-level setup allows your campaign to send data to the analytics tool of your choice. This setup is configured at the 6th step of the campaign setup funnel (Advanced options step).

To edit the campaign-level integration, and configuration, open the **Advanced options** step of your campaign and select your tool from the drop-down list. You can activate multiple integrations simultaneously.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-00bb3748c37374bdfd2df8c075f8d8c492942570%2F2a96b72493127f2048bc45947f4abaf6.png?alt=media)

You can also decide to send campaign data to your connector from the connector list of a third-party tool. To do so, go to the Integration Hub, click on the tool card and go to the *setup* tab, unfold the desired connector, tick the box and save your changes.\\

<figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-2aa66d30427d456b0b2f77626f9f5b9d27aa28fd%2F07423652e0287fafb149df6a96154843.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Once launched, your test will start sending data to all the analytics services that you've configured there.

If you wish to have an integration with a tool that is not on the list, please send us a request using our [Feedback request form.](https://feedback.abtasty.com/features-requests)

## Pull data Integration General Set-up <a href="#h_01hdh7drny31e0mnxgpv89em4x" id="h_01hdh7drny31e0mnxgpv89em4x"></a>

This section allows you to create, set up, and manage the integrations that will allow you to use the audience segments generated by your Data Management or CRM Onboarding tools.

Once a tool has been activated, the audience segments associated with it appear as available criteria in the [**segment builder**](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/web-experimentation-and-personalization/targeting-step/how-to-create-a-segment-who-section).

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-93f197d7b723f56c35290c3eef179934471b7419%2Fde7af68401b6b9e5177c64aaf5144a78.png?alt=media)

### Configuration <a href="#h_01hdh7drny4xtn1ah8fy7cxj24" id="h_01hdh7drny4xtn1ah8fy7cxj24"></a>

To configure an integration, select the desired integration and click create connector, then follow the setup steps.

Each CDP or CRM platform or tool that can send cohorts to AB Tasty has a different way to integrate with AB Tasty.

{% hint style="success" %}
Details on setup for each connector is available in the [Pull integrations](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/integrations/pull-integrations) section
{% endhint %}

If you wish to have an integration with a tool that is not on the list, please send us a request using our [feedback deposit process](https://feedback.abtasty.com/features-requests).

### Using and Retrieving Your CDP/ DMP segments <a href="#h_01hdh7drnyd24cf4627d2hf2qw" id="h_01hdh7drnyd24cf4627d2hf2qw"></a>

When you have activated and configured an integration, you will be able to retrieve your tool’s segments in AB Tasty.\
Note that it may take some time for the audiences to be displayed in AB Tasty depending on the tool (see the documentation of your tool to learn more).\
You can retrieve these segments in the segment builder, in the "external data" category:\
\\

<figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-51e2d9225b32f1babe0d4a0651fa6efda453eebb%2F9e5f53d222840d685fdd41d60e02fc0f.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Good to know 💡 -** audience availability in the segment builder

For an audience to be available in the segment builder, it must not be empty, meaning that we have to identify at least one user belonging to the audience.

Once a user is identified, the audience will appear in the segment builder.
{% endhint %}

## DataLayer Integration general information <a href="#h_01hdh7drnywbjkcg2v3kbkn99s" id="h_01hdh7drnywbjkcg2v3kbkn99s"></a>

### Definition <a href="#h_01j3n77fjt0j2mvkttvskrjwax" id="h_01j3n77fjt0j2mvkttvskrjwax"></a>

A data layer is a JavaScript object implemented into a website’s HTML code. The dataLayer collects information related to the interactions between the visitor and the website pages. This information is varied: it can be personal information on the visitor, the currency used for purchases, the product categories available on the website, etc. It is always made up of a name and variable pair (for instance, **Site\_currency** is a name and **USD** is the variable).

This data is forwarded to a Tag Management System (TMS), to be centralized and later utilized when preparing marketing actions targeting visitors.

### Use cases <a href="#id-01j3n7n6z9zxz9w0rjvh2qyk4v" id="id-01j3n7n6z9zxz9w0rjvh2qyk4v"></a>

With AB Tasty, if the pages of your website feature a dataLayer, you can use the data made available to address 3 use cases:

* **Retrieve your dataLayer variables** and use them to create specific triggering conditions to target your campaigns (in the trigger builder - see [article](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/assets-library/creating-and-managing-triggers/list-of-trigger-criteria/datalayer-criterion))\\

  <figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-46b7fc551c3c060da324d9c5d30c27f92ec7492c%2Fee41c4d5dbd833302d5726458f9ef9ab.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
* **Create custom trackings** and trigger events for your campaign reports (see [article](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/assets-library/trackers-page/how-to-create-a-custom-tracker-via-the-datalayer))
* **Create a transaction tracking affiliation** to get some transactional events in your reports (see the [article](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/account/transaction-tag-integration))

### How to set-up your dataLayer <a href="#id-01j3n7mvggbj0kg6r646vxk6nm" id="id-01j3n7mvggbj0kg6r646vxk6nm"></a>

The following TMSs are nativelly supported by AB Tasty:

* TagCommander
* Tealium
* Google Tag Manager

But **if you are using a TMS other than those listed above**, **simply define a custom dataLayer** and specify the JavaScript object containing your data in the dedicated field.

In the [dataLayer set-up page](https://app2.abtasty.com/settings/integration/datalayer), you need to select the TMS that enables you to access your data layer information.

If you are using a TMS other than those available on the list, select **Custom** from the drop-down list and enter the JavaScript object that matches your data layer.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-854c3e11d33e3ceb200d906dc02be6cfc7507991%2F4e1a3df4bf4bbab62b26dbcb9c24689d.png?alt=media)

Once the configuration is complete, you may use your dataLayer to add visitors to your campaigns.

## Other Integrations <a href="#h_01hdh7drny9hretbc9vkafybbp" id="h_01hdh7drny9hretbc9vkafybbp"></a>

AB Tasty offers other integrations that will help you execute different use cases. See details in the section [Other integrations](https://docs.abtasty.com/~/revisions/jp976foDpdJWagLtM22v/integrations/other-integrations).
