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

KeyValuesDescription
cidfreeform

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.
This id is often used in parallel with Google Analytics, so you have a 1:1 connection between all ad related metrics and your site related metrics.
Please do not use special characters or spaces.

For example: art146z2892 or 6789334

eventtypegoal
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

fsk0
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.
labelfreeform

You can label the page with an identifier of your own choosing. You can use this key for pretty much anything you want.
Its often being used to differentiate between different page types (article types), or to mark a html page with a property which you later need to book campaign on.
Please do not use special characters or spaces.

For example: halfarticle or fotoshow or specialblocker or testpage 

pacontfreeform

pacont ist reserved for "paid contents" / "sponsored posts" or so called "advertorials". 
You can pass an identifier of your choosing, which in turn can be used by our AdOperations team to exclusivly book high priority advertisments campaigns of the specific advertiser to the site.

For example: vw-id3-april2019

pagetype

fotoshow
artikel
rubrik
article
start
gallery
ticker
home
oped

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.
The values on this key are set and not changeable, to allow as many website as possible to be targetable through the same key.

Please affiliate each value of this key to as many different types of your content as possible.

  • article or artikel = editorials, news articles, a lengthy block of text or a table of data that will bind the users attention for a few minutes
  • start = a entry point to a subsection of your website. For example: the start page of your "fashion" subsection. Often associated with the landing page, after the user clicked a link in your websites navigation menu.
  • gallery or fotoshow = some photo show or quiz / riddle section of your site, where the user has to click/scroll multiple times to progress through the content, or the content changes rapidly to the users interaction
  • ticker = liveticker and sport events
  • home = the homepage/index of your website
  • oped = op-eds or columns where the author is not part of your editorial team, and may present a controversial opinion
  • rubrik = transmit additional heading data (rubric)
rcpingredientsfreeformUse 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
rcpcountryfreeformUse 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
rcpoccasionfreeformUse 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
rcppreparationsfreeform

Use this key wenn you have a recipe database. You can pass the method of preparation for this recipe.
Please pass only lower case strings without any special characters or spaces.

For example: cook or grill or cold

rcpdrinksfreeform

Use this key wenn you have a recipe database. You can pass recommended drinks which fit to this recipe.
Please pass only lower case strings without any special characters or spaces.

For example: wine or beer

rcpcategoryfreeform

Use this key wenn you have a recipe database. You can pass the category the recipe fits best to.
Please pass only lower case strings without any special characters or spaces.

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

keywordsfreeform

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.

KeyValuesDescription
plz5 digit codeCan 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
age13-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.
genderf
m
u
Gender of the user. Send "u" if user has not clarified their gender or the user prefers a gender not listed here.
countryAlpha-3 country codeCurrent country of the user, please use the IBAN Alpha-3 country code. https://www.iban.com/country-codes