AGF Metadata Convention: Difference between revisions

From Engineering Client Portal
(→‎Static Measurement: remove Metadata table and keep only the 2 pdf files provided by AGF as requested by AGF local team)
 
(11 intermediate revisions by the same user not shown)
Line 11: Line 11:
== Static Measurement ==
== Static Measurement ==


<blockquote>'''AppSDK version >= 9.1.0.0 is required''': <pre style="color: red">
The newly introduced AppSDK API staticEnd() is required for the Static Measurement.
The staticEnd() API is available only for AppSDK version 9.1.0.0 or higher </pre>
</blockquote>


{| class="wikitable"
In order to avoid incorrect / implausible filling of individual STATIC metadata and custom-variables please refer to the following additional AGF assistance:
|-
* '''[https://engineeringportal.nielsen.com/wiki/File:250807_AGF_Metadata_Static-Display_v.1.0_english.pdf Guide for STATIC metadata & custom variables (english version)]'''
! Key !! Description !! Values !! Required (Obligatory) !! AGF Convention !! Example data - RTL
* '''[https://engineeringportal.nielsen.com/wiki/File:250807_AGF_Metadata_Static-Display_v.1.0_deutsch.pdf Guide for STATIC metadata & custom variables (german version)]'''
|-
| assetid || unique ID assigned to each article/page; only characters 0-9, a-z, A-Z underscore and minus are allowed - no special characters or vowel mutations) || custom (no [[Special Characters]]) || ✓ || Content Article ID. If it is not an article page and therefore no ID is available, the page path is used. || "999452"
|-
| section || section of each site (e.g. section value should be first level in page URL: website.com/section) || custom || ✓ || Section of Website or App || "/rtl_portal/news"
|-
| segA ||  custom segment for reporting: unique values across custom segments (segA + segB + segC) || custom || ✓ || AGOF code or comparable unit code || "dbrsowf_rtlnews"
|-
| segB ||  custom segment for reporting: unique values across custom segments (segA + segB + segC) || custom || ✓ || Value to define content view count vs. 'Werbetraeger' view count. For Content: "CPI" . For 'Werbetraeger': "WPI_timestamp" (Timestamp in whole seconds, not milliseconds) || For Content: "CPI" . For 'Werbetraeger' after user interaction with the site and newly loaded Content: "WPI_1657634473".
|-
| segC ||  custom segment for reporting: unique values across custom segments (segA + segB + segC) || custom ||  || Program name || "IBES"
|-
| subbrand ||  vcid/sub-brand ID – value is automatically populated through provided App ID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands in App) || provided by Nielsen || ✓ || Same as video measurement, provided by Nielsen || "c01"
|}


== Video Measurement ==


Please refer to this AGF Metadata Document for Video:
* '''[https://nielsendownloads-blue.digitalengsdk.com/digital/AGF_Video_Measure_June132024/240304_AGF+Custom+Variables+and+Metadata+DCR+SDK++v1.10_english.pdf Metadata and custom-Variables Document for Video (english version)]'''
* '''[https://nielsendownloads-blue.digitalengsdk.com/digital/AGF_Video_Measure_June132024/240304_AGF%20Custom%20Variables%20and%20Metadata%20DCR%20SDK%20v.1.10_deutsch.pdf Metadata and custom-Variables Document for Video (german version)]'''


== Video Measurement ==


Please refer to this AGF PDF Document: '''[https://nielsendownloads.digitalengsdk.com/digital/220907_AGF+Custom+Variables+and+Metadata+DCR+SDK++v1.8_english.pdf Metadata Document for Video]'''
In order to avoid incorrect / implausible filling of individual metadata and custom-variables please refer to the following additional assistance:  
* '''[https://nielsendownloads-blue.digitalengsdk.com/digital/AGF_Video_Measure_June132024/20240606%20guide%20metadata%20&%20custom%20variables%20-%20english.pdf Guide for metadata & custom variables (english version)]'''
* '''[https://nielsendownloads-blue.digitalengsdk.com/digital/AGF_Video_Measure_June132024/20240606%20guide%20metadata%20&%20custom%20variables%20-%20deutsch.pdf Guide for metadata & custom variables (german version)]'''

Latest revision as of 11:05, 2 October 2025

Engineering Portal / Digital / AGF Implementation Documentation / AGF Metadata Convention

AGF Metadata Convention

The Metadata can pass through key values using the Nielsen reserved keys. The keys and values are listed by the product below.

Note: All metadata values should be passed as UTF-8 strings.

Static Measurement

AppSDK version >= 9.1.0.0 is required: 

 
The newly introduced AppSDK API staticEnd() is required for the Static Measurement. 
The staticEnd() API is available only for AppSDK version 9.1.0.0 or higher

In order to avoid incorrect / implausible filling of individual STATIC metadata and custom-variables please refer to the following additional AGF assistance:

Video Measurement

Please refer to this AGF Metadata Document for Video:


In order to avoid incorrect / implausible filling of individual metadata and custom-variables please refer to the following additional assistance:

Retrieved from "https://engineeringportal.nielsen.com/w/index.php?title=AGF_Metadata_Convention&oldid=7393"