> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Taboola Ads integration

> Set up the Taboola Cometly integration: connect your Taboola account and add tracking parameters so each conversion is tied to the right ad.

The Taboola Cometly integration connects your Taboola account to Cometly, so your Taboola campaigns, ads and spend appear next to your other ad platforms. You connect with API credentials from Taboola, then add Cometly's tracking parameters to each Taboola campaign.

With both parts in place, Cometly can match each click to the Taboola campaign and ad it came from. That lets you see which Taboola ads produce leads and sales, not only clicks, and decide where to move budget.

## Step 1: Get your Taboola API credentials

To connect Taboola to Cometly, you need your **Client ID** and **Client Secret** from Taboola. The only way to get these is by emailing Taboola support directly.

Send an email to [support@taboola.com](mailto:support@taboola.com) and request your API Client ID and Client Secret. Once you receive them, move on to Step 2.

## Step 2: Connect Taboola in Cometly

1. In Cometly, click **Integrations** in the left sidebar.
2. In the **Ad Platforms** section, find **Taboola Ads** and click **Connect with API**.
3. Enter your **Client ID** and **Client Secret** in the corresponding fields.
4. Click **Connect**.
5. In the list of ad accounts that appears, click **Connect & Sync Data** next to each ad account you want to track in this space (the Cometly workspace you are working in).

![Cometly Integrations page with the Taboola Ads row open on the Connect Taboola with API credentials form, with arrow 1 on Integrations in the sidebar and arrow 2 on the Client ID field.](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/integrations/ad-platforms/taboola/01.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=f54cc3998293124e3c2e97aef2c886cf)

Once connected, your Taboola ad account appears under **Connected Taboola Ad Accounts** at the bottom of the section. Active campaigns begin populating data within 30 to 60 minutes.

## Step 3: Add Cometly tracking parameters to your Taboola campaigns

After connecting your Taboola account, place Cometly's tracking parameters on your Taboola campaigns. You do this inside Taboola's Realize platform at the campaign level.

1. Log in to your Taboola Realize dashboard and go to **Campaigns**.

2. Find the campaign you want to track and click the **edit icon** (pencil) on the right side of the campaign row.

3. In the campaign edit panel, scroll down past **Campaign Setup**.

4. Find the **Tracking** section and expand it.

5. In the **Tracking Code** field, paste the following:

   ```text theme={null}
   comet_source=taboola&comet_campaign_id={campaign_id}&comet_ad_id={campaign_item_id}
   ```

6. Click **Save**.

> [!WARNING]
>
> Do not add a question mark (`?`) or ampersand (`&`) at the beginning of the tracking code. Taboola adds these automatically.

### Tracking parameter breakdown

| Parameter | Value | Description |
| - | - | - |
| `comet_source` | `taboola` | Tells Cometly the traffic is coming from Taboola |
| `comet_campaign_id` | `{campaign_id}` | Taboola dynamically inserts the campaign ID |
| `comet_ad_id` | `{campaign_item_id}` | Taboola dynamically inserts the ad (item) ID |

Taboola fills in these dynamic macros (`{campaign_id}` and `{campaign_item_id}`) automatically when a user clicks your ad. This lets Cometly match each click back to the correct campaign and ad.

### Tips

* **Apply tracking at the campaign level, not the ad level.** Every ad in the campaign is then tracked automatically, and you avoid sending ads back through Taboola's policy review when you edit tracking parameters.
* **Remove Taboola's default UTMs if needed.** When you create a new campaign, Taboola may auto-populate `utm_source=taboola&utm_medium=referral` in the tracking code field. Replace this with the Cometly tracking parameters above.
* **Do not duplicate parameters.** If you use Cometly's tracking parameters at the campaign level, do not also add them to individual ad URLs. Using the same parameters at both levels causes incorrect data.
* **Repeat for every campaign.** Each Taboola campaign you want to track in Cometly needs the tracking code added.

## Check it worked

On the **Integrations** page, expand **Taboola Ads**: the status reads **Connected** and your ad account is listed under **Connected Taboola Ad Accounts**. Within 30 to 60 minutes, your active Taboola campaigns appear in the Ads Manager when you select your Taboola ad account.

## Frequently asked questions

### How often does Cometly update Taboola ad data?

Cometly pulls Taboola ad data, such as amount spent, clicks and impressions, every 30 minutes. It also pulls the previous days again once a day, because ad platforms sometimes adjust a day's numbers after the day has ended.

### Can my teammates see or manage my Taboola connection in Cometly?

No. Ad platform connections are personal: they are tied to your user account, and only you can see and manage them. The ad accounts you connect to a space still report data for everyone who works in that space.

### What do I do if my Taboola data stops syncing in Cometly?

Open **Integrations** and expand **Taboola Ads**. If the status reads **Connection Issue, Resync Required**, click **Resync**, enter your **Client ID** and **Client Secret** again, and click **Resync**. The resync has to be done by the user who connected the profile.

## Next steps

* [Set up the Taboola Conversion API](https://docs.cometly.com/guides/conversion-api/taboola.md) to send your conversions back to Taboola.
* [Connect your other ad platforms](https://docs.cometly.com/getting-started/connect-ad-platforms.md) so all your ad spend is in one place.
* [See how often data updates in Cometly](https://docs.cometly.com/support/troubleshooting/ad-data/data-update-frequency.md) to know how fresh your numbers are.
* [Fix ad data that is not syncing](https://docs.cometly.com/support/troubleshooting/ad-data/ad-data-not-syncing.md) if your Taboola numbers stop updating.
* [Contact support](https://docs.cometly.com/support/contact.md) through live chat or email.

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.