AGF Metadata Convention: Difference between revisions

From Engineering Client Portal

(→‎Static Measurement: subbrand NOT required for static like for Video)
(→‎Static Measurement: remove Metadata table and keep only the 2 pdf files provided by AGF as requested by AGF local team)
 
(One intermediate revision by the same user not shown)
Line 16: Line 16:
</blockquote>
</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)]'''
|-
| type || type of asset || <code>"static"</code> || ✓ || hardcoded string required by Nielsen  || <code>"static"</code>
|-
| 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 (no [[Special Characters]]) || ✓ || 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. If the AGOF code is not available, set "Unknown" || "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" || For Content: "CPI" . For 'Werbetraeger' after user interaction with the site and newly loaded Content: "WPI".
|-
| 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 ==
== Video Measurement ==

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"