Adconfig.Ster.nl

Inleiding

Adconfig.Ster - https://adconfig.ster.nl/ - is een service die aangeroepen kan worden om de aanroep/url voor een advertentie server te ontvangen. Op basis van informatie als wel of geen consent, wordt bepaald welke advertentie server, met wat voor details moet worden aangeroepen. In de nieuwste NPO Player wordt deze functionaliteit ingebouwd.

Details van het programma kunnen bepalen dat geen advertentie server aanroep wordt teruggegeven, zoals bij gevoelige content die niet van een advertentie mag worden voorzien, ZAPPE, en bij korte content die maar in 20% van de gevallen van een (korte) advertentie hoeft te worden voorzien.

Anders dan met behulp van de oude config, hoeft de videoplayer dus niet meer op basis van JSON een url samen te stellen. Ook is het niet meer nodig om altijd twee advertentie server aanroepen uit te voeren zoals in huidige implementatie met de aanroep van Google DFP het geval is.

Werking

Roep voor het verkrijgen van de ad server aanroep, de config aan met https://adconfig.ster.nl/adurl/[identifier], waarbij [identifier] vervangen dient te worden met een voor de app of website unieke identifier.

Voor de NPO zijn de volgende identifiers beschikbaar: npo-app-desktop, npo-app-ios-smartphone, npo-app-ios-tablet, npo-app-android-smartphone, npo-app-android-tablet, npo-app-smarttv, npo-app-tvos (voor AppleTv), npo-app-chromecast. Voor andere omroepen gelden dezelfde identifiers, waarbij 'npo' vervangen dient te worden door de naam van de omroep (lowercase, zonder streepjes). Voorbeeld: bnnvara-app-desktop, bnnvara-app-ios-smartphone, et cetera.

In de adurl/[identifier] aanroep zijn twee variabelen verplicht:

Veld in cust_params Omschrijving
programma_titel De naam van het programma. Alleen kleine letters (geen spaties, streepjes, leestekens en speciale karakters).
referrer_url Url van pagina van stream. Veld is leeg bij apps.
description_url Url van beschrijving van stream (meestal hetzelfde als referrer_url, en mag dan leeg blijven). Veld is leeg bij apps.
genre Hier dient het gewenst genre opgegeven te worden, komma-gescheiden. Wanneer het gaat om een jeugd programma, dan moet de waarde jeugd in de lijst opgenomen worden.
video_duur De totale duur van de af te spelen video, in seconden.
prid Het ID van het programma.
srid Het ID van de serie.
net Bij jeugdprogrammering dient hier zapp (of indien van toepassing: zappe) ingevuld te worden, anders npo1, npo2 of npo3.
player Keuze uit web (website players op desktop), smarttv (SMART TV applicaties), ugkabel (Kabel Uitzending gemist), mobiel (mobiele website, dus de browsers) en app (voor mobiele apps).
os Deze dient gevuld te worden met een kernmerk van het OS (besturingssysteem): windows, linux, osx, ios, android. Als dit uitgelezen kan worden op de client. Mits dit uitgelezen kan worden vanuit de client.
osversion De versie van het OS (besturingssysteem). Mits dit uitgelezen kan worden vanuit de client.
playerversion De versie van jouw applicatie/player. Mits dit uitgelezen kan worden vanuit de client.
omroep De naam van de omroep in default formaat (kleine letters en geen koppel-streepjes). Bijvoorbeeld: npo, nos, avrotros, ntr, bnnvara, vpro, max, eo, kro, bnn, ncrv, vara, powned, wnl, tros of avro. In het geval van meerdere omroepen komma-gescheiden.
afleverings_titel Titel van de aflevering. Alleen kleine letters (geen spaties, streepjes, leestekens en speciale karakters).
subgenre Subgenre (evt een komma gescheiden lijst).
site Korte naam van de site (bij web meestal: url van de website zonder https://www en .nl) van de website waar de player is geimplementeerd, als nos, npo, dewerelddraaitdoor, wieisdemol, zapp. Bij app's korte naam van de app.
ai Dit dient gevuld te worden met het ID van het betreffende device (IDFA (iOS) of AdID (Android)), bijvoorbeeld het device-id voor een smartphone of tablet. Kenmerk is niet verplicht voor niet-mobiele players. Voor players in een app is het wel verplicht, en als het niet achterhaald kan worden is de volgende waarde valide: 00000000-0000-0000-0000-000000000000. Letop: als consent ontbreekt mag dit veld geen ID bevatten, maar is null gewenst.

De volgende antwoorden zijn mogelijk (response formaat is JSON, met 1 variabele: adUrl die linkt naar);

Zonder consent retourneert de adUrl alleen 'simpel VAST', zoals al ondersteund wordt. Als de response niet leeg is, speelt de videoplayer voor de Omroep stream, de 1 of 2 advertenties.

Ook kan door '&test=true' aan de Adconfig-aanroep toe te voegen, een advertentie testnetwerk gebruikt worden. Voorlopig is dit alleen beschikbaar voor de wel-consent route.

Voorbeelden

De volgende consent en no-consent voorbeeld aanroepen voor desktop, zijn volledig gelijk behalve de ncc waarde.

De volgende aanroep met genre=jeugd en net=zappe geeft een lege response. Er kan dan direct naar de Omroep stream gesprongen worden.