Craft your hit

 

Base

All hits must be sent to a fixed collection address, composed of several items

InformationDescriptionRulesExampleComments
ProtocolType of protocolMust be equal to http or httpshttps
Collection logCollection server to which the site is linkedlogsA log is specific to a protocol
Collection domainDomain on which information is collectedCan be equal to .xiti.com or .ati-host.net.xiti.comA log is linked to a specific domain
ResourceResource to request on the serverMust be equal to hit.xitihit.xiti

Example:

All parameters will then be contained in the querystring of this GET request.

 

Global

Certain parameters must be present in all hits in order to ensure accurate tracking of information.

ParameterDescriptionRulesExampleRequired?Comments
colProtocol versionMust be equal to 1col=1Yes
fromMethod of hit generationMust be equal to pfrom=pYes
sSite numberMust correspond to the site on which the data should be counteds=123456Yes
idclientUnique visitor IDMust be unique for each visitoridclient=e5c728db-b510-41a3-9de5-117f0321bae4NoPrevents the placement of a third-party cookie
anIdentified visitor numerical IDMust be an integeran=1337Noan and at are exclusives : only one can be in a single hit. an has the priority
atIdentified visitor textual IDat=p250Noan and at are exclusives : only one can be in a single hit. an has the priority
acIdentified visitor category IDMust be an integerac=1No
dgDisplay size of the monitor ( for apps)Must be an integerdg=7No<2 : undefined
<7 : smartphone
>=7 : tablet
>=19 : smartTV

Example:

 

Page

For a page hit, three pieces of information are possible: its name, its chaptering (up to 3 levels) and its level 2.

The name and the chapter information are given in a p parameter in the following manner:
– if you want to include from one to three chapters, they should be written at the start of the string, separated by two colons (“::”) and the page name can be added at the end, after using this same separator. (We will therefore have the format ::::::).
– otherwise, we only indicate the name

If the p parameter is empty, the page URL will be shown as the page 's name

The level 2 is an ID that we indicate in the s2 parameter. The level 2 must be configured ahead of time in the interface in order to retrieve the corresponding ID.

ParametersDescriptionRestrictionsRequired?
p<chap1::chap2::chap3::name>250 characters max. No special characters.Yes
s2<level 2>Whole numberNo

Example:

Page view hit from the page page_baking, which belongs to the tree structure home > appliances > kitchen, and which belongs to the level 2 45:

 

Click

As with a page hit, the click has three pieces of information available: its name, its chaptering and its level 2, given in the same hit parameters p and s2.

However, the click parameter must also be filled out. It has four possible values:
– “N” for a navigational click
– “S” for an exit click
– “T” for a download
– “A” for an action

In this same hit, we can also give information about the page on which the action is taken, via the pclick and s2click parameters.

ParametersDescriptionRestrictionsRequired?
click“N”, “S”, “T” or “A”Yes
p<chap1::chap2::chap3::name>250 characters max. No special characters.Yes
s2<level 2>Whole numberNo
pclick<page name>250 characters max. No special characters.Non
s2click<page level 2>Whole numberNo

Example:

Download hit named notice2, with the tree structure home > appliances > kitchen, belonging to the level 2 45 and having been carried out on the page home > appliances > kitchen > page_baking which also belongs to the level 2 45:

 

Internal search engine

Two types of tagging should be distinguished: tagging of the search results page, and tagging of a click on a specific result.

 

Results page

In the case of tagging a results page, only the searched keyword and the pagination are in addition to the regular page tagging (see above).
The keyword is indicated in the mc variable and the pagination in np.

In the case of a search without results, the np parameter is filled with the value 0

ParametersDescriptionRestrictionsRequired?
mc<keyword>Character string without spacesYes
np<presults page>Whole number. 0 if no resultsYes

Example:

Results for the word “kitchen” and on the third page of results:

 

Results click

In the case of a click made on a results page, in addition to the two previous parameters, you’ll also need the position of the result in the variable mcrg and the click parameter will mandatorily be set to “IS”.

ParametersDescriptionRestrictionsRequired?
mc<keyword>Character string without spacesYes
np<results page>Whole numberYes
mcrg<position>Whole numberYes
clickISValue set to ISYes

Example:

A click on the 2nd place result, on the results page from the previous example:

 

Custom variables

Custom variables are linked to a page.
A page variable is entered in the f parameter, followed by its row number. A site variable will be entered in the x parameter, followed by its row number.

ParametersDescriptionRestrictionsRequired?
x<n><site variable>No
f<n><page variable>No

Textual custom variables must be valued between brackets x1=[my_text]

Example:

Two site variables: the number 1 with the value dentist and the number 3 with the value women.
Two page variables: the number 5 with the value chair and the number 2 with the value 5.

 

Custom tree structure

Custom tree structures let you declare a category tree structure of up to three levels. These three levels are all in the same parameter, “ptype“, represented by IDs separated by hyphens. This category tree structure must be set up in advance in the interface so that the corresponding IDs may be retrieved.

ParametersDescriptionRestrictionsRequired?
ptype<category ID 1>-<category ID 2>-<category ID 3>Yes

Example:

 

Aisles

You may have up to six levels of aisles. Each level has a numeric ID and a name.
Everything is entered in the “aisl” parameter in the following format:
– for an aisle, we enter the ID followed by its name in brackets [])
– to separate aisles, we use two colons (::::…::)

ParametersDescriptionRestrictionsRequired?
aisl<id1>[<name1>]::<id2>[<name2>]::…<id6>[<name6>]– the ID is a whole number
– the name is a character string
Yes

Example:

 

Rich Media

Rich Media measurement allows you to count playbacks, time spent as well as actions made on video or audio contents.
This measurement requires different actions, which are keys of the processing of metrics.

 

Media types

Here are the different media types available :

  • “video” : video measurement
  • “audio” : audio measurement
  • “vpre” : pre-roll video measurement
  • “vmid” : mid-roll video measurement
  • “vpost” : post-roll video measurement
 

Play

Action play is the most important, since it is mandatory for content measurement.
It must be the first measurement action sent.

ParametersDescriptionRestrictionsRequired?
actionAction“play”Yes
typeMedia type“video”, “audio”, “vpre”, “vmid” or “vpost”Yes
m6Broadcast type“clip” for a content a defined length, “live” for a live broadcastYes
m1Content durationIn secondsYes if m6=clip, No if m6=live
pContent labelCan be composed of 3 tree structure levels (themes), separate by ::Yes
s2Content level 2No
m5Broadcast location“int” if the content is played from your website, “ext” if the content is played from an external websiteYes
bufIs the content buffering“1” while buffering, “0” at the end of the bufferingNo
prichLabel of the page where the content is played (with tree structure)No
s2richLevel 2 of the page where the content is playedNo
plyrPlayer identifier. Useful in case there are multiple players on the same pageNo
clnkLabel of the linked content (with tree structure) in case of a pre/mid/post-roll contentYes if type=vpre/vmid/vpost
m9Broadcast domain, in case of an external broadcastYes if m5=ext
 

Refresh

Action refresh is used in order to indicate that the playback is still in progress.
This action is mandatory for accurate time spent analysis.

The maximum frequency for refresh is 1 hit every 5 seconds

ParametersDescriptionRestrictionsRequired?
actionAction“refresh”Yes
typeMedia type“video”, “audio”, “vpre”, “vmid” or “vpost”Yes
m6Broadcast type“clip” for a content a defined length, “live” for a live broadcastYes
m1Content durationIn secondsYes if m6=clip, No if m6=live
pContent labelCan be composed of 3 tree structure levels (themes), separate by ::Yes
s2Content level 2No
m5Broadcast location“int” if the content is played from your website, “ext” if the content is played from an external websiteYes
plyrPlayer identifier. Useful in case there are multiple players on the same pageNo
 

Pause

Action pause is used to indicate a pause in the playback.

ParametersDescriptionRestrictionsRequired?
actionAction“pause”Yes
typeMedia type“video”, “audio”, “vpre”, “vmid” or “vpost”Yes
m6Broadcast type“clip” for a content a defined length, “live” for a live broadcastYes
m1Content durationIn secondsYes if m6=clip, No if m6=live
pContent labelCan be composed of 3 tree structure levels (themes), separate by ::Yes
s2Content level 2No
m5Broadcast location“int” if the content is played from your website, “ext” if the content is played from an external websiteYes
plyrPlayer identifier. Useful in case there are multiple players on the same pageNo
 

Stop

Action stop is used to indicate the end of a playback.

ParametersDescriptionRestrictionsRequired?
actionAction“stop”Yes
typeMedia type“video”, “audio”, “vpre”, “vmid” or “vpost”Yes
m6Broadcast type“clip” for a content a defined length, “live” for a live broadcastYes
m1Content durationIn secondsYes if m6=clip, No if m6=live
pContent labelCan be composed of 3 tree structure levels (themes), separate by ::Yes
s2Content level 2No
m5Broadcast location“int” if the content is played from your website, “ext” if the content is played from an external websiteYes
plyrPlayer identifier. Useful in case there are multiple players on the same pageNo
 

Move

Action move is used to indicate a move in the playback.

ParametersDescriptionRestrictionsRequired?
actionAction“move”Yes
typeMedia type“video”, “audio”, “vpre”, “vmid” or “vpost”Yes
m6Broadcast type“clip” for a content a defined length, “live” for a live broadcastYes
m1Content durationIn secondsYes if m6=clip, No if m6=live
pContent labelCan be composed of 3 tree structure levels (themes), separate by ::Yes
s2Content level 2No
m5Broadcast location“int” if the content is played from your website, “ext” if the content is played from an external websiteYes
plyrPlayer identifier. Useful in case there are multiple players on the same pageNo
 

Custom object

You can fill a custom object, JSON and encoded accordingly, in order to process the data in Data Manager.

ParametersDescriptionRestrictionsRequired?
stcJSON object, encoded accordinglyYes

Example:

Last update: 09/10/2019