ClickMagick Knowledge Base

RevContent
Taboola
MGID
Outbrain
Ad.Style

Step 1 – Build Your UTM-Powered URL

Before building your UTM-powered URLs you'll want to make sure you have your Campaigns tracking set up.

For details on how to do that, you'll want to view the article below:

ClickMagick Campaigns - Getting Started

To build your UTM-powered URL, use the “URL Builder” in the Tools Menu:

Enter your landing page URL, and enter the UTM values you want to track.

You must enter values for utm_source, utm_medium, and utm_campaign.

You can use RevContent’s tracking tokens in your UTM URL shown below:

`{adv_targets}`	traffic type the creative was serving based on
`{boost_id}`	numerical identifier of the campaign clicked on
`{content_id}`	numerical identifier of the content clicked on
`{city}`	city of the user clicking on the content
`{state}`	state of the user clicking on the content
`{country}`	country of the user clicking on the content
`{widget_id}`	numerical identifier of the widget the click occurred on
Others	Click here for RevContent's full set of parameters

Step 2 – Add Your UTM-Powered URL To RevContent

Inside of RevContent, create a new Campaign or edit an existing Campaign.

In the Destination URL field, you'll enter your UTM URL you created in Step 1:

And that's all you need to do to set up tracking with Campaigns.

To send conversion data to RevContent, just follow the steps in the article below:

How do I send conversion data to RevContent?

Enter your landing page URL, and enter the UTM values you want to track.

You must enter values for utm_source, utm_medium, and utm_campaign.

You can use Taboola’s tracking tokens in your UTM URL shown below:

`{thumbnail}`	The image or the video URL
`{title}`	The headline for your item
`{platform}`	The user platform on which your item was presented. This returns "Desktop," "Mobile," or "Tablet"
`{campaign_id}`	A unique Taboola campaign ID. This campaign ID can 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 ID, as defined in the "Top Campaign Content" report in Backstage
`{cpc}`	The real-time cost-per-click bid of each click
Others	Click here for Taboola's full set of parameters

To track your ad spend with Taboola, click to the “Optional CMC Parameters” tab of the URL Builder, then under the cmc_cpc field click on “Add Token”.

Then just click {cpc} under Taboola and their dynamic cpc token will be inserted into your URL ...

Note: Taboola sometimes sends the cpc value as a normal decimal number, but other times they send it in an encrypted format.

Unfortunately they don’t explain how this works, and after reaching out to them on multiple occasions we haven’t been able to get any further info on this.

Therefore, you should assume some or all of your cpc values will be encrypted, and follow the two additional steps below to set up support for this as well.

First you will need to reach out to your Taboola support rep and ask them to provide you with your unique secret key that is used to decrypt the cpc values in your URLs. This is the only way to get your Taboola secret key.

Once you have your Taboola secret key, simply go to your ClickMagick Settings, click to the Keys tab, and add your Taboola secret key there. Remember to save when you’re done modifying your Settings!

Step 2 – Add Your UTM-Powered URL To Taboola

Inside of Taboola, create a new Campaign Boost or edit an existing Campaign.

Under URL, you'll enter your UTM URL you created in Step 1:

And that's all you need to do to set up tracking with Campaigns.

To send conversion data to Taboola, just follow the steps in the article below:

How do I send conversion data to Taboola?

Enter your landing page URL, and enter the UTM values you want to track.

You must enter values for utm_source, utm_medium, and utm_campaign.

You can use MGID’s tracking tokens in your UTM URL shown below:

`{teaser_id}`	Returns the Teaser ID
`{widget_id}`	Returns the site from which the user came
`{campaign_id}`	Returns the Campaign ID in the MGID system
`{category_id}`	Returns the ID of the teaser category in the MGID system
`{geo_region}`	Returns the city or region of impressions selected in the campaign settings
`{click_id}`	Returns the unique ID of the click
`{click_price}`	Returns the price per click
Others	Click here for MGID's full set of parameters

Step 2 – Add Your UTM-Powered URL To MGID

Create or edit an ad inside of MGID.

Select the Campaign and Add the URL you created in Step 1:

And that’s it! The traffic you get from MGID will now be tracked in ClickMagick Campaigns.

If you want to send conversion data back to MGID, follow the steps in the article below:

How do I send conversion data to MGID?

Enter your landing page URL, and enter the UTM values you want to track.

You must enter values for utm_source, utm_medium, and utm_campaign.

You can use Outbrain’s tracking tokens in your UTM URL shown below:

`{{ad_title}}`	Returns the headline of your ad
`{{section_name}}`	Returns the referrer's section name
`{{publisher_name}}`	Returns the referrer's publisher name
`{{campaign_id}}`	Returns the ID of the campaign
`{{section_id}}`	Returns the section ID of the referrer
`{{publisher_id}}`	Returns the referrer's publisher ID
`{{ob_click_id}}`	Returns the unique click ID
`{{CPC}}`	Returns the cost-per-click in USD
`{{localCPC}}`	Returns the cost-per-click of the Campaign’s currency
Others	Click here for Outbrain's full set of parameters

Step 2 – Add Your UTM-Powered URL To Outbrain

Create or edit an ad inside of Outbrain.

Enter the UTM URL you created in Step 1 as your Content URL as shown below:

And that’s all you need to do to start tracking your Outbrain ads with ClickMagick.

To send conversion data to Outbrain, just follow the steps in the article below:

How do I send conversion data to Outbrain?

Enter your landing page URL, and enter the UTM values you want to track.

You must enter values for utm_source, utm_medium, and utm_campaign.

You can use Ad.Style's tracking tokens in your UTM URL below:

`{widget_id}`	A unique Ad.Style widget ID, for specific widget appearing on publisher website.
`{ad_id}`	Returns the unique Ad ID
`{city}`	Returns the city the user is viewing/clicking the ad from.
`{campaign_id}`	Returns the ID of the campaign
`{country}`	Returns the country the user is viewing/clicking the ad from.
`{state}`	Returns the state the user is viewing/clicking the ad from.
`{os}`	Returns the operating system on which your ad was presented or clicked.
`{browser}`	Returns the browser type on which your ad was presented or clicked
`{click_id}`	Returns the Unique click ID on Ad.Style network, is needed when you track conversions and pass those back to Ad.Style using server-to-server tracking
Others	Click here for Ad.Style network's full set of parameters

Step 2 - Add Your UTM-Powered URL to Ad.Style

Inside of Ad.Style, after creating a Campaign you'll want to add your URL when creating your ad:

And that's it. The traffic you receive from Ad.Style will appear in ClickMagick Campaigns.

To send conversion data to Ad.Style, just follow the steps outlined in the article below:

How do I send conversion data to Ad.Style?