# Import Heap Audience to Feature Experimentation

The **Heap Analytics** integration allows you to import your Heap segments in Feature Experimentation & Rollout (FE\&R) so you can target them with FE\&R campaigns.

{% hint style="warning" %}
**Heap Analytics Segments**

A segment in Heap is any subset of users based on a particular criterion defined by you.\
For further information on how to use segments please refer to the [Heap Analytics documentation](https://help.heap.io/define-analyze/data-management/segments-overview/).

To make this integration work, Heap must receive the AB Tasty FE\&R visitor ID.

What you must do:\
\
• Identify the AB Tasty FE\&R visitor ID you already use (details [here)](https://docs.abtasty.com/server-side/concepts/universal-collect-1)\
• Collect this same value in Heap, as it’s the key used for user matching\
• In Heap, the property name can vary depending on your implementation\
• You can declare it as a user property in your Heap tracking code, for example:\
`heap.addUserProperties({ FlagshipVisitorId: 'xxxx' });`
{% endhint %}

Once the integration is active on FE\&R you need to export the segment from Heap.

This article will walk you through the different steps to setup the integration on Mixpanel side and to export your cohorts.

### Enable the integration on Feature Experimentation <a href="#h_01j73bjyh5j5hvbznx0epxtgba" id="h_01j73bjyh5j5hvbznx0epxtgba"></a>

<figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FsufbqcdRMh6zUz2ovNjE%2FCapture%20d%E2%80%99e%CC%81cran%202026-03-09%20a%CC%80%2017.54.43.png?alt=media&#x26;token=cf8bb53c-cd3e-4a96-b330-2f9fc17eec73" alt=""><figcaption></figcaption></figure>

To enable the integration on FE\&R, follow the steps below:

1. Access **Settings > Integrations > Feature Experimentation Tab > Pull**
2. Select **Heap Analytics > Create**
3. Click **Authorize and Create.**
4. You will be redirected to the Heap Analytics interface in which you will be able to allow the FE\&R integration to access your Heap environment (this is necessary to enable integration between the two tools). Click **Allow**.\
   \
   ![Capture\_d\_e\_cran\_2022-12-21\_a\_\_16.51.34.png](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FzHo38ZYFeoTgb3QVsz6c%2Fc5728d1a471e02ed3d0d7ed17e4c6708.png?alt=media\&token=2860e307-7d85-43a8-a02c-f6e98e754577)
5. After clicking Allow you will be redirected to FE\&R's integration setting page. The integration is set up and you will see it in the validated list. The TokenID field is automatically filled.

The Heap Analytics integration is set up. You now need to export the Heap segment to FE\&R. This is done on the Heap Analytics interface, and it is explained in the next part of this article.

### Export the the Segments From Heap Analytics to Feature Experimentation <a href="#h_01j73bjyh607j7887pkv4cfqng" id="h_01j73bjyh607j7887pkv4cfqng"></a>

To be able to target your Heap segments with FE\&R campaigns, you now need to export the desired segments to FE\&R.

To export the segments to FE\&R, follow the steps below:

1. Access **Definitions > Segments** to see the list of defined segments.
2. Select the segment you want to export to FE\&R:\
   \
   ![Capture\_d\_e\_cran\_2023-01-27\_a\_\_17.02.04.png](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FSb3gt7kOrKeodxB8LM8W%2F0a833f3f4efe0bfad7aad26fda9337ff.png?alt=media\&token=03f86002-53fc-4556-b161-4a380b0c31d5)<br>
3. In the segment panel, under **Integrations**, turn on the **Flagship** switch.\
   \
   ![Capture\_d\_e\_cran\_2023-01-27\_a\_\_17.05.06.png](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FnJYwTSLCj6rZtqd9yv3c%2Fd5f8dcfaf5b983d02a18b031d2aa7bc1.png?alt=media\&token=b965990a-e3e4-4318-afe1-7256d1a4b37b)<br>
4. In the export config, choose FlagshipVisitorId as the Heap User ID.

{% hint style="warning" %}
In order to make the integration work you must be collecting the Flagship visitor ID into Heap.

In Heap Analytics the AB Tasty FE\&R visitor ID can have another name depending on how you collect it. You can declare it as a user property in your Heap tracking code:

```
heap.addUserProperties({ FlagshipVisitorId: 'xxxx'});
```

{% endhint %}

1. Click **Confirm**.

   <figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FMtrAzlKqAvSj4cExZWG5%2F4777885e6c602801d5379cb57f767815.png?alt=media&#x26;token=0f4f063c-f751-4907-864b-242204cd3582" alt="" width="375"><figcaption></figcaption></figure>

You will be able to choose **Enable Recurring Sync**. We recommend using this option to keep your segment updated in AB Tasty. Confirm by clicking **Enable Recurring Sync** or **Sync now**.

For global information on retrieving audiences, please refer to [this page](https://docs.abtasty.com/flagship-deprecated/integrations/retrieving-your-third-party-tools-audiences-in-ab-tasty-feature-experimentation-rollouts).

**Need additional information?** Submit your request at <product.feedback@abtasty.com> Always happy to help!
