Import Heap Audience to Feature Experimentation

Heap is a Product Analytics company that provides analytics infrastructure and helps their clients to focus on discovering insights and taking action, not writing tracking code.

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.

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.

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) • 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' });

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

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.
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

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:
3. In the segment panel, under Integrations, turn on the Flagship switch.
4. In the export config, choose FlagshipVisitorId as the Heap User ID.

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'});

1. Click Confirm.

   

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.

Need additional information? Submit your request at [e-mail] Always happy to help!