On-site ads



Before starting implementation of the on-site ads plugin, please make sure you have initialised the AT Internet JavaScript Tracker and selected the plugin from the Tag Composer interface.



The objective is to measure clicks and impressions from on-site (self-promotion) campaigns, as well as campaigns displayed on your site for a third party, and then analyse this data.


Setting up the plugin

The on-site ads plugin can be set up within the Tag Composer interface. Two parameters are affected:

  • Automatic click management: When a click triggers navigation or redirection, browsers prohibit the measurement of these links. This management can force the measurement.
  • Automatic click management timeout: Period of time after which the automatic click management will force the navigation, even if measurement was not able to take place (in milliseconds).


To tag your ads, the tracker exposes two features, publisher and self-promotion, depending on the type of ad to be measured.

These two features then expose three methods:

  • set: is used with the tracker’s dispatch method
  • add: is used with the tracker’s dispatch method
  • send: sporadic measurement of an ad

Publisher parameters

Property Description
campaignId Campaign name (ex: [label] or id[label]) (this parameter is mandatory).
creation Creative name (ex: ([label] or id[label])
variant Name of the variation (ex: ([label] or id[label])
format ID indicating the format (predefined or custom, ex: [120×40]) (see Appendix).
generalPlacement General placement (text ID predefined by us, to be formatted as [label]) (see Appendix).
detailedPlacement Details of the placement (ex: [label] or id[label])
advertiserId Advertiser ID (ex: id[label])
url URL toward which the link points. The URL is linked with the advertiser ID (ex: [urlEncoded])

variant property can’t be used without creation. You must indeed define a creative name before adding variant.

Self-promotion parameters

Property Description
adId ID to be created in the Settings zone which characterises the group “campaign > category > creative > variation” (ex: id) (this parameter is mandatory).
format ID indicating the ad format (predefined or custom. ex: [120×40]) (see Appendix).
productId ID of associated product (subject to the SalesTracker option)

Undesired or unknown parameters can simply be removed from tagging; only “campaignId” and “adId” parameters are mandatory.

Optional parameters (only for send methods)

Property Description
elem Tagged DOM element
event JavaScript event (prevent event propagation) – since v5.7.0
callback Function to execute – since v5.7.0

Tagging an ad impression


Tagging several ad impressions


Tagging an ad click

Example on a form :

The “elem:this” parameter is used for automatic click management; it can simply be removed to disable this management on the link.


Tagging an ad impression on click

Example on a form:

The “elem:this” parameter is used for automatic click management; it can simply be removed to disable this management on the link.




Appendix: formats

  • 468: classic format (468×60)
  • sky320: skycrapers format (160×320)
  • sky600: skycrapers format (160×600)
  • rect180: rectangle format (180×150)
  • rect300: rectangle format (300×250)
  • rect336: rectangle format (336×280)
  • wide: wide format banner (728×90)
  • vert240: vertical format banner 120×240
  • vert600: vertical format banner 120×600)
  • square: square format banner (250×250)
  • popup: popup format
  • popund: popund format
  • 16-9: 16:9 format (320×180)
  • Inter: interstitial format (800×600)
  • maxwid: Maxi leaderBoard format (985×110)
  • intext: intext format
  • 0: others

You can specify any other custom format using the following nomenclature: “[name]”.
Example : you may set a label : [button], or a size : [120×40].


Appendix: placements

  • GT: General Turnover
  • HP: Home Page (only on home page)
  • PHP: Pre-HomePage
  • 0: others
Was this post helpful?
Last update: 10/08/2018