We’ve migrated our documentation to a new site, which means some URLs have changed.
Audience

Place-Holders in Click, Target, Destination URLs

For place-holder replacement in a Text Creative, see Text Creatives

 We currently support a range of place-holders you can add to your click URLs to provide additional metrics for your referrer tracking and site analytics.

NOTE: You can also use any parameters passed along on the click URL.

Cxense Advertising Place-holders

Placeholder

Description

creative

The identifier of the creative that matched.

ad

The identifier of the ad that matched.

campaign

The identifier of the campaign that matched.

adaccount

The identifier of the advertisement account that matched.

adspace

The identifier of the space on which the ad was shown.

pubaccount

The identifier of the publisher account that owns the adspace.

keyword

The match type and keyword that was used to match and rank the ad in the auction.

keywordText

The keyword text used to match and rank the ad in the auction.

ifContent

The weight applied to contextual if the request was content based. This corresponds to a non-zero contextual weight on the AdSpaces configuration.

ifSearch

Whether the request was search based (used keywords from contextual or a search box)

ifBehavioral

The weight applied to behavioural if the request was user profile based. This corresponds to a non-zero behavioural weight on the AdSpaces configuration.

 

Examples

Standard Cxense Advertising Place-holders

In this first example we create a click URL that embeds each of the core identifiers in a destination URL:

http://www.cxense.com/?creative={creative}&ad={ad}&campaign={campaign}&adaccount={adaccount}&adspace={adspace}&pubaccount={pubaccount}

The result would be similar to the following (with the IDs replaced with the appropriate values for your environment):

http://www.cxense.com/?creative=e321a23a882d21f4&ad=85c408e449f9478c&campaign=929115aeeed80aee&adaccount=3f90529e00865bd7&adspace=3529e9c8849f8895&pubaccount=8ae6aa923d094e84

In this next example we turn on all placeholders:

http://www.cxense.com/?creative={creative}&ad={ad}&campaign={campaign}&adaccount={adaccount}&adspace={adspace}&pubaccount={pubaccount}{keyword:&k=}{keywordText:&kt=}{ifSearch:&src=}{ifContent:&wC=}{ifBehavioral:&wB=}

Note that these advanced placeholders also allow you to include a prefix (e.g. "&k=") since the placeholder will be replaced with an empty string if it is not matched. For example, on a space without contextual targeting, this would be the result:

http://www.cxense.com/?creative=e321a23a882d21f4&ad=85c408e449f9478c&campaign=929115aeeed80aee&adaccount=3f90529e00865bd7&adspace=3529e9c8849f8895&pubaccount=8ae6aa923d094e84&wB=5

Note the behavioural weight in this case was set to 5 on the adspace, and a prefix of "&wB=" results in the string "&wB=5" being appended to the click URL.

If we set contextual weight to 10, and include a keyword for matching then the resulting click URL is:

http://www.cxense.com/?creative=e321a23a882d21f4&ad=85c408e449f9478c&campaign=929115aeeed80aee&adaccount=3f90529e00865bd7&adspace=3529e9c8849f8895&pubaccount=8ae6aa923d094e84&k=broad:subaru+wrx&kt=subaru+wrx&src=Search&wC=10&wB=5

Note the "broad:subaru+wrx" entry for the keyword along with the "src=Search" replacement for "ifSearch" and the contextual weight.

Custom Click URL parameters

In this case, you might be serving impression responses via one of the programmatic APIs (e.g. XML or JSON). Your publishing partner supplies additional information on the click URL to indicate which site initiated the request and you would also like to capture the referring URL. 

The click URL received by Cxense Advertising looks like this:

http://adserver.cxense.com/adserver/click/fb_aFY0VOp2XIZcHwxGOKepjdRyKLQ27GrkVMiiPLegNmjE_YAalnGCe1q0oCvYt4Cvy04o4iwuRqnJwh-zFpl77g7Bgo4tN8CYwuoeqgVgsSE9b-MjI-IiJFakOsKIXroSoEOq8zA..&pub=abc123

In this URL, the publisher is identified by 'abc123' and you wish to pass that on to the click tracker. Your ad's click URL would be:

http://advertiser.com/tracking?{Referer:utm_source=}{pub:&partner=}

Which would result in the following final URL sent to the click tracker:

http://advertiser.com/tracking?utm_source=http%3A%2F%2Fcxense.com&partner=abc123

Last updated: