In this article you will learn how to properly set up URL parameters for tracking a Taboola campaign.

URL parameters are a means to track your Taboola ad clicks and deliver that information to your analytics platform. Using your analytics platform, (e.g. Google Analytics or Adobe Omniture) you can track and verify the data, optimize to your goals, and understand how users behave once they have clicked on your Taboola campaign items. 

URL parameters are pairs of a key and a value separated by an equals sign (=), and joined by an ampersand (&). These parameters appear in the URL following a question mark.
For example, http://yourlandingpage.com?utm_source=Taboola&utm_medium=referral

URL parameters can be added at the campaign level, or at the item level (see instructions below). 

Dynamic Values for Tracking Parameters

Taboola macros are dynamic parameters populating automatically upon ad serving. Real time data is populated according to your setup.

You can add Taboola macros to your URL parameters, so Taboola will dynamically pass back the desired information. (Note: You can add these macros under any URL parameter you’d like.)

By adding these macros, you will have insight into performance by connecting the dots between multiple data points, allowing you to optimize towards best performing traffic.

Note: You can insert passback macros into your URL parameters at both the campaign and item level.

• {site} - The publisher site or application name.
• {site_id} -  A unique Taboola site ID, for the publisher site or app.
• {site_domain} -  The name of the website or URL.
• {thumbnail} - The image or video URL.
• {title} - The headline for your item .
• {timestamp} - The timestamp for when the item was served.
• {cachebuster} - Generates a unique and random numeric string per impression. This macro should be used for cache-busting.
• {platform} - The user platform on which your item was presented. This returns as "Desktop," "Mobile," or "Tablet".
• {campaign_id} - A unique Taboola campaign ID. This campaign ID can also be found on the “Campaign Management” page in Backstage.
• {campaign_name} - The campaign name, as defined in the “Campaign Management” page in Backstage.
• {campaign_item_id} - A unique Taboola item ID, as defined in the “Top Campaign Content” report in Backstage.
• {cpc} -The realtime CPC bid of each click. The CPC value is encrypted, to decrypt it you will need to be able to execute a decryption script. This implementation requires technical programming knowledge. If you are able to code, contact your Taboola Account Manager to receive the guide.

Adding URL Parameters at the Campaign Level

URL parameters can be added at the campaign level. This means the URL parameters added will be appended to every item in that specific campaign.

Here is how to add URL parameters at the campaign level:

1. When creating a new campaign or editing an existing campaign, you can add URL parameters at the bottom of the New Campaign/Edit Campaign page, in the Tracking Code section.
2. Change your parameters as needed. Please note that when creating a new campaign, Taboola’s default URL parameter is “utm_source=taboola&utm_medium=referral”. You can edit this as needed.
   
   You should not add a question mark or an ampersand in the beginning of the tracking code (We add it in the backend).
   
   
3. Click Continue to save your changes.
   
   

Adding URL Parameters at the Campaign Item Level

When adding campaign items to a new campaign or editing campaign items in an existing campaign, you can add URL parameters to individual destination URLs.

1. Before adding your destination URLs to your campaign item, add your desired URL parameter.
2. To do this, add your URL parameter to your destination URL by first adding a question mark (“?”) at the end of the original URL. A question mark should always separate your destination URL and your URL parameters.
3. Then, add your URL parameter. For example, blog.taboola.com?utm_source=Taboola&utm_medium=referral
4. Add your campaign items to a new campaign or edit campaign items for an existing campaign.
5. On the Campaign Inventory page, add your destination URLs with your URL parameters added.
6. Note to remove the campaign level default tracking code if you are using the same parameters (“utm_source=taboola&utm_medium=referral”).

Additional Notes and Best Practices

1. Use each parameter only once, and only to apply them at either the campaign or item level - not both.
   URL parameters cannot be added at both the individual URL level AND campaign level, it will cause the data to be incorrect in your analytics platform.
   (For example, you cannot have "utm_source=Taboola" added at the campaign level and "utm_source=cpc" appended to a URL in the campaign.)
   **Note that on the campaign level you have default values, remove them if needed (“utm_source=taboola&utm_medium=referral”)
2. If you are using Google Analytics, use utm_source=taboola.
   utm_source is the most important utm parameter for correct data collection.
3. Tracking parameters at the campaign level vs. item level: Setting up tracking parameters at the campaign level means that you can edit them without sending your items back to our policy review again.
   If you choose to set it up on the item level and edit it after the item was approved, the item will go into our policy review process.

Read more: 3rd party tags