# Retrieving your third-party tools’ audiences in AB Tasty - Feature Experimentation & Rollouts

## 📖 Definition <a href="#h_01hddvxz8h5vv08srv42wtqqn4" id="h_01hddvxz8h5vv08srv42wtqqn4"></a>

The Integrations page enables you to create and manage integrations with the third-party tools (DMPs, CDPs, etc.) available on your Flagship account.\
From there, you can activate integrations in order to retrieve all the audiences you have configured in your third-party tools. You will then be able to use them as targeting keys in the Targeting configuration step and as filters in the reporting of your use cases.\
To access the integration page, go to **Settings** > **Integrations**. It is divided into 3 main sections:

* [Generated integration API keys](#h_01FYBJX66Z0EG4NVDZ4SAQH74C)
* [Integration configuration](#h_01FYBJXFAH81KDJNNTGPT0KZNS)
* [Activated integrations](#h_01FYBJXR8RGKTT2W3V79XZGP9W)

### Generated integration API keys![Section\_1.png](/files/zIoVkTx92fEFdGUSs3WS) <a href="#h_01fybjx66z0eg4nvdz4saqh74c" id="h_01fybjx66z0eg4nvdz4saqh74c"></a>

This section displays the list of all integration API keys that have been generated for your integrations.\
An integration API key is a unique key that enables a link between Flagship and a third-party tool.\
The name of each integration API key refers to the name of the third-party tool to which it is linked.

| <p>⭐ Good to know</p><p>Each API key is unique and will only work with its related third-party tool.</p> |
| -------------------------------------------------------------------------------------------------------- |

Some integrations do not require an API key.

However, for those requiring an API key, we recommend keeping it safe. Indeed, the API key is displayed when you configure the integration for the first time, but you will not be able to access it anymore after that time.\
If you have lost your API key, you can still revoke it and generate a new one directly from the integration line of your third-party tool in Flagship.

![Regenerate\_API\_key.png](/files/LuER9o54rPNbAgndgv4k)\
\\

### Integration configuration <a href="#h_01fybjxfah81kdjnntgpt0kzns" id="h_01fybjxfah81kdjnntgpt0kzns"></a>

![Section\_2.png](/files/Ivv3uhPxhb6mUKHT3Sq5)\
This section enables you to activate an integration with a third-party tool supported by Flagship.\
The dropdown list displays the available third-party tools.\
If you would like an integration with a tool that is not on the list, please send us an [email](mailto:product.feedback@abtasty.com?subject=Request%20for%20integration) with your request.\
After selecting your tool, you will be asked to configure the integration by filling in the required fields.

### Activated integrations <a href="#h_01fybjxr8rgktt2w3v79xzgp9w" id="h_01fybjxr8rgktt2w3v79xzgp9w"></a>

![Section\_3.png](/files/gtOOvixd2lVaHob404ej)

This section displays the integrations you have activated with your third-party tools. From there, you can edit the integration configurations, read the integration documentation and delete it.

## ⚙️ Configuration <a href="#h_01hddvxz8j2ympqaad18tbx5nm" id="h_01hddvxz8j2ympqaad18tbx5nm"></a>

### Activating and configuring an integration <a href="#h_01hddvxz8jshjw6679zznrfms0" id="h_01hddvxz8jshjw6679zznrfms0"></a>

To retrieve the audiences of a web analytics tool, you must enable and configure its integration in Flagship.\
From the integrations page, apply the following steps:

1. From the third-party tool dropdown list, select your tool.
2. Fill in the required fields (if any).
3. Click *Add tool*.
4. If an API key is requested, a popin appears with the key. Copy it and keep it safe as you won’t be able to retrieve it from the platform once you close the popin.\
   The integration appears in the list.
5. Configure the integration from the third-party tool. For more on this, refer to the integration documentation of the tool by clicking on *Learn more*.

Once the integration is activated, you must send the *flagship\_visitor\_id* to your third-party tool via one of the methods indicated in the integration documentation.

### Retrieving and using your audiences <a href="#h_01hddvxz8jxsev6vtfsp5n8734" id="h_01hddvxz8jxsev6vtfsp5n8734"></a>

Once you have activated and configured the integration, you will be able to retrieve your tool’s audiences in Flagship.\
Note that it may take some time for the audiences to be displayed in Flagship depending on the tool (see the documentation of your tool to learn more).\
You will be able to use these audiences:

* In the targeting step of your use cases to target your visitors.\
  ![Targeting\_integration.png](/files/WJASY31haHH4wOoc0ogz)
* In the filters of your use case reporting to filter on a specific audience.\
  ![Filters\_integration.png](/files/vccaeI3COWGGCiZAJksU)

| <p>🚩 Heads up</p><p>In the filters of your reporting use case, you will be able to see all the audiences of the third-party tools integrated in your account. You will be able to filter on any of them, even if they have not been used in your use case. Indeed, if you filter on an audience that is not used in your use case, no results will come up.</p> |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

**Need additional information?**

Submit your request at <product.feedback@abtasty.com>

Always happy to help!


---

# Agent Instructions: 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:

```
GET https://docs.abtasty.com/flagship-deprecated/integrations/retrieving-your-third-party-tools-audiences-in-ab-tasty-feature-experimentation-rollouts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.