> For the complete documentation index, see [llms.txt](https://docs.abtasty.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abtasty.com/feature-experimentation-and-rollout/feature-experimentations-integrations/heap-feature-experimentation-integration/import-heap-audience-to-feature-experimentation.md).

# 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="/files/jo5nZh469SsGZVLFxoKg" 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](/files/swtjb00FmeTbXN5zP7aa)
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](/files/JYzSFzdw1PrJlReaUNGp)<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](/files/mv6QK4CCSSlFuWo9Ap7N)<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="/files/KScQd8R3S7Lp5gYPRusV" 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!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.abtasty.com/feature-experimentation-and-rollout/feature-experimentations-integrations/heap-feature-experimentation-integration/import-heap-audience-to-feature-experimentation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
