Skip to main content

URL Parameters for Taboola

How to add the correct UTM parameters to your Taboola campaigns so Klar can attribute your ad spend accurately.

Written by Maximilian Rast

Three things to know before you start:

✅ Editing UTM parameters at the campaign level does not trigger an ad review. Make your changes there.

⚠️ Editing UTM parameters at the item / individual URL level does trigger an ad review — avoid making changes there.

🚫 Do not set UTM parameters at both the campaign level and the item/individual URL level. Taboola will drop some parameters, causing inaccurate data. Set them at the campaign level only, and remove any existing parameters at the item level.


Parameters

If you are not using UTM parameters yet, or want to optimise your existing setup, use the full snippet:

utm_source={site}&utm_medium=taboola&utm_campaign={campaign_name}&klar_source=taboola&klar_cpid={campaign_id}&klar_agid={campaign_item_id}

⚠️ Do not add a ? at the beginning — Taboola adds this automatically. Do not use # in your naming convention — it cuts off everything after it in the URL.

If you already have UTM parameters, make sure these are either already present or appended to your existing parameters:

utm_source=taboola OR utm_medium=taboola

utm_campaign={campaign_name}

klar_source=taboola

klar_cpid={campaign_id}

klar_agid={campaign_item_id}

Example:

Below is an example of how adding the required parameters to existing parameters looks like with the added parameters being bold:

utm_source=taboola&utm_medium=referral&utm_campaign={campaign_name}&klar_source=taboola&klar_cpid={campaign_id}&klar_agid={campaign_item_id}


Implementation

There is no bulk editing feature. Update each campaign individually:

  1. Create a new campaign or open an existing one

  2. Inside the campaign, go to the Tracking Code section

  3. Paste the parameters from above into the Tracking Code field

  4. Save the campaign

  5. Repeat for all your remaining campaigns

Did this answer your question?