AGF Metadata Convention: Difference between revisions
From Engineering Client Portal
MichelFodjo (talk | contribs) (→Static Measurement: subbrand NOT required for static like for Video) |
MichelFodjo (talk | contribs) (→Static Measurement: Upload 2 Static AGF Metadata document - PDF Files) |
||
Line 34: | Line 34: | ||
| 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" | | 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" | ||
|} | |} | ||
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)]''' | |||
* '''[https://engineeringportal.nielsen.com/wiki/File:250807_AGF_Metadata_Static-Display_v.1.0_deutsch.pdf Guide for STATIC metadata & custom variables (german version)]''' | |||
== Video Measurement == | == Video Measurement == |
Revision as of 09:10, 1 October 2025
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
Key | Description | Values | Required (Obligatory) | AGF Convention | Example data - RTL |
---|---|---|---|---|---|
type | type of asset | "static" |
✓ | hardcoded string required by Nielsen | "static"
|
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" |
In order to avoid incorrect / implausible filling of individual STATIC metadata and custom-variables please refer to the following additional AGF assistance:
- Guide for STATIC metadata & custom variables (english version)
- Guide for STATIC metadata & custom variables (german version)
Video Measurement
Please refer to this AGF Metadata Document for Video:
- Metadata and custom-Variables Document for Video (english version)
- Metadata and custom-Variables Document for Video (german version)
In order to avoid incorrect / implausible filling of individual metadata and custom-variables please refer to the following additional assistance: