Android SDK Release Notes

AmySockanathan — Thu, 23 Jul 2026 20:08:18 GMT

Release notes for 10.2.1

← Older revision		Revision as of 20:08, 23 July 2026
Line 3:		Line 3:

	{{Breadcrumb\|}} {{Breadcrumb\|Digital Downloads}} {{CurrentBreadcrumb}}		{{Breadcrumb\|}} {{Breadcrumb\|Digital Downloads}} {{CurrentBreadcrumb}}
			== Release 10.2.1.0 (07-24-2026) ==
			*Address the exception due to setExpedited() in WorkManager in AndroidOS < 12.

	== Release 10.2.0.0 (03-24-2026) ==		== Release 10.2.0.0 (03-24-2026) ==
	*[[Mitigation of Android 15 background]] network access restrictions.		*[[Mitigation of Android 15 background]] network access restrictions.

DCR Germany Video S2S

MichelFodjo — Wed, 22 Jul 2026 15:29:15 GMT

Description

← Older revision		Revision as of 15:29, 22 July 2026
(17 intermediate revisions by the same user not shown)
Line 44:		Line 44:
	** The Asset Viewing file		** The Asset Viewing file
	* '''The Asset Metadata file should arrive before the Asset Viewing file for the same hour.'''		* '''The Asset Metadata file should arrive before the Asset Viewing file for the same hour.'''
	* In the case of a stream that has one version with blackouts and one without, one with		* In the case of a stream that has one version with blackouts and one without, one with mobile and one non-mobile, each stream would have its own unique asset id.
	mobile and one non-mobile, each stream would have its own unique asset id.

	==SLA==		==SLA==
Line 56:		Line 55:
	The 4 files must be delivered into the proper S3 bucket '''immediately after each hour of viewing on a device''', but '''latest within 3 hours of the start of that hourly viewing file interval'''. For example, files from '''2:00 AM to 3:00 AM''' must be delivered latest before '''5 AM'''.		The 4 files must be delivered into the proper S3 bucket '''immediately after each hour of viewing on a device''', but '''latest within 3 hours of the start of that hourly viewing file interval'''. For example, files from '''2:00 AM to 3:00 AM''' must be delivered latest before '''5 AM'''.

	'''When SLA for receiving the 4 files for date xx/xx, UTC hour xx has expired. The system will continue to wait for 60 min, after which it will skip the missing file and continue processing subsequent files.
	'''<pre style="color: red">NOTE:</pre>'''		'''<pre style="color: red">NOTE:</pre>'''
	* <pre style="color: red">Any files that missed the SLA will not be processed and hence not included in the measurement data delivered to AGF.</pre>		* <pre style="color: red">Any files that missed the SLA will not be processed and hence not included in the measurement data delivered to AGF.</pre>
Line 335:		Line 333:
	===Asset Metadata Delivery Optimization===		===Asset Metadata Delivery Optimization===

	* '''Optimization per platform''' when the Asset Metadata File remains unchanged per platform during the whole day		* '''Option 1: Optimization per platform''' when the Asset Metadata File remains unchanged per platform during the whole day
	* '''Optimization for all platforms''' when the Asset Metadata File remains unchanged for all platforms during the whole day		* '''Option 2: Optimization for all platforms''' when the Asset Metadata File remains unchanged for all platforms during the whole day

	'''The first hour of the day''' used in the following description of the optimization refers to '''03:00:00 AM to 03:59:59 AM German local time''' (01:00:00 AM to 01:59:59 AM UTC during daylight saving time; 02:00:00 AM to 02:59:59 AM UTC during standard time).		'''The first hour of the day''' used in the following description of the optimization refers to '''03:00:00 AM to 03:59:59 AM German local time''' (01:00:00 AM to 01:59:59 AM UTC during daylight saving time; 02:00:00 AM to 02:59:59 AM UTC during standard time).

	====Optimization when the Asset Metadata File remains unchanged during the whole day per platform====		====Option 1: Optimization when the Asset Metadata File remains unchanged during the whole day per platform====

	When the Asset Metadata File remains unchanged during the whole day per platform, the hourly manifest File of the Asset Metadata File can be used to link to the Asset Metadata File Location per platform.		When the Asset Metadata File remains unchanged during the whole day per platform, the hourly manifest File of the Asset Metadata File can be used to link to the Asset Metadata File Location per platform.
Line 414:		Line 412:
	</code>		</code>

	====Optimization for all Platforms when the Asset Metadata File remains unchanged for all platforms during the whole day====		====Option 2: Optimization for all Platforms when the Asset Metadata File remains unchanged for all platforms during the whole day====

	When the Asset Metadata File remains unchanged for all platforms during the whole day, the hourly manifest File of the Asset Metadata File can be used to link to the Asset Metadata File Location for all platforms.		When the Asset Metadata File remains unchanged for all platforms during the whole day, the hourly manifest File of the Asset Metadata File can be used to link to the Asset Metadata File Location for all platforms.
Line 527:		Line 525:
	* '''For the correct filling of the metadata fields and custom variables, please make sure to follow the detailed information and specifications regarding the permitted characters and formats, field length and other limitations in the AGF metadata convention for video measurement, see:'''		* '''For the correct filling of the metadata fields and custom variables, please make sure to follow the detailed information and specifications regarding the permitted characters and formats, field length and other limitations in the AGF metadata convention for video measurement, see:'''
	** '''[[AGF Metadata Convention#Video Measurement\|AGF Metadata Convention for Video Measurement]]'''		** '''[[AGF Metadata Convention#Video Measurement\|AGF Metadata Convention for Video Measurement]]'''
			* The metadata reported in the AGF measurement data for a given assetid (including episode title, duration, and custom variables nol_c0–nol_c19) is locked in by the first video request of the day and its corresponding hourly metadata file. Subsequent metadata changes during the day will be ignored.

	{\| class="wikitable"		{\| class="wikitable"
Line 558:		Line 556:
	✓		✓
	\|-		\|-
	\| subbrand \|\| subbrand (vcid) \|\| vcid/sub-brand/Channel ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App)		\| subbrand \|\| subbrand (vcid)
			\|\|
			'''Use only if the asset metadata file optimization is not used and is delivered per platform with this subbrand value'''

			vcid/sub-brand/Channel ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App)
	\|\|		\|\|
	provided by Nielsen		provided by Nielsen
Line 588:		Line 590:
	\|\|		\|\|
	* Valid from January 1, 2027		* Valid from January 1, 2027
	* The custom variable ‘Genre’ contains genre information. To be populated in consultation with AGF. ~~For Ad, the field remains blank "".~~		* The custom variable ‘Genre’ contains genre information. To be populated in consultation with AGF.
	\|\|		\|\|
	\|-s		\|-s
Line 596:		Line 598:
	\|\|		\|\|
	* Valid from January 1, 2027		* Valid from January 1, 2027
	* The custom variable ‘Product ID’ contains a unique ID across all formats (streaming and TV) that uniquely identifies a product (e.g. an individual episode of a series, a feature film) per provider. ~~For ads, the field remains blank "".~~		* The custom variable ‘Product ID’ contains a unique ID across all formats (streaming and TV) that uniquely identifies a product (e.g. an individual episode of a series, a feature film) per provider.
	\|\|		\|\|
	\|-		\|-
Line 679:		Line 681:
	\| sessionid \|\| Unique, client generated value that represents the start of a user session. Must match sessionid in Audit Ping. \|\| created using the UUID Generator code provided \|\| ✓		\| sessionid \|\| Unique, client generated value that represents the start of a user session. Must match sessionid in Audit Ping. \|\| created using the UUID Generator code provided \|\| ✓
	\|-		\|-
	\| streamid \|\| streamid ID for every new instance of an asset \|\| created using the UUID Generator code provided \|\| ✓		\| streamid \|\| streamid ID for every new instance of an asset. Must match streamid in Audit Ping. \|\| created using the UUID Generator code provided \|\| ✓
	\|-		\|-
	\| streamended \|\| Stream is known to have ended in this file \|\|		\| streamended \|\| Stream is known to have ended in this file \|\|
Line 716:		Line 718:
	\|\|		\|\|

	'''Ue only if the asset metadata file is optimized and delivered once for all platforms and subbrand is not included in the asset metadata file.'''		'''Use only if the asset metadata file is optimized and delivered once for all platforms and subbrand is not included in the asset metadata file.'''

	vcid/sub-brand/Channel ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App)		vcid/sub-brand/Channel ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App)
Line 825:		Line 827:

	=== Introduction ===		=== Introduction ===
	The Nielsen server to server solution needs audit pings to validate audience ~~reach and video viewing duration~~, one '''start''' and one '''end''' for each video stream playback. These pings will go from the end user device to Nielsen Collections servers.		The Nielsen server to server solution needs audit pings to validate audience usage, one '''start''' and one '''end''' for each video stream playback. These pings will go from the end user device to Nielsen Collections servers.
	* '''<pre style="color: red">NOTE:</pre> '''		* '''<pre style="color: red">NOTE:</pre> '''
	** '''If Nielsen does not receive the Audit pings, the viewing data cannot be enriched (with device details and country) and will ~~not~~ be ~~included in the~~ measurement ~~data delivered to AGF~~.'''		** '''If Nielsen does not receive the Audit pings, the viewing data cannot be enriched (with device details and country) and will be excluded from AGF's reach measurement.'''


Line 834:		Line 836:
	* Also a new start audit ping is sent when the stream playback resumes after a playback interruption for more than 30 minutes, typically playback paused. PLEASE note that a new “streamid” parameter has to be created before sending a new start audit ping.		* Also a new start audit ping is sent when the stream playback resumes after a playback interruption for more than 30 minutes, typically playback paused. PLEASE note that a new “streamid” parameter has to be created before sending a new start audit ping.
	'''end audit ping (“Endstream = 3”)'''		'''end audit ping (“Endstream = 3”)'''
	* An end audit ping is sent when the stream ends(either playback completed or switch to another stream).		* An end audit ping is sent when the stream ends (either playback completed or switch to another stream).
	* Also an end audit ping is sent when the stream playback after a playback interruption for more than 30 minutes, typically playback paused.		* Also an end audit ping is sent when the stream playback after a playback interruption for more than 30 minutes, typically playback paused.

Line 862:		Line 864:
	* c) If one person watches a show, and FF, rewind, playout, pause, play, RW, play - they would keep the same stream id (“streamid”) throughout the entire playout of that video asset (stream).		* c) If one person watches a show, and FF, rewind, playout, pause, play, RW, play - they would keep the same stream id (“streamid”) throughout the entire playout of that video asset (stream).
	* d) If a stream play out is suspended for 30 mins or more (paused or background):		* d) If a stream play out is suspended for 30 mins or more (paused or background):
	** An end audit ping (“Endstream = 3”) is sent when the stream playback ~~after a playback interruption~~ for more than 30 minutes, typically playback paused.		** An end audit ping (“Endstream = 3”) is sent when the stream playback is interrupted for more than 30 minutes, typically playback paused.
	** A new start audit ping(“Startstream = 1”) is sent when the stream playback resumes after a playback interruption for more than 30 minutes, typically playback paused. PLEASE note that a new “streamid” parameter has to be created before sending a new start audit ping.		** A new start audit ping (“Startstream = 1”) is sent when the stream playback resumes after a playback interruption for more than 30 minutes, typically playback paused. PLEASE note that a new “streamid” parameter has to be created before sending a new start audit ping.
	* e) If the user reaches the very end of the stream (content complete), and then starts to play again (replay from anywhere in the stream), then a new “streamid” should be created and a start audit ping should be sent. Also an end audit should be sent when the stream replay is completed or the user switches to another stream.		* e) If the user reaches the very end of the stream (content complete), and then starts to play again (replay from anywhere in the stream), then a new “streamid” should be created and a start audit ping should be sent. Also an end audit should be sent when the stream replay is completed or the user switches to another stream.

Line 899:		Line 901:
	\| createtm \|\| Time the ping was fired: utc (in seconds) If server time available, use it instead of device time \|\| \|\| ✓		\| createtm \|\| Time the ping was fired: utc (in seconds) If server time available, use it instead of device time \|\| \|\| ✓
	\|-		\|-
	\| devid \|\| '''ONLY for''' '''android''' platform, DO NOT pass devid for '''ios''', '''browser''' and '''ott''' platforms. devid, SHA-256 value of Device Id (ADID) ~~- OPTIONAL if passed in the Asset Viewing File~~ \|\| \|\| ✓		\| devid \|\| '''ONLY for''' '''android''' platform, DO NOT pass devid for '''ios''', '''browser''' and '''ott''' platforms. devid, SHA-256 value of Device Id (ADID)\|\| \|\| ✓
	\|}		\|}

Engineering Client Portal - Recent changes [en]

Android SDK Release Notes

DCR Germany Video S2S