Digital Measurement Content Relayed Audit Beacon: Difference between revisions
From Engineering Client Portal
No edit summary |
|||
(4 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Digital Streaming Measurement}} {{CurrentBreadcrumb}} | {{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Digital Streaming Measurement S2S CR}} {{CurrentBreadcrumb}} | ||
The Nielsen server-to-server solution requires audit pings for the purpose of validating audience reach and video viewing duration; one start and one end for each video stream. Pings originate from the end-user device to Nielsen Collections servers. End pings execute upon cessation of playback. | The Nielsen server-to-server solution requires audit pings for the purpose of validating audience reach and video viewing duration; one start and one end for each video stream. Pings originate from the end-user device to Nielsen Collections servers. End pings execute upon cessation of playback. | ||
Line 32: | Line 32: | ||
#'''S2S Audit Ping relay from client-server to Nielsen server''' with furnished URL parameters outlined below. Example: <code><nowiki>https://audit.imrworldwide.com/cgi-bin/gn?prd=audit&intid=xp3clqou0dzb1u4jq2jecoyvza&appid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&product=dar&createtm=1643858542</nowiki></code> | #'''S2S Audit Ping relay from client-server to Nielsen server''' with furnished URL parameters outlined below. Example: <code><nowiki>https://audit.imrworldwide.com/cgi-bin/gn?prd=audit&intid=xp3clqou0dzb1u4jq2jecoyvza&appid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&product=dar&createtm=1643858542</nowiki></code> | ||
= | |||
[[File:stdvss2saudit.png]] | |||
= Furnished S2S Audit Ping Proxy Parameters = | |||
{| class="wikitable" | {| class="wikitable" | ||
!'''Parameter''' | !'''Parameter''' | ||
Line 73: | Line 76: | ||
Format: alphanumeric, | Format: alphanumeric, | ||
Example: <code>dcr</code>, <code>dtvr</code>, <code>dar</code>, <code>ctv</code> | Example: <code>dcr</code>, <code>dtvr</code>, <code>dar</code>, <code>ctv</code> | ||
|- | |- | ||
|createtm | |createtm | ||
Line 105: | Line 87: | ||
'''Audit Ping Start Example:''' | '''Audit Ping Start Example:''' | ||
<code>https://secure-audit.imrworldwide.com/cgi-bin/gn?prd=audit&apid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&streamid=3679422587354472&pingtype=0&product=ctv&uoo=1&createtm=1577858505&devid=4AB6FCE2-2848-4FA8-9BE3-46E206206AB</code> | <code><nowiki>https://secure-audit.imrworldwide.com/cgi-bin/gn?prd=audit&apid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&streamid=3679422587354472&pingtype=0&product=ctv&uoo=1&createtm=1577858505&devid=4AB6FCE2-2848-4FA8-9BE3-46E206206AB</nowiki></code> | ||
'''Audit Ping End Example:''' | '''Audit Ping End Example:''' | ||
<code>https://secure-audit.imrworldwide.com/cgi-bin/gn?prd=audit&apid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&streamid=3679422587354472&pingtype=2&product=ctv&uoo=1&createtm=1577859637</code> | <code><nowiki>https://secure-audit.imrworldwide.com/cgi-bin/gn?prd=audit&apid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&streamid=3679422587354472&pingtype=2&product=ctv&uoo=1&createtm=1577859637</nowiki></code> | ||
[[Category:Digital]] | [[Category:Digital]] |
Latest revision as of 13:07, 11 September 2024
The Nielsen server-to-server solution requires audit pings for the purpose of validating audience reach and video viewing duration; one start and one end for each video stream. Pings originate from the end-user device to Nielsen Collections servers. End pings execute upon cessation of playback.
Ping Structure
Ping is executed with following convention:
https://[to_be_provided].imrworldwide.com/cgi-bin/gn?prd=audit&+[query parameters]
The Start Audit Ping carries all parameters in the table below. The End Audit Ping carries a subset of the parameters in the matrix below as denoted in the mandatory column.
Under normal operating circumstances, the audit ping server returns the following codes:
- Audit ping servers reject cross-origin HTTP requests with preflight. To ensure that audit ping requests are accepted, allowable Content-Types like "text/plain" in simple GET requests ensure that preflight requests are not invoked
- 200: Ping successfully received, inspect traffic to ensure no CORS errors
Session & Stream
- Sessions
- Optionally, a new Session ID may be created when a new player is created
- If more than one video player exists within the same App (e.g. picture in picture) a different Session ID is required for each
- Streams
- New Stream ID is generated for each new video stream.
- If stream playback continues after 24 hours, then a new Stream ID should be created and a new Audit ping should be executed (Session ID may remain)
- Stream ID remains the same independent of fast-forward, rewind, pause, events assuming the asset remains the same
- If playback is suspended for greater than 30mins (paused or otherwise suspended), a new Stream ID should be assigned upon return
- Audit pings should be fired at the beginning and end of a stream
Two-part Audit Ping design requires:
- End-user-device-initiated ping with client-owned root domain and SessionID included in subdomain. Nielsen meters are trained to regex for a unique domain format. Example:
https://2576459933726989.darnuid.[publisher-domain].com
- S2S Audit Ping relay from client-server to Nielsen server with furnished URL parameters outlined below. Example:
https://audit.imrworldwide.com/cgi-bin/gn?prd=audit&intid=xp3clqou0dzb1u4jq2jecoyvza&appid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&product=dar&createtm=1643858542
Furnished S2S Audit Ping Proxy Parameters
Parameter | Description | Required | Specified | Format / Example |
---|---|---|---|---|
apid | Server App ID assigned by Nielsen | Yes | Nielsen |
Example: |
sessionid | Unique, client generated value that represents the start of a user session. “Session” is defined as continuous (flexible) interaction with an application that may span multiple streams. | Yes | Client |
Format: alphanumeric
Example: Random GUID: |
pingtype | Indicator for ping type: "start" or "end" audit ping | Yes | Client |
Format: integer,
|
product | Indicates which product audit ping corresponds to | Yes | Client |
Format: alphanumeric,
Example: |
createtm | Time ping is initiated | Yes | Client |
Format: Unix timestamp in 32-bit unsigned int in seconds
Example: |
Audit Ping Start Example:
https://secure-audit.imrworldwide.com/cgi-bin/gn?prd=audit&apid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&streamid=3679422587354472&pingtype=0&product=ctv&uoo=1&createtm=1577858505&devid=4AB6FCE2-2848-4FA8-9BE3-46E206206AB
Audit Ping End Example:
https://secure-audit.imrworldwide.com/cgi-bin/gn?prd=audit&apid=FC984EC1-E044-B465-E040-070AAD3173A1&sessionid=2576459933726989&streamid=3679422587354472&pingtype=2&product=ctv&uoo=1&createtm=1577859637