Wi-Fi audience sensor (trackerboard-http-responder)

trackerboard-http-responder is a small Windows utility that reads audience data from a Trackerboard Wi-Fi sensor and republishes it over HTTP. The player polls this HTTP endpoint during ad playback to record OTS values — see Audience Measurement (OTS) for how OTS policies are configured in the CMS.

The utility is distributed as a ZIP archive. Contact CS Play support to receive it.

Installation

  1. Unpack the archive to a folder whose path contains no Cyrillic characters (for example, C:\trackerboard).

  2. Open run-trackerboard-responder.bat in a text editor and adjust the launch arguments (see below).

Launch arguments

trackerboard-http-responder.exe -m ip -i <sensor-address> -r 5
Argument Meaning

-m ip

Connection mode: the sensor is reached over the network by IP address.

-i <address>

IP address of the Wi-Fi sensor.

-r <number>

Number of radio channels the sensor scans.

Autostart

To launch the responder automatically when Windows starts:

  1. Press kbd:[Win+R], type shell:startup and press kbd:[Enter] — the Startup folder opens.

  2. Copy a shortcut to run-trackerboard-responder.bat into this folder.

  3. In the shortcut properties, set Run to Minimized so the console window does not stay on the screen.

Connecting to the CMS

Once the responder is running, its HTTP endpoint (port 8000) serves the audience data. Use this URL in the Url to get OTS field of the OTS policy, for example:

http://<responder-address>:8000/api/v1/online&{frameId}

where the IP address is the machine running trackerboard-http-responder. See Configuring OTS Collection for the policy fields.