Digital Measurement Content Audit Beacon

2026-02-05T15:11:53Z

SurabhiGupta: striked hhid as it is not present in code

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|US DCR & DTVR }} {{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.
==Ping Structure==
Ping is executed with following convention:

<code>https://'''[to_be_provided]'''.imrworldwide.com/cgi-bin/gn?prd=audit&+'''[query parameters]'''</code>

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
*302: A redirect to another Nielsen domain, used for the purpose of generating a URL compatible with Nielsen streaming meters
=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
##Audit pings should be fired at the beginning and end of a stream. These will be referred to as the Audit Start Ping and the Audit End Ping
=Query Parameters=
{| class="wikitable"
!'''Parameter'''
!'''Description'''
!'''Required'''
!'''Specified'''
!'''Format / Example'''
|-
|apid
|Server App ID assigned by Nielsen
|Yes
|Nielsen
|Example: <code>A487421B-XXXX-YYYY-8343-E3BBB66E44F2</code>
|-
|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: <code>ce6c1c95-de3e-431e-b11e-77…</code>
|-
|streamid
|ID for every new instance of exposure to a different asset
|Yes
|Client
|Example: Random GUID: <code>ce6c1c95-de3e-431e-b11e-77…</code>
|-
|pingtype
|Indicator for ping type: "start" or "end" audit ping
|Yes
|Client
|Format: integer,
*<code>1</code> = Start Stream
*<code>0</code> = Start Session
*<code>3</code> = End Stream
*<code>2</code> = End Session
|-
|product
|Indicates which product audit ping corresponds to
|Yes
|Client
|Format: alphanumeric, Example: <code>dcr</code>, <code>dtvr</code>, <code>dar</code>, <code>ctv</code>
|-
|uoo
|User opt out flag for demographic measurement
|Yes, if devid/HHID provided
|Client
|Format: integer
*<code>0</code> = not opt-out
*<code>1</code> = opt-out
|-
|devid
|Mobile Ad ID (IDFA, ADID), Connected Device ID
|Optional, or in S2S file
|Client
|Only for Start Mobile Ping. User for demo assignment. Required, if no other interoperable id match exists for the integration
Example:<code>A487421B-XXXX-YYYY-8343-E3BBB66E44F2</code>
|-
|<s>hhid</s>
|<s>House Hold ID. Used as a primary match key to external data sources.</s>
|<s>Optional, or in S2S file.</s>
|<s>Client</s>
|<code><s>B0EOFEDgD</s></code>
|-
|createtm
|Time ping is initiated
|Yes
|Client
|Format: Unix timestamp in 32-bit unsigned int in seconds Example: <code>1577858505</code>
|}'''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>

'''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>

Digital Measurement Content Audit Beacon

2026-02-05T15:07:56Z

SurabhiGupta:

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|US DCR & DTVR }} {{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.
==Ping Structure==
Ping is executed with following convention:

<code>https://'''[to_be_provided]'''.imrworldwide.com/cgi-bin/gn?prd=audit&+'''[query parameters]'''</code>

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
*302: A redirect to another Nielsen domain, used for the purpose of generating a URL compatible with Nielsen streaming meters
=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
##Audit pings should be fired at the beginning and end of a stream. These will be referred to as the Audit Start Ping and the Audit End Ping
=Query Parameters=
{| class="wikitable"
!'''Parameter'''
!'''Description'''
!'''Required'''
!'''Specified'''
!'''Format / Example'''
|-
|apid
|Server App ID assigned by Nielsen
|Yes
|Nielsen
|Example: <code>A487421B-XXXX-YYYY-8343-E3BBB66E44F2</code>
|-
|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: <code>ce6c1c95-de3e-431e-b11e-77…</code>
|-
|streamid
|ID for every new instance of exposure to a different asset
|Yes
|Client
|Example: Random GUID: <code>ce6c1c95-de3e-431e-b11e-77…</code>
|-
|pingtype
|Indicator for ping type: "start" or "end" audit ping
|Yes
|Client
|Format: integer,
*<code>1</code> = Start Stream
*<code>0</code> = Start Session
*<code>3</code> = End Stream
*<code>2</code> = End Session
|-
|product
|Indicates which product audit ping corresponds to
|Yes
|Client
|Format: alphanumeric, Example: <code>dcr</code>, <code>dtvr</code>, <code>dar</code>, <code>ctv</code>
|-
|uoo
|User opt out flag for demographic measurement
|Yes, if devid/HHID provided
|Client
|Format: integer
*<code>0</code> = not opt-out
*<code>1</code> = opt-out
|-
|devid
|Mobile Ad ID (IDFA, ADID), Connected Device ID
|Optional, or in S2S file
|Client
|Only for Start Mobile Ping. User for demo assignment. Required, if no other interoperable id match exists for the integration
Example:<code>A487421B-XXXX-YYYY-8343-E3BBB66E44F2</code>
|-
|hhid
|House Hold ID. Used as a primary match key to external data sources.
|Optional, or in S2S file.
|Client
|<code>B0EOFEDgD</code>
|-
|createtm
|Time ping is initiated
|Yes
|Client
|Format: Unix timestamp in 32-bit unsigned int in seconds Example: <code>1577858505</code>
|}'''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>

'''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>

Engineering Client Portal - User contributions [en]

Digital Measurement Content Audit Beacon

Digital Measurement Content Audit Beacon