How to Connect Taboola to Cometly
This guide walks you through connecting your Taboola account to Cometly and setting up the correct tracking parameters on your Taboola campaigns so Cometly can accurately attribute your conversions.
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 and request your API Client ID and Client Secret. Once you receive them, move on to Step 2.
Step 2: Connect Taboola in Cometly
In Cometly, click Integrations in the left sidebar.
Scroll down to Connect Taboola and expand the section.
Enter your Client ID and Client Secret in the corresponding fields.
Click Connect.
Once connected, your Taboola ad account will appear under Connected Taboola Ad Accounts at the bottom of the section.
Step 3: Add Cometly Tracking Parameters to Your Taboola Campaigns
After connecting your Taboola account, you need to place Cometly's tracking parameters on your Taboola campaigns. This is done inside Taboola's Realize platform at the campaign level.
Log in to your Taboola Realize dashboard and go to Campaigns.
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:
comet_source=taboola&comet_campaign_id={campaign_id}&comet_ad_id={campaign_item_id}
6. Click Save.
Important: 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 |
|
| Tells Cometly the traffic is coming from Taboola |
|
| Taboola dynamically inserts the campaign ID |
|
| Taboola dynamically inserts the ad (item) ID |
These dynamic macros ({campaign_id} and {campaign_item_id}) are populated automatically by Taboola when a user clicks your ad. This allows Cometly to match each click back to the correct campaign and ad.
Tips
Apply tracking at the campaign level, not the ad level. This ensures every ad in the campaign is tracked automatically and avoids 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=referralin the tracking code field. Replace this with the Cometly tracking parameters above.Do not duplicate parameters. If you're using Cometly's tracking parameters at the campaign level, do not also add them to individual ad URLs. Using the same parameters at both levels will cause incorrect data.
Repeat for every campaign. Each Taboola campaign you want to track in Cometly needs the tracking code added.
If you have any questions, reach out to us via live chat or email at support@cometly.com