AGF Metadata Convention: Difference between revisions
From Engineering Client Portal
MichelFodjo (talk | contribs) |
MichelFodjo (talk | contribs) (→Video Measurement: update from AGF) |
||
| Line 37: | Line 37: | ||
== Video Measurement == | == Video Measurement == | ||
Please refer to this AGF Metadata Document for Video: '''[https://nielsendownloads.digitalengsdk.com/digital/220907_AGF+Custom+Variables+and+Metadata+DCR+SDK++v1.8_english.pdf Metadata Document for Video]''' | Please refer to this AGF Metadata Document for Video: | ||
* '''[https://nielsendownloads.digitalengsdk.com/digital/220907_AGF+Custom+Variables+and+Metadata+DCR+SDK++v1.8_english.pdf Metadata and custom-Variables Document for Video (english version)]''' | |||
* '''[https://nielsendownloads.digitalengsdk.com/digital/220907_AGF+Custom+Variables+and+Metadata+DCR+SDK++v1.8_english.pdf Metadata and custom-Variables Document for Video (german version)]''' | |||
In order to avoid | |||
'''[https://nielsendownloads-blue.digitalengsdk.com/digital/20240415%20guide%20metadata%20&%20custom%20variables%20-%20english.pdf | 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/20240415%20guide%20metadata%20&%20custom%20variables%20-%20english.pdf Guide for metadata & custom variables (english version)]''' | |||
* '''[https://nielsendownloads-blue.digitalengsdk.com/digital/20240415%20guide%20metadata%20&%20custom%20variables%20-%20deutsch.pdf Guide for metadata & custom variables (german version)]''' | |||
* [[File:231130 AGF Custom Variables and Metadata DCR SDK v.1.9.pdf]] | |||
* [[File:231130_AGF_Custom_Variables_and_Metadata_DCR_SDK_v1.9_english.pdf]] | |||
Revision as of 09:15, 6 May 2024
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" |
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:
- Guide for metadata & custom variables (english version)
- Guide for metadata & custom variables (german version)
