Danish Internet Project
Danish Internet Project
General Info for this Page
This page is work in progress. Any critical changes to the page will be communicated directly by Kantar Gallup DK.
You may find here all the information (documents, scripts and libraries) for your measurement project.
Content
Project Overview
Current Project Status
For more information on the current project status and schedule, please contact Kantar Gallup Denmark, Copenhagen.
Project Teams and Resources
The Danish project team is led by Kantar Gallup in Copenhagen. Our technology specialists from Kantar Media Spring, Germany, will assist with your technical queries as you begin and progress each player/platform implementation.
Before you start your implementation we will discuss with you and your teams which of our libraries you should use and be available to answer queries arising from your review of our documentation and testing framework.
We will be directly involved in the sign-off process for your implementation, undertaking a review of the data we receive from your implementation once on a staging environment.
Who do I contact and when?
General Queries
Please contact us at the following address:
Project Owners
Please contact our Danish Project Development Director Birgitte Hog.
Development Teams prior to your Implementation Sprint
Please contact our Danish Project Development Director Birgitte Hog
Developer Queries
Please contact our Danish Project Development Director Birgitte Hog and DE Technical Project Support KA_DE_support@kantarmedia.com.
People
| Function | |
Birgitte Hog | Project Development Director Kantar Gallup Rådhuspladsen 45 | |
Anders Riisberg (IAM) | Senior Project Manager | Anders.Riisberg@tns-gallup.dk |
Technical Project Manager | ||
Customer Support | Am Saaraltarm 1 |
More about us
spring is a technology-oriented company located in Saarlouis, Germany. It was founded as a spin-off of the renowned German Research Center for Artificial Intelligence (DFKI), Saarbrücken.
Realizing as early as 1995 that the ever-growing global importance of web-based information dissemination and product marketing would require more and more sophisticated solutions for measuring online audiences,
spring began to develop an integrated technology for measuring usage data, estimation algorithms, projection methodologies and reporting tools which soon began to draw the attention of innovative corporations
and national Joint Industry Committees.
Partnering with JICs, spring’s technology for collecting and measuring usage data is now well-tried and tested and has helped to define the standard for audience reach measurement of advertising media in Norway, Finland, Baltic States, Germany, Switzerland, Romania and many other countries as well as to a number of broadcasters, publishers and telecommunication companies.
In 2011, spring became a wholly-owned subsidiary of Kantar Media, a global industry leader in audience measurement for TV, radio and the web.
Today, spring is one of the leading pan-European companies in site-centric and user-centric Internet measurement, online research and analysis.
Audience Measurement (IAM)
Documentation to implement the Audience Measurement Tag
Audience Tagging Instructions (English Version)
Important:
The variable site <s> is individual and is communicated by Denmark.
Java Script
- kantarmedia-tagging-js-tns-dk-1.9.4 (New 04.12.2020)
Tool for No-script Version
Streaming Measurement (VAM)
Documentation to implement the Streaming Tag
Important:
The variable <site> is individual and is communicated by Denmark.
Java Script/Flash Libraries
- Streaming Library Java Script: kantarmedia-streaming-js-tns.dk-2.5.7.zip (New 12.07.2021)
( NOTE: First unified Java Script release for browser, TVML/TVJS (Apple TV), TAL (Smart-TV) and WebMAF (Playstation))
- Library for Flash Action Script 3: spring-streaming-as3-tns.dk-1.5.0.zip (09.04.2015)
- Library for OSMF: streaming-tns-dk-1.0.1.zip (05.10.2016)
Mobile App Streaming Libraries
- Library for iOS: kantarmedia-streaming-iOS-tns-dk-1.13.0.zip (08.11.2021)
- Library for Android: kantarmedia-streaming-android-tns-dk-1.8.1.zip (20.10.2021)
Apple TV 4th Generation Streaming Library
- Library for tvOS: kantarmedia-streaming-tvOS-tns-dk-1.13.0.zip (09.11.2021)
Xbox Streaming Library
- Library for xBox: kantarmedia-streaming-xbox-tns-dk-1.2.0.zip (15.07.2021)
Desktop Player Streaming Measurement Implementations
For desktop player implementations, you will need to observe the log stream data and verify the content of the heartbeats.
You do this by running a simple analysis of the http-requests sent from and to a browser whilst your webplayer is operating.
There are NO warnings or error messages produced using this method, it is a simple tracking of the HTTP-requests sent to the Kantar Media Spring measurement systems.
You can observe an example of a correct webplayer implementation using an HTTP-analyser such as the "developer tools" in Chrome/Internet Explorer or "HttpFox" plugin in Firefox.
Step-by-step Instructions for running an HTTP-Request-Analyser
- On a standard laptop / desktop device → Open the browser
- Using Chrome: Press ”CTRL+SHIFT+i”. This will bring the information screen along the bottom of the browser screen
(On other browser, you might need specific plug-ins. For example FoxyProxy on Firefox browser or use Proxy tools like https://www.charlesproxy.com) - The info screen contains several tabs across the page, but the one that matters is “network”. Select “network”
- In the main browser window → Open the player being tested, i.e. your web player
- As soon as you load the web page, you will notice a stream of events occurring in the information screen along the bottom of the screen
- Click in the information screen to make sure it has focus, now click on the filter icon.
This will allow you to enter a value in the search box - Enter “tns-cs.net” (= the receiving server) and click the option “filter”.
You will now see only the requests going and coming to and from the streaming project systems - If you return focus to the player you can now test the various functions (pause, rewind, fast forward etc.)
and watch the results in the HTTP-request data scrolling along the information screen - This data is NOT captured automatically so you MUST copy and paste ALL HTTP-requests after the test has been completed;
this data should be shared with us in order for the implementation to be signed off.
Heartbeats sent from the Libraries
This section briefly explains what the heartbeats sent from the libraries should look like. A concrete example of a viewing session is used.
Content Stream is started and the first Request transmitted
Please use the record layout descriptions below for reference.
Variable | Description |
---|---|
counting domain | "tns-cs.net" = Norwegian counting domain e.g. “sitename” = “example" see here |
pl | player = own player name (set by the broadcaster) |
plv | player version = own player version (set by the broadcaster) |
sx | width of the stream window |
sy | height of the stream window |
stream | stream name (set by the broadcaster) |
cq | content-ID = broadcaster's content ID |
uid | unique Id of the view sequence |
pst | play state = list of viewing intervals on the stream |
dur | stream length in seconds (set by the broadcaster) |
vt | view time in seconds (time of visual contact with the stream) |
First Request Statement
The actual record output should look similar to below:
First play state: 0+0+mbeswh
http://example.tns-cs.net/j0=,,,pl=jwplayer+plv=version1+sx=640+sy=517;+,stream=od+cq=123456789+uid=3f3tv5p+pst=,,0+0+mbeswh;+,1+1+mbeswj;;+dur=1501+vt=2;;;
After Viewing 2 min of the Stream
The output records should look similar to the records below, note the time of the “heartbeat” records = play states records at 21, 41, 61,.... seconds
http://example.tns-cs.net/j0=,,,pl=jwplayer+plv=version1+sx=640+sy=517;+,stream=od+cq=123456789+uid=3f3tv5p+pst=,,0+0+mbeswh;+,1+21+mbeswj;;+dur=1501+vt=22;;; http://example.tns-cs.net/j0=,,,pl=jwplayer+plv=version1+sx=640+sy=517;+,stream=od+cq=123456789+uid=3f3tv5p+pst=,,0+0+mbeswh;+,1+41+mbeswj;;+dur=1501+vt=42;;; http://example.tns-cs.net/j0=,,,pl=jwplayer+plv=version1+sx=640+sy=517;+,stream=od+cq=123456789+uid=3f3tv5p+pst=,,0+0+mbeswh;+,1+61+mbeswj;;+dur=1501+vt=62;;; http://example.tns-cs.net/j0=,,,pl=jwplayer+plv=version1+sx=640+sy=517;+,stream=od+cq=123456789+uid=3f3tv5p+pst=,,0+0+mbeswh;+,1+83+mbeswj;;+dur=1501+vt=84;;; http://example.tns-cs.net/j0=,,,pl=jwplayer+plv=version1+sx=640+sy=517;+,stream=od+cq=123456789+uid=3f3tv5p+pst=,,0+0+mbeswh;+,1+105+mbeswj;;+dur=1501+vt=106;;;
Stopping the Stream after 2:00 min
Last play state: 1+120+mbeswj = 120 sec playtime.
http://example.tns-cs.net/j0=,,,pl=jwplayer+plv=version1+sx=640+sy=517;+,stream=od+uid=3f3tv5p+pst=,,0+0+mbeswh;+,1+120+mbeswj;;+dur=1501+vt=124;;;
- Note that the "uid" (uid=3f3tv5p) and stream name "stream" (stream=od) remained the same during the whole view sequence.
This should always be the case when the implementation is correct. - If the "uid" or "stream" (=stream name) changes during the observed view sequence, there is something wrong with the implementation
and as a consequence more than one stream view is being counted for this single view sequence. - The above example is a generic one.
- For the streaming project by continuously viewing a stream you should be seeing heartbeats sent out at 0,1,20,40,60,80,100,120,.. seconds.
There may be 1 or 2 seconds added to every heartbeat due to internal workings of the library.
Mobile Website Measurement (IAM)
Documentation to implement the Mobile Site Measurement
Mobile Tagging Instructions (English Version)
Important:
The variable site <s> is individual and is communicated by Denmark.
Mobile Application Measurement (IAM)
Documentation to implement the Mobile Application Measurement
Mobile App Sensor Documentation (English Version)
Important:
The variable <site> is mandatory for the mobile app sensor and must be specified by Denmark.The variable <application> may NOT be selected and will be notified by Denmark individually.
Link to the Mobile Application Test Tool
Documentation to the Mobile Application Test Tool
Mobile App Sensor Libraries
iOS
- kantarmedia-tagging-iOS-tns-dk-1.15.0.zip (09.11.2021)
Android
- kantarmedia-tagging-android-tns-dk-1.11.0.zip (21.04.2021)