Predefined KeyValues
Most KeyValues are used and reused over many different sites.
Should you wish to pass data to our AdSystems, please make sure to use the predefined keys and their respective values as much as possible.
This will simplify the process for advertisers to book your site and makes sure that advertisers can easily manage user & content targeting over different websites.
The values of a key can either be "freeform" or are predefined.
Please use the values listed in the "Values" column as much as possible. Should the Values be "freeform", you can pass any data you wish for this key.
Content related KeyValue pairs
| Key | Values | Description |
|---|---|---|
| cid | freeform | cms id or article id of the page the user is currently viewing. You can pass an identifier or your choosing to our adserver. The Id can later be used to map and report all revenue generated for this specific identifier. For example: art146z2892 or 6789334 |
| eventtype | goal substitution minute75 default startsecondhalf startend start endfirsthalf end firstgoal | eventtype can be used for a website to pass a state of a sport match to the adserver, for example used inside a liveticker. Advertiser will book different creatives for each event and the adserver delivers the creative as soon as the eventtype is used. For example: "This goal is presented by..." eventtype=goal eventtype=minute75 |
| fsk | 0 6 12 16 18 | fsk can be used to cluster the content to a specifc age group. Our AdServer will block certain ads from delivery to this specific age group. For example: You send fsk=12, we will not deliver ads for the latest Call of Duty video game. |
| label | freeform | You can label the page with an identifier of your own choosing. You can use this key for pretty much anything you want. For example: halfarticle or fotoshow or specialblocker or testpage |
| pacont | freeform | pacont ist reserved for "paid contents" / "sponsored posts" or so called "advertorials". For example: vw-id3-april2019 |
| pagetype | fotoshow | Should you wish to differentiate between the types of your pages. Often used in conjunction with CMS Templates, where all content based on one template (for example: "articles") should be targetable or reportable. This key is optional and not mandatory for a working ad setup. However should you wish to allow/disallow specific formats on some parts of your webseit (for example: no "wallpaper" format in photo galleris), we will need the pagetype key to be set on your site.
|
| rcpingredients | freeform | Use this key when you have a recipe database. You can pass any ingedients of the recipe. Please pass only lower case strings without any special characters or spaces. For example: tomatoes |
| rcpcountry | freeform | Use this key wenn you have a recipe database. You can pass the origin country of the recipse with this key. Please pass only lower case strings without any special characters or spaces. For example: china |
| rcpoccasion | freeform | Use this key wenn you have a recipe database. You can pass the occasion for which the recipe fits best. Can be seasonal or events. Please pass only lower case strings without any special characters or spaces. For example: spring or birthdayparty |
| rcppreparations | freeform | Use this key wenn you have a recipe database. You can pass the method of preparation for this recipe. For example: cook or grill or cold |
| rcpdrinks | freeform | Use this key wenn you have a recipe database. You can pass recommended drinks which fit to this recipe. For example: wine or beer |
| rcpcategory | freeform | Use this key wenn you have a recipe database. You can pass the category the recipe fits best to. For example: glutenfree or vegan or snack |
| keyword | freeform | Use this key wenn you want to specify keyword and send it to AdServer Please pass only lower case strings without any special characters or spaces. For example: car or logistic or health |
| keywords | freeform | Use this key wenn you want to specify keywords and send it to AdServer Please pass only lower case strings without any special characters or spaces. For example: hardware or software or clothing |
| rfree | 0-99 100-199 200-299 300-399 400-499 500+ | Use this value wenn you want to specify right free space in skyscraper slot |
| amp | 1 0 | Marks a tag as being integrated into an "AMP" environment Examples: 1 = ja 0 = nein |
User related KeyValue pairs
Please make sure to comply to your local law concerning sending user related data to 3rd party systems.
| Key | Values | Description |
|---|---|---|
| plz | 5 digit code | Can be used to pass the 5 digit german postal code to our adserver. If you have less than 5 digits, please only pass the known digits. For example: 48531 or 485 |
| age | 13-17 18-24 25-34 35-44 45-54 55-up | age of the user, clustered into groups. Please make sure to never use the actual age of the user, only send us the age group the user is part of. |
| gender | f m u | Gender of the user. Send "u" if user has not clarified their gender or the user prefers a gender not listed here. |
| country | Alpha-3 country code | Current country of the user, please use the IBAN Alpha-3 country code. https://www.iban.com/country-codes |