New!
Discover the latest tools in the Analytics
Suite, thanks to our new online help.
Contents: Hide
Before declaring your sponsored links, you must decide if you want to distinguish each campaign according to platform used (Google, Yahoo Search marketing, etc.) and you also need to decided what each campaign will contain (same theme, same product, etc).
All of the information described in this document assumes that you have already downloaded version 3.1001 or later of the xtcore.js file. This file is available in your interface by going to:
Tools > Tags > Main tag.
Go to Tools > Sources & Campaigns
Click on Add and select your source
Select automatic
Enter your campaign label (you can enter several labels at the same time by using enter)
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.
You can categorise your campaigns in the "Type"
field. It is also possible to categorise campaigns by adding the "C"
variable to the xtor variable as it is being created (please refer to
the section entitled "Structure of the xtor variables").
- If you select "Sponsored Links (unclassified), the declared campaign
will be declared as a multi-platform campaign.
- If you select any other type of platform (Google Adwords, YSM etc) you
need to enter the prefix which corresponds to the declared platform in
the "C" variable. Any other prefix will not be measured.
If your measurement is based on a First-party cookie, the DIRECT METHOD (described below) must be used (with xtor in the url).
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:
A link that points to the root of the website directory.
Use: http://www.mysite.com/#xtor=...
A link that points to a file without adding any parameters.
Use: http://www.mysite.com/index.php#xtor=...
A link that points to a page by adding parameters.
Use: http://www.mysite.com/index.php?other_variable=2#xtor=...
- 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).
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).
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.
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.
The different parameters of the xtor variable must respect the following rules (according to the format: xtor=A-B-C-[D]-[E]-F -[G]):
Compulsory:
A (source): SEC prefix (provided by AT Internet)
B: value of the campaign ID (provided by AT Internet)
Optional:
C: platform ID (only if your campaign is distinct according to each platform):
xtor=SEC-identifier-GOO for Google
xtor=SEC-identifier-YSM for Yahoo Search Marketing
xtor=SEC-identifier-MIV for Miva
xtor=SEC-identifier-WAN for Orange
xtor=SEC-identifier-MSN for MSN
xtor=SEC-identifier-MIR for Mirago
xtor=SEC-identifier-SKL for Sklik
xtor=SEC-identifier-ADF for AdFox
xtor=SEC-identifier-ETG for eTarget
xtor=SEC-identifier-YAN for Yandex
xtor=SEC-identifier-EBA for Adcommerce (Ebay)
xtor=SEC-identifier-SAL for Search Alliance
xtor=SEC-identifier-BDU for Baidu
xtor=SEC-identifier-NAV for Naver
D: group of advertisements (using the format [label] or id[label]).
E: advertisement variant (using the format [label] or id[label]). By entering [{creative}] into Google, Google will replace [{creative}] with a unique ID variant [{ID}] meaning that the creative can be linked to results as data is being imported from Google.
F: “S” or “C” depending on the origin of the search result (“S” for “Search”) or advertisements on the content networks (“C” for “Content”).
With Google, you can write the exact code: "{ifContent:C}{ifSearch:S}", which allows you to have variable F of the xtor.
With Yahoo Search Marketing, you can use the following code: "{YSMMTC:S:S:C}".
G: exact keyword purchased. By entering the exact [{keyword}] for a campaign in Google, Google will automatically place the exact purchased keyword in its search engine (this may differ slightly from the keyword entered). The principle is similar for Yahoo, where [{YSMKEY}] is used.
Example:
xtor=SEC-300-GOO-[group_1]-[Var_1]-{ifContent:C}{ifSearch:S}-[{keyword}]&xts=1111111
Or
xtor=SEC-24-YSM-[group_1]-[Var_1]-{YSMMTC:S:S:C}-[{YSMKEY}]&xts=1111111
* 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[creation]
and 23[creations]), only the first name will be kept and associated with
the ID.
* The E variant depends on advertising group D. E will not be taken into
consideration should there be an error in D or should D be missing.
www.atinternet.com/support
© AT Internet - 2016 - All rights reserved