fr | en | es | de

Advertisements

New!
Discover the latest tools in the
Analytics Suite, thanks to our new online help.

Contents: Hide

An advertising campaign must be considered as a set of web banners belonging to the same message/promotion.

It is not necessary to declare a campaign for each banner, as each banner within a given campaign will be uniquely identified using a label which will be provided in the tag.

The campaign declaration is used to measure either of the following:

Declaring a marketing campaign

Note

We strongly recommend that you declare your own campaigns. However, you can automate your campaigns. In practical terms, you have to specify an xtor data interval, we will automatically record all of the campaigns which are encountered in this parameter. These campaigns are called "Automatically generated campaigns" which you can rename depending on the ID that is then given to them.

Measuring links

Important

If your measurement is based on a First-party cookie, the DIRECT METHOD (described below) must be used (with xtor in the url).

Direct method

For the purposes of visits, this method will only count one click per URL containing an identical xtor.

Place the xtor variable in the advertisement link that directs traffic to your website. This xtor will be similar to the one used to measure impressions.

Several cases are possible:

Use: http://www.mysite.com/#xtor=...

Use: http://www.mysite.com/index.php#xtor=...

Use: http://www.mysite.com/index.php?other_variable=2#xtor=...

Note

- Using # avoids having these xtor variables referenced in search engines.
- Using a tool which does not accept the character "#" implies that you replace "#" with "?" (or "&", depending on the location of the variable).

Redirection method

This method makes it possible to measure the clicks in a more precise fashion.

While the “direct” method considers any URL containing an xtor as a click (with the risk of overestimation due to the use of the “Back” button, or bookmarking), the redirection method is more precise in guaranteeing the click count, only counting when redirection occurs on our server.

The principle of such tagging involves changing the link’s URL to a URL that directs traffic to our server (which is in charge of the final redirection).

Important

This method uses only 3rd party cookie technology to link information from our redirection server with the server hosting your destination site.
This method should not be used if your measurement relies on the use of first-party cookie technology.
If you use version 4.2.001 (or later) of the xtcore.js file this method will not work for Safari browsers which use first-party cookie technology by default.

Example:

http://logxxxx.xxxx.xxxx/go.url?xts=...&xtor=...&url=http://www.site.com

 

What is the URL composed of?

Logxxxx: sub-domain in charge of the redirection and measurement of the click (xx should be replaced with the digits you received for your subscriber space).

go.url: address which allows for a “strict” redirection to your website (without changing the URL contained in the url variable. This method doesn’t allow “post click” measurements (remanence) because the destination URL does not contain the xtor variable.

xts: the xts variable contains the AT Internet ID of your website (xtsite in the tag code).

xtor: the xtor variable must contain at least a prefix indicating the type of campaign as well as a campaign ID.

url: the URL variable contains the precise destination URL.

Note

If you wish to track remanence, then you should replace the go.url with gopc.url. This will allow the user to arrive on your website with the xtor variables included at the end of the URL when they click on the link. If the URL of your site contains the character "&" (but no "?"), you should use another method. Please contact our Customer Department (via the Support centre) to get more information.

Structure of the xtor variables

The different parameters of the xtor variable must respect the following rules (according to the format: xtor=A-B-[C]-[D]-[E]-[F]-[G]-[H])

 

Compulsory:

A (source): AD prefix.

B: value of the campaign ID (provided by AT Internet).

 

Optional:

Ad Material:

C: creative (according to the format [label] or id[label]).

D: variant (according to the format [label] or id[label]).

E: format (according to the ID given by AT Internet: see appendix. You can also specify any other format by using the following nomenclature: "[name]". For example:you can specify either a name [button], or a size [120x40]).

Support:

F: website (specifies the URL according to the format [url]).

G: general position on the overall website (according to the ID given by AT Internet: see appendix A).

H: details of the position on the web page.

 

Example:

xtor=AD-3030-[ad_version7]-[without_text]-[468]-[www.site.com]-[GT]-[top_page]

Important

* The names in the square brackets ([ ]) must be indicated as page names: with no special characters (accents, spaces or others).
* If we find [xxxxx] and id[xxxxx], they are considered as 2 different items (even if the name is the same).
* If we find the same ID with 2 different names (for example 23[creative] and 23[creatives]), only the first name will be kept and associated with the ID..
* The values of A, B, C (and possibly E, F G and H) must be the same for both the link measurements and the impression measurements.
* Unlike the impression measurement, a “type=pub” variable is not necessary in the click measurement.

Measuring banners

Tagging the banner to measure impressions

There are several different methods which can be used to measure banner impressions:

 

Method 1: insert the code, containing the 1x1 transparent pixel. This will only work if the banner is based on JavaScript code or an iframe in HTML.

 

For example, in JavaScript:

xt_imgpub = new Image();

xtdmedpub = new Date();

xt_imgpub.src = 'http://logxxxx.xxxx/hit.xiti?xts=xxxx&xto=A-B-C-D-E-F-G-H&type=ad&hl=' + xtdmedpub.getHours() + 'x' + xtdmedpub.getMinutes() + 'x' + xtdmedpub.getSeconds();

 

Method 2: use a redirection server (AT Internet) to display the banner. Redirection can be carried out directly on the image or on the file (JavaScript or iFrame).

 

For example, replace:

<script type="text/javascript" src="http://ad.serveur.net/pub.js?id=779"></script>

 

With:

document.write('<sc'+'ript type="text/javascript" src="http://logxxxx.xxxx/get.url?xts=xxxx&xto=A-B-C-D-E-F-G-H&type=ad&url= http://ad.serveur.net/pub.js?id=779"></sc'+'ript>')

 

Pease note that it is necessary to fill in 4 pieces of information which are specific to your website:

Important

If you use an Adserver tool (OAS, DART, Smart, Adverline, etc.), please contact us for an adapted code implementation (in order to bypass the tool already in place).

Structure of the xto variables

The different parameters to be filled in for the xto variable are described below (according to the following format: xto=A-B-C-D-E-F-G-H).

 

Mandatory:

A (source):AD prefix

B: value of the campaign ID (given by AT Internet).

 

Optional:

Ad Material:

C: creative (according to the format [label] or id[label]).

D: variant (according to the format [label] or id[label]).

E: Format (according to the ID given by AT Internet, listed in the appendix. You can also specify any other format by using the following nomenclature: "[name]". For example:you can specify either a name [button], or a size [120x40]).

Support:

F: website where the banner is posted (by specifying the URL according to the format [url]).

G: general position on the website (according to the ID given by AT Internet, listed in appendix A).

H: details of the position on the web page (following the format [label] or id[label]).

 

Example:

xtor=AD-3030-[ad_version7]-[without_text]-[468]-[www.site.com]-[GT]-[top_page]

 

In the example above we are using an advertisement for version 7. Where the creative name is ["ad_version7"], however, we have not specified a variant. The format of the advertisement is 468x60 and it is displayed on www.site.com. A value of [RG], general turnover is specified for the general position and the ad will tend to appear on the top of the page [top_page].

Important

* The names in the square brackets ([ ]) must be indicated as page names: with no special characters (accents, spaces or others).
* If we find [xxxxx] and id[xxxxx], they are considered as 2 different items (even if the name is the same).
* If we find the same ID with 2 different names (for example 23[creative] and 23[creatives]), only the first name will be kept and associated with the ID..
* The absence of “type=AD” will lead to the measurement of a click (source) and not a banner impression.

You must insert these variables into the URL, regardless of the method being used (i.e. Redirection or Call to a tag).

 

ico_up.gif