# Vibe Audiences (Actions)

> \[!IMPORTANT]
>
> This feature is in active development and may change before general availability.

## Destination Info

* Accepts [Page](/docs/segment/connections/spec/page), [Alias](/docs/segment/connections/spec/alias), [Group](/docs/segment/connections/spec/group), [Identify](/docs/segment/connections/spec/identify) calls.
* Refer to it as **Vibe Audience**, **Vibe Audiences** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)
* This integration is **partner owned.** Please reach out to the partner's support for any issues.
* This destination is **Beta.**
* This destination is **only** compatible with [Twilio Engage.](/docs/segment/engage/)

[Vibe](https://www.vibe.co/) is a streaming TV advertising platform that helps brands reach their audiences on streaming devices. Vibe lets advertisers to launch TV ads and measure them as digital campaigns with full transparency on performance. Advertisers of all sizes use Vibe to drive awareness, engagement, and growth through premium CTV inventory.

This destination is maintained by Vibe. For any issues with the destination, contact the [Vibe Support team](mailto:team-integration@vibe.co).

## Getting started

### Prerequisites

Before connecting to the Vibe Audiences (Actions) destination, you must first enable the integration in Vibe and retrieve your **Advertiser ID** and **Vibe Token**.

To retrieve the Advertiser ID and Vibe Token from Vibe:

1. Log in to your Vibe account and navigate to **Settings**.
2. Select **Custom Audiences**.
3. Click **New Audience**.
4. Choose **Segment** as your source.
5. Select the relevant advertiser.
6. Copy your **Advertiser ID** and your **Vibe Token**.

## Set up the Vibe Audiences destination in Segment

1. From your Segment workspace, go to **Connections > Catalog** and select the **Destinations** tab.
2. Search for **Vibe Audiences** and select the destination.
3. Click **Add Destination**.
4. Select the Engage space you want to use as the Source. **Note**: this destination only supports sending Engage Audiences to Vibe.
5. Name your destination in the Settings tab.
6. Enter the following settings:
   * **Advertiser ID**: Your Vibe Advertiser ID
   * **Vibe Token**: Your Vibe API token
7. Click **Save Changes**.
8. In the **Mappings** tab, click **New Mapping** and select **Sync Engage Audience to Vibe**.
9. Go to the **Settings** tab and enable the destination.

Your Vibe destination is now ready to receive audiences. Once synced, your Segment audiences will appear in Vibe under **Custom Audiences**. You can then select the synced audiences for use in your Vibe campaigns.

> \[!NOTE]
>
> The audience population might take some time to process.

## Destination Settings

| Field         | Description                     | Required | Type   |
| ------------- | ------------------------------- | -------- | ------ |
| Advertiser ID | Your Vibe advertiser ID.        | Yes      | string |
| Auth Token    | Your Vibe authentication token. | Yes      | string |

## Available Presets

Vibe Audiences has the following presets

| Preset Name          | Trigger                                        | Default Action |
| -------------------- | ---------------------------------------------- | -------------- |
| Sync Engage Audience | Event type = "identify", Event  type = "track" | Sync Audience  |

## Available Actions

Build your own Mappings. Combine supported [triggers](/docs/segment/connections/destinations/actions/#components-of-a-destination-action) with the following Vibe Audiences-supported actions:

> \[!NOTE]
>
> Individual destination instances have support a maximum of 50 mappings.

* [Sync Audience](#sync-audience-1)

### Sync Audience

Sync data to Vibe Audience.

Sync Audience is a **Cloud** action.

| Field                | Description                                                                                          | Required | Type   |
| -------------------- | ---------------------------------------------------------------------------------------------------- | -------- | ------ |
| Email                | User's email (ex: foo@bar.com)                                                                       | Yes      | STRING |
| Audience Name        | The name of the audience to which you want to add users.                                             | Yes      | STRING |
| IP Address           | The IP address of the user.                                                                          | No       | STRING |
| Audience ID          | The ID of the audience to which you want to add users.                                               | Yes      | STRING |
| Personal Information | Additional user profile details to send to Vibe. This information is used to improve the match rate. | No       | OBJECT |

## Engage

You can send computed traits and audiences generated using [Engage](/docs/segment/engage) to this destination as a **user property**. To learn more about Engage, schedule a [demo](https://segment.com/contact/demo).

For user-property destinations, an [identify](/docs/segment/connections/spec/identify/) call is sent to the destination for each user being added and removed. The property name is the snake\_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property `order_completed_last_30days: true`. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to `false`.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

> \[!NOTE]
>
> Real-time audience syncs to Vibe Audiences (Actions) may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.

## Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

| Field         | Description                     | Required | Type   |
| ------------- | ------------------------------- | -------- | ------ |
| Advertiser ID | Your Vibe advertiser ID.        | Yes      | string |
| Auth Token    | Your Vibe authentication token. | Yes      | string |