Setting up the integration

Getting started

Before connecting Vibe as an audience destination in Tealium, you must first enable the integration in Vibe and retrieve your Advertiser ID, API Key, and Webhook URL.

To do so:

Log in to your Vibe account and navigate to Settings.
Select Custom Audiences.
Click New Audience.
Choose Tealium as your source.
Select the relevant advertiser.
Copy your Advertiser ID, API Key, and Webhook URL.
Click on Go to Tealium.

Configure Visitor Attributes in Tealium

Before creating the Vibe connector, you need to set up visitor attributes to capture email and IP address data.

Add the Customer Email attribute

In your Tealium workspace, go to AudienceStream > Visitor Attributes.
Click Add Attribute.
Select Visitor as the attribute scope, then click Continue.
Select String as the data type, then click Continue.
Enter customer_email as the attribute name.
Check Restricted Data (this is PII data).
Click Add Enrichment.
Select Set String.
Under Event Attributes, select customer_email.
Click Finish.

Add the Customer IP attribute

Click Add Attribute again.
Select Visitor as the attribute scope, then click Continue.
Select String as the data type, then click Continue.
Enter customer_ip as the attribute name.
Check Restricted Data (this is PII data).
Click Add Enrichment.
Select Join Strings (to capture multiple IPs if a visitor uses different devices).
Set the separator to ; (semicolon).
Under Event Attributes, select client_ip.
Click Finish.
Click Save and then Publish your configuration.

Add the Vibe connector in Tealium

In your Tealium workspace, go to AudienceStream > Audience Connectors.
Click Add Connector.
Search for Webhook and select the basic Webhook connector.
Configure the connector:
- Give your connector a name (e.g., "Vibe CTV").
- Under Authentication, select Basic Auth.
- Enter your Advertiser ID (from Vibe) as the Username.
- Enter your API Key (from Vibe) as the Password.
Click Continue to save the connector.

Create actions to sync your audiences

For each audience you want to sync with Vibe, you need to create two actions: one for when users join the audience, and one for when they leave.

Create a "Join Audience" action

In your Vibe connector, click Add Action.
Give the action a name (e.g., "Vibe - [Audience Name] - Join").
Select the Audience you want to sync.
Under Trigger, select Join Audience.
Click Continue.
Configure the Mapping:
- Action Type: Select Send Batched Visitor Data (recommended for performance).
- Method: Select POST.
- URL: Paste the Webhook URL copied from Vibe.
- Body Content Type: Select application/json.
- Check the box Print Attribute Names (required for Vibe to correctly parse the data).
Click Finish.
Activate the action by toggling it on.

Create a "Left Audience" action

Click Add Action again.
Give the action a name (e.g., "Vibe - [Audience Name] - Left").
Select the same Audience as before.
Under Trigger, select Left Audience.
Click Continue.
Configure the Mapping with the same settings as the Join action:
- Action Type: Select Send Batched Visitor Data.
- Method: Select POST.
- URL: Paste the Webhook URL from Vibe.
- Body Content Type: Select application/json.
- Check the box Print Attribute Names.
Click Finish.
Activate the action by toggling it on.

Repeat for additional audiences

Repeat the steps above (creating both Join and Left actions) for each audience you want to sync with Vibe.

Save and publish your configuration

After creating all your actions:

Click Save to save your connector configuration.
Click Publish to activate your changes.

Important: Changes in Tealium only take effect after you publish. If you forget to publish, your audiences will not sync with Vibe.

Selecting and targeting your Tealium audiences in Vibe

After syncing your audience in Tealium, Vibe automatically displays your available audiences in your Custom Audiences:

Select one or more segments to sync.
Click Save selection.

Once an audience is selected, you can then select these audiences directly when creating or editing your CTV campaigns.

Tealium batches webhook requests based on the following rules: up to 100 requests, 1 minute maximum delay, or 10MB payload size—whichever comes first. This means audience updates typically arrive within a minute.

FAQ

Can I sync multiple audiences from Tealium to Vibe?

Yes. You can create multiple action pairs (Join and Left) within your Vibe connector. Each audience will appear as a separate Custom Audience in your Vibe account.

Why do I need to create two actions per audience?

Tealium treats "Join Audience" and "Left Audience" as separate events. To track both when users enter and leave an audience, you need dedicated actions for each trigger.

What's the difference between "Send Visitor Data" and "Send Batched Visitor Data"?

"Send Batched Visitor Data" groups multiple events together before sending, which reduces the number of API calls and improves performance. We recommend using the batched option. If you accidentally select "Send Visitor Data," the integration will still work.

Why is "Print Attribute Names" required?

Without this option enabled, Tealium sends internal attribute IDs instead of human-readable names. Vibe requires the attribute names (like customer_email) to correctly process the data.

How long does it take for audience changes to sync?

Tealium batches events and sends them within approximately 1 minute. Processing time in Vibe may vary slightly depending on audience size.

Do I need to refresh or reauthenticate my API Key?

No. Your Vibe API Key does not expire unless it's manually regenerated in your Vibe account. If regenerated, you must update the new key in your Tealium connector settings.

What happens if I disable or delete the Vibe connector in Tealium?

If you disable or delete the connector, Vibe will no longer receive audience updates. The audiences will remain in Vibe but will stop syncing. You can reconnect by reconfiguring the connector with your Vibe credentials.

I made changes but my audiences aren't syncing. What should I check?