...
Variable | Mandatory | Macro | FreeWheel Macro | Description | Comments |
|---|---|---|---|---|---|
| site |  | hardcoded | The site name for the url. The site name will be specified by Kantar Media spring and will be communicated to each Ad server provider. | ||
| event | | hardcoded | This variable must contain one of the following strings
| ||
| stream | | hardcoded | This variable contains always the fixed string
| ||
| mobid |
| macro_1 | #e{request.deviceId} | Apple or Google IDFA in cleartext. Structure is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. We expect this variable to be filled in the case of an Apple or Android device. In other environments, we expect this to be empty. | We do not believe it is really needed to url-encode the IDFA since it should be hexadecimal already. The encoding is "just in case", so it can never break the tracking-URL structure. |
| clockid | | macro_2 | #e{ad.externalId} | Commercial UK-wide unique ID. Example: AGY/COKY123/030. The last 3 digits are the duration of the clip in seconds. | We do not believe it is really needed to url-encode the ClockID since it should be alphanumeric already. The encoding is "just in case", so it can never break the tracking-URL structure. |
| pl | | macro_3 | ? | The player name. | |
| plv | | macro_4 | ? | The player version. | |
| login |  | macro_5 | ? | This is a unique identifier assigned by the broadcaster app to identify the user. This will have different formats for different broadcaster apps. It is also available in the TVPR-data in the same variable. | |
| uid | | macro_6 | #{request.videoRandom} qqqqqqqqqqqqqqqqqqqq | Kantar’s own specification is a random number in base36 encoding.
| |
| app |
| macro_7 | ? | The app name if in the case that it is an Apple or Android device. We expect this variable to be only set when it is an Apple or Android device. It is also possible to set some other value, f.e. a string indicating the platform. | Kantar uses this variable to determine if the request should be treated as mobile or stationary. If this is impossible to deliver according to the description (i.e. empty for non-mobile), then it is also possible for Kantar to look for the mobid instead. |
Resulting Tracking URL's
| Event | Tracking URL's |
|---|---|
| start | https://ssl-sitename.2cnt.net/j0=,,,;+,event=start+stream=ad-vast+mobid=#e{request.deviceId}+cq=#e{ad.externalId}+pl=+plv=+login=+uid=#{request.videoRandom}+app=;;; |
| firstQuartile | https://ssl-sitename.2cnt.net/j0=,,,;+,event=firstQuartile+stream=ad-vast+mobid=#e{request.deviceId}+cq=#e{ad.externalId}+pl=+plv=+login=+uid=#{request.videoRandom}+app=;;; |
| midpoint | https://ssl-sitename.2cnt.net/j0=,,,;+,event=midpoint+stream=ad-vast+mobid=#e{request.deviceId}+cq=#e{ad.externalId}+pl=+plv=+login=+uid=#{request.videoRandom}+app=;;; |
| thirdQuartile | https://ssl-sitename.2cnt.net/j0=,,,;+,event=thirdQuartile+stream=ad-vast+mobid=#e{request.deviceId}+cq=#e{ad.externalId}+pl=+plv=+login=+uid=#{request.videoRandom}+app=;;; |
| complete | https://ssl-sitename.2cnt.net/j0=,,,;+,event=complete+stream=ad-vast+mobid=#e{request.deviceId}+cq=#e{ad.externalId}+pl=+plv=+login=+uid=#{request.videoRandom}+app=;;; |