Parameters voor VAST-advertentietag-URL's

Een speler gebruikt een VAST-advertentietag-URL om video- en audioadvertenties op te halen. U kunt een VAST-advertentietag-URL handmatig samenstellen of een bestaande URL wijzigen met behulp van de onderstaande parameters. Vervolgens kunt u deze testen met de VAST Suite Inspector. U kunt deze voorbeeldtags ook controleren en testen.

Algemene URL-vereisten

• Protocol: VAST-advertentietags bieden ondersteuning voor zowel HTTP als HTTPS. Tracking-URL's voor vertoningen houden rekening met de huidige SSL-instelling en worden geretourneerd als HTTP of HTTPS. Voor het bijhouden van doorklikken en klikken wordt HTTP geretourneerd, aangezien er wordt omgeleid via een andere pagina.
• Domein: het gebruik van dynamische domeinen, gemaakt via de macro voor patroonovereenkomst of een andere dynamische methode, is niet toegestaan en leidt tot een fout.
• Live verkeer: Het pad van advertentietag-URL's voor live videostreams moet /live bevatten om ervoor te zorgen dat grote hoeveelheden verkeer kunnen worden verwerkt, waarbij alle advertentiepauzes tegelijkertijd worden weergegeven.

Voorbeeld van een VAST-advertentietag

Een voorbeeld van een VAST-advertentietag-URL, met parameters en toegewezen waarden, ziet er ongeveer zo uit:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

 Naar een specifieke parameter in de lijst gaan

aconp ad_rule ad_type addtl_consent afvsz allcues an ciu_szs correlator cmsid cust_params description_url dth env excl_cat gdfp_req gdpr gdpr_consent givn

hl iabexcl idtype ipd ipe is_lat iu lip ltd max_ad_duration min_ad_duration mridx msid nofb npa omid_p output paln plcmt

pmad pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp schain scor

sdk_apis sdmax sid ssss sz tfcd trt unviewed_position_start url vad_type vconp vid vid_d vpa vpi vpmute vpos wta

Parameter	Details
aconp (audio continu afspelen)	Aanbevolen volgens de MRC-richtlijnen voor audiometing De parameter voor continu afspelen van audio accepteert een constante waarde om aan te geven of de speler audiocontent doorlopend moet afspelen. Deze parameter moet niet worden ingesteld als deze onbekend is. Voorbeeld van gebruik Continu afspelen AAN: aconp=2 Continu afspelen UIT: aconp=1
ad_rule (advertentieregel)	De parameter voor advertentieregel accepteert een constante waarde die aangeeft of er VAST-advertentiemateriaal of een advertentieregelreactie moet worden geretourneerd. De standaardinstelling voor advertentieregels is afhankelijk van een Ad Manager-netwerkinstelling. U kunt de instelling voor specifieke advertentietags overschrijven aan de hand van de onderstaande voorbeelden. Voorbeeld van gebruik Verzoek voor VAST-advertentiemateriaal: ad_rule=0 Verzoek voor advertentieregels (VMAP): ad_rule=1 Vereiste Vereist voor videoadvertentieregels
ad_type (advertentietype)	De parameters voor het advertentietype accepteren een constante waarde die de advertentietypen aangeeft die voor het verzoek moeten worden geretourneerd. Deze parameter is alleen vereist voor audioadvertenties. Als ad_type is ingesteld op audio of audio_video, moet de parameter vpmute worden ingesteld op 0. Gebruiksvoorbeelden Staat alleen audioadvertenties toe: ad_type=audio Staat zowel videoadvertenties die kunnen worden overgeslagen als videoadvertenties die niet kunnen worden overgeslagen toe: ad_type=video Staat zowel audio- als videoadvertenties toe: ad_type=audio_video (Met deze waarde kunnen beide indelingen concurreren, maar wordt er maar één advertentie weergegeven.) Het advertentietype audio_video is alleen bedoeld voor gebruik voor het weergeven van videoadvertentiemateriaal in audiocontent die het afspelen van videoadvertenties of audioadvertentiemateriaal ondersteunt in in-stream videospelers voor content die beluisterbaar van aard kan zijn. Bijvoorbeeld sportstreams, videocasts, nieuws, enzovoort. Lees meer informatie over audio in videocontent. Staat alleen videoadvertenties toe die kunnen worden overgeslagen: ad_type=skippablevideo Staat alleen videoadvertenties toe die niet kunnen worden overgeslagen: ad_type=standardvideo Vereiste Vereist voor audioadvertenties
addtl_consent (aanvullende toestemming)	De parameter voor aanvullende toestemming accepteert variabele waarden en wordt gebruikt door uitgevers die willen integreren met IAB TCF v2.0 en een leverancier willen gebruiken die nog niet is geregistreerd op de wereldwijde leverancierslijst van IAB Europe, maar wel is opgenomen in de lijst met aanbieders van advertentietechnologie van Google. Directe VAST-verzoeken lezen de waarden niet automatisch, maar ze worden geaccepteerd als ze worden toegevoegd aan advertentietags. U vindt meer informatie over de waarden die aan deze parameter worden doorgegeven in de technische specificatie voor de Stand voor aanvullende toestemming. Voorbeeld van gebruik addtl_consent=1~1.35.41.101
afvsz (niet-lineaire advertentieformaten)	De parameter voor niet-lineaire advertentieformaten accepteert constante waarden als een door komma's gescheiden lijst met niet-lineaire advertentieformaten die in de videoadvertentieruimte kunnen worden weergegeven. Deze formaten moeten een van de ondersteunde formaten zijn: 200x200 250x250 300x250 336x280 450x50 468x60 480x90 729x90 Bij gebruik van de IMA-SDK wordt dit veld overschreven en gevuld door alle ondersteunde formaten die binnen nonLinearAdSlotWidth en nonLinearAdSlotHeight vallen. Deze parameter kan worden weggelaten of leeggelaten als er geen niet-lineaire formaten worden ondersteund. Voorbeeld van gebruik Alle formaten worden ondersteund: afvsz=200x200,250x250,300x250,336x280, 450x50,468x60,480x90,728x90 Maximale breedte is 250: afvsz=200x200,250x250 Maximale hoogte is 60: afvsz=450x50,468x60 Maximale breedte is 100: //empty; no values supported   Vereiste Vereist voor niet-lineaire videoadvertenties als de IMA-SDK niet wordt gebruikt
allcues (alle weergavepunten)	Deze parameter accepteert variabele waarden als een door komma's gescheiden lijst met weergavepunten (in milliseconden). Voor elke waarde retourneert Ad Manager een advertentie-onderbreking. De parameters vid_d en allcues worden gebruikt om midroll-advertenties zonder contentopname weer te geven. Advertentieregels zijn ook vereist om midrolls te retourneren. Als op tijd gebaseerde weergavepunten worden gebruikt in uw advertentieregels (bijvoorbeeld 'Elke N seconden' of 'Op vaste tijden'), worden de in de advertentieregel ingestelde weergavepunten gebruikt en worden de weergavepunten die worden doorgegeven in allcues genegeerd. Midrolls vereisen nog steeds een duur, dus vid_d moet ook worden doorgegeven. Voorbeeld van gebruik Weergavepunten op 10 en 20 seconden: allcues=10000,20000
ciu_szs (begeleidende formaten)	De parameter voor begeleidende formaten accepteert variabele waarden als door komma's gescheiden lijst met begeleidende formaten. Door sluistekens (|) gescheiden waarden geven een advertentieruimte met meerdere formaten aan. Voorbeeld van gebruik ciu_szs=728x90,300x250 Formaten met een ruimte voor meerdere formaten: ciu_szs=728x90,300x200|300x250
cmsid (contentbron-ID) vid (video ID)	De parameters voor contentbron-ID en video-ID accepteren variabele waarden. Als u advertenties op videocontent wilt targeten, moet uw hoofdvideotag deze beide parameters bevatten. De parameter cmsid is een uniek nummer voor elke contentbron. Klik om deze informatie te vinden op Video Inhoudsbronnen en vervolgens op de naam van de bron. De parameter vid is een tekenreeks of getal waarmee een bepaalde video kan worden geïdentificeerd. Deze ID wordt toegewezen door het CMS dat uw content host. Klik om deze informatie te vinden op Video Inhoudsbronnen en vervolgens op de specifieke videocontent. Voorbeeld van gebruik cmsid=[value]&vid=[value] Als u een tag samenstelt voor dynamische advertentie-invoeging met video on demand, moet u de macro's gebruiken die op dynamische wijze de juiste contentbron-ID en video-ID invoegen. Voorbeeld: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%% Vereiste Vereist voor targeting op videocontent
correlator (correlator)	De parameter voor correlator accepteert een variabele waarde die wordt gedeeld door meerdere verzoeken die afkomstig zijn van dezelfde paginaweergave. De parameter wordt gebruikt om concurrentie-uitsluitingen te implementeren, zoals in omgevingen zonder cookies. Als de IMA-SDK wordt gebruikt, wordt de correlatorwaarde automatisch ingesteld. Als uw speler deze waarde probeert in te stellen, wordt deze waarde overschreven door de SDK met een eigen waarde. Als de IMA-SDK niet wordt gebruikt, moet u ervoor zorgen dat u deze waarde instelt op een echt willekeurig, positief geheel getal dat niet opnieuw wordt gebruikt door meerdere paginaweergaven. Voorbeeld van gebruik correlator=4345645667 Vereiste Vereist voor internet en apps Aanbevolen voor programmatic inkomsten genereren
cust_params (parameters voor aangepaste sleutel/waarden)	De parameter voor aangepaste parameters accepteert variabele waarden die sleutel/waarde-paren zijn waarmee u specifieke targeting kunt instellen, zoals demografie, bepaalde posities op een pagina of een specifieke pagina/specifieke pagina's. Voorbeeld van gebruik Bekijk voorbeelden van het toevoegen van sleutel/waarde-paren.
description_url (beschrijvings-URL)	De parameter voor de beschrijvings-URL accepteert een variabele waarde die de video moet beschrijven die op de pagina wordt afgespeeld. Geef een overzicht van de pagina met 1-3 alinea's die de content beschrijven. Voeg bijvoorbeeld de paginacontent van description_url dynamisch samen op basis van vooraf gedefinieerde blokken. Meer informatie over hoe u een afzonderlijke beschrijvings-URL verstrekt. De waarde description_url moet URL-gecodeerd zijn voor videospelers op webpagina's en CTV/OTT-apparaten en niet gecodeerd voor mobiele in-app-videospelers. Deze parameter wordt niet automatisch ingesteld door de IMA-SDK. De parameter moet handmatig worden ingesteld. Voorbeeld van gebruik URL-gecodeerd: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Niet gecodeerd: description_url= https://www.sample.com/golf.html Vereiste Vereist voor internet, app en Ad Exchange Aanbevolen voor programmatic inkomsten genereren
dth (Hint voor apparaattype)	De parameter voor hint voor apparaattype accepteert een constante waarde waarmee verkeerde apparaatclassificatie kan worden beperkt, met name in verbonden tv- en settopbox-omgevingen. Een verkeerde apparaatclassificatie kan het gevolg zijn van onbedoelde fouten van de uitgever of de OEM van de verbonden tv. Deze parameter wordt in combinatie met andere signalen gebruikt door Google om automatisch instanties te markeren waarin voorraad voor verbonden tv's opnieuw kan worden geclassificeerd. Gebruiksvoorbeelden Verzoeken van: Featurephone: dth=1 Smartphone: dth=2 Desktop: dth=3 Tablet: dth=4 Verbonden tv: dth=5 Gameconsole: dth=6 Settopbox: dth=7 Vereiste Aanbevolen voor programmatic inkomsten genereren op verbonden tv's. Deze parameter wordt aanbevolen voor PAL- en PAI-implementaties (niet-SDK). Deze is niet nodig voor de IMA-SDK of DAI-SDK.
env (omgeving)	De omgevingsparameter accepteert een constante waarde om een InStream-verzoek aan te geven of om aan te geven dat het verzoek specifiek afkomstig is van een videospeler. Mogelijke waarden zijn instream (kan worden gebruikt voor video- en audioadvertenties) en vp (kan alleen worden gebruikt voor videoadvertenties). Voorbeeld van gebruik Video en/of audio: env=instream Alleen video: env=vp Vereiste Vereist voor internet en apps
excl_cat (uitsluitingscategorie)	De parameter voor uitsluitingscategorie accepteert variabele waarden en wordt gebruikt om regelitems die het betreffende uitsluitingslabel bevatten te blokkeren voor een bepaald advertentieverzoek. Deze parameter werkt met cust_params. Voorbeeld van gebruik &cust_params=excl_cat%3Dairline_excl_label%7C
gdfp_req (schema-indicator voor Ad Manager)	De parameter voor de schema-indicator voor Ad Manager accepteert een constante waarde om aan te geven dat de gebruiker het Ad Manager-schema gebruikt. Voorbeeld van gebruik gdfp_req=1 Vereiste Vereist voor internet en apps
gdpr (AVG)	De parameter voor de AVG accepteert constante waarden en wordt gebruikt door uitgevers die willen integreren met IAB TCF v2.0. Directe VAST-verzoeken lezen de waarden niet automatisch, maar ze worden geaccepteerd als ze worden toegevoegd aan advertentietags. Alleen 0 en 1 zijn geldige waarden voor deze parameter, waarbij 0 betekent dat de AVG niet van toepassing is en 1 betekent dat de AVG van toepassing is. Als de AVG van toepassing is, moet u ook een geldige TC-tekenreeks opgeven via de parameter gdpr_consent. U vindt meer informatie over de waarden die aan deze parameter worden doorgegeven in de algemene richtlijnen voor de implementatie van het framework of in het gedeelte TC-tekenreeks van de IAB TCF v2.0-specificatie. Voorbeeld van gebruik De AVG is van toepassing: gdpr=1 De AVG is niet van toepassing: gdpr=0
gdpr_consent (AVG-toestemming)	De parameter voor AVG-toestemming accepteert variabele waarden en wordt gebruikt door uitgevers die willen integreren met IAB TCF v2.0. Directe VAST-verzoeken lezen de waarden niet automatisch, maar ze worden geaccepteerd als ze worden toegevoegd aan advertentietags. U vindt meer informatie over de waarden die aan deze parameter worden doorgegeven in de algemene richtlijnen voor de implementatie van het framework of in het gedeelte TC-tekenreeks van de IAB TCF v2.0-specificatie. Voorbeeld van gebruik gdpr_consent=GDPR_CONSENT_123
givn paln (Video-nonce)	For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value. The nonce is URL safe—you don't need to URL-encode it. Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters. Usage example You can read more about the value passed to this parameter in the getting started guides for PAL.
hl (Taal)	De parameter voor taal accepteert een constante waarde die wordt gebruikt om advertenties in de betreffende taal aan te vragen, en voor de taal voor advertentieselectie en weergave van videoadvertenties bij dynamische toewijzing in Ad Exchange of AdSense voor video. De parameterwaarde kan elke ISO 639-1-code (2 letters) of ISO 639-2-code (3 letters) zijn. Bekijk een lijst met geldige codes. Als deze parameter wordt weggelaten, wordt de waarde standaard ingesteld op een willekeurige taal met advertentietargeting op taal in Ad Exchange. Voorbeeld van gebruik hl=it Vereiste Aanbevolen voor programmatic inkomsten genereren
iabexcl (IAB-uitsluitings-URL)	De URL-parameter iabexcl accepteert een door komma's gescheiden lijst met categorieën. Voorbeeld van gebruik iabexcl=3,14,527 sluit Commerciële vrachtwagens, Terreinvoertuigen en Rugby uit. Vind meer informatie over de IAB-contenttaxonomie.
ipd (voorraadpartnerdomein)	De parameter voor het domein van de voorraadpartner accepteert variabele waarden die moeten worden ingesteld voor de definities van inventorypartnerdomain in het app-ads.txt-bestand (of ads.txt-bestand) van de uitgever. De parameter inventorypartnerdomain is een IAB-specificatie waarmee uitgevers een domein kunnen aanwijzen als partner voor voorraad delen om ads.txt/app-ads.txt te valideren. IPD-declaratie is met name belangrijk in toepassingen voor het delen van voorraad waarbij de advertentievoorraad waaruit een verzoek afkomstig is, mogelijk eigendom is van een andere partner (de partner voor voorraad delen). Meer informatie over ads.txt/app-ads.txt en partners voor voorraad delen.
ipe (entiteit voor vertoningspings)	De entiteitsparameter voor vertoningspings accepteert een constante waarde die wordt gebruikt om vertoningspings en conversies aan te geven die afkomstig zijn van de server en niet van de client. Voorbeeld van gebruik Server-Side Beaconing (SSB): ipe=ssb
iu (advertentieblok)	De parameter voor advertentieblok accepteert een variabele waarde die moet worden ingesteld voor het huidige advertentieblok, met de volgende indeling: /network_code/.../ad_unit Voorbeeld van gebruik iu=/6062/videodemo Vereiste Vereist voor internet en apps
lip (laatste positie in pod)	De parameter voor laatste positie in de pod accepteert een constante waarde om een verzoek van de laatste positie in een pod aan te geven. Deze parameter is alleen voor standaardpods. Voorbeeld van gebruik lip=true
ltd (Beperkte advertenties)	De parameter voor beperkte advertenties accepteert een constante waarde om aan te geven of advertenties op een beperkte manier moeten worden weergegeven als er geen toestemming is voor het gebruik van cookies of andere lokale ID's. In tegenstelling tot andere URL-parameters verandert het instellen van ltd=1 het gedrag van de IMA-SDK zodat het verzoek als ID-loos wordt behandeld en opslag niet wordt toegestaan. Voorbeeld van gebruik ltd=1
min_ad_duration (minimumduur van advertentie) max_ad_duration (maximumduur van advertentie)	De parameters voor advertentieduur accepteren variabele waarden die gezamenlijk het duurbereik aangeven waaraan een advertentie moet voldoen, in milliseconden. Gebruik deze parameter om de individuele advertentieduur te beperken voor afzonderlijke advertenties en geoptimaliseerde podverzoeken. Voorbeeld van gebruik min_ad_duration=15000&max_ad_duration=30000
mridx (midroll-nummer)	De parameter voor midroll-nummer accepteert een variabele waarde die het ordinale getal van de midroll aangeeft (bijvoorbeeld midroll 1, midroll 2 enzovoort). Voorbeeld van gebruik mridx=2
msid (app-ID) an (app-naam)	De parameters voor app-ID en app-naam accepteren variabele waarden die moeten worden toegepast op verzoeken die afkomstig zijn van mobiele apps en verbonden tv-apparaten, omdat de meeste programmatic videoadvertenties ze nodig hebben. De IMA-SDK vult beide parameters automatisch in, maar ze moeten handmatig worden opgegeven in directe VAST-aanroepen (niet-SDK-omgevingen). Hoewel de app-naam een voor mensen leesbare naam moet zijn, heeft de SDK in iOS en tvOS geen toegang tot de app-ID. In deze gevallen wordt de parameter msid niet gestuurd en stuurt de SDK de app-bundel via de parameter an. Voorbeeld van gebruik msid=com.package.publisher&an=sample%20app App-ID's hebben een andere naam en indeling in verschillende appstores. Bekijk de IAB-richtlijnen voor app-identificatie of voorbeelden van veelgebruikte unieke ID's. Voor platforms waarvoor geen appstore bestaat, raadt het IAB uitgevers aan de volgende indeling te gebruiken voor winkel-ID's: com.publisher.deviceplatform Vereiste Beide parameters zijn vereist voor apps Aanbevolen voor programmatic inkomsten genereren
nofb (reserve uitgezet)	De parameter voor reserve uitgezet accepteert een constante waarde om aan te geven dat het advertentieverzoek geen playlist met videofallback-advertenties moet retourneren. Voorbeeld van gebruik Reserve gedeactiveerd: nofb=1
npa (niet-gepersonaliseerde advertentie)	De parameter voor niet-gepersonaliseerde advertenties accepteert een constante waarde om aan te geven dat het advertentieverzoek als niet-gepersonaliseerd moet worden behandeld. U moet specifiek npa=1 instellen of npa (zonder een ingestelde waarde) opnemen om het verzoek als niet-persoonlijk te taggen. Advertentieverzoeken die deze parameter niet bevatten of zijn ingesteld op npa=0, worden standaard gekoppeld aan gepersonaliseerde advertenties. Voorbeeld van gebruik Niet-gepersonaliseerde advertenties: npa=1
omid_p (OMID-partnernaam)	De parameter voor de OMID-partnernaam accepteert een variabele waarde die de naam aangeeft van de partner die de OMID-meting integreert, en de partnerversie. Deze parameter is alleen van toepassing op uitgevers die Actieve weergave-metingen willen als ze de Open Measurement SDK (OM SDK) gebruiken. Dit moet niet worden gebruikt als de IMA-SDK wordt gebruikt, omdat deze automatisch wordt ingesteld. Als u OMID-ondersteuning wilt aangeven bij gebruik van Programmatic Access Library (PAL), moet u de API's omidPartnerName en omidPartnerVersion gebruiken om de partnernaam en -versie in te stellen. Als u geen PAL of IMA gebruikt, moet u de parameters omid_p en sdk_apis instellen (de ondersteunde API's die ook andere, door komma's gescheiden API's kunnen bevatten). Voorbeeld van gebruik Als u PAL gebruikt: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Als u PAL niet gebruikt: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
output (uitvoerindeling van advertentie)	De parameter voor uitvoerindeling van advertenties accepteert een constante waarde die moet worden ingesteld voor de uitvoerindeling van de advertentie. Gebruik output=vast voor de standaard VAST-versie die is ingesteld voor uw netwerk. Voor specifieke advertentietags of delen van uw site kunt u specifieke VAST- of VMAP-versies aanvragen. Voor VAST: Als uw videospeler de IMA-SDK gebruikt, wordt de uitvoerparameter voor een videoadvertentieverzoek altijd ingesteld op output=xml_vast4. Dit levert geen betrouwbaarheidsrisico op, omdat de SDK werkt met alle VAST-versies die een externe advertentieserver kan weergeven. Gebruik output=vmap om terug te gaan naar de standaard VMAP-versie die u heeft geactiveerd voor uw netwerk (bijvoorbeeld VMAP 1). Als u VAST retourneert binnen VMAP, kunt u xml_vmap1_vast3 of xml_vmap1_vast4 gebruiken om op te geven welke VAST-versie moet worden geretourneerd. Voorbeeld van gebruik De standaard VAST-instelling van uw netwerk: output=vast VAST 4: output=xml_vast4 De standaard VMAP-instelling van uw netwerk: output=vmap VMAP 1: output=xml_vmap1 VMAP 1, VAST 4 wordt geretourneerd: output=xml_vmap1_vast4 Vereiste Vereist voor internet en apps
plcmt (plaatsing)	De plaatsingsparameter accepteert een constante waarde die wordt gebruikt om aan te geven of de in-stream voorraad wordt gedefinieerd als in-stream of begeleidend volgens de richtlijnen in de IAB-specificaties. Voor niet-in-stream verzoeken wordt dit veld automatisch ingevuld voor kopers op basis van de aangegeven voorraadindeling en overschrijft het elke declaratie voor in-stream of bijbehorende content. Voorbeeld van gebruik In-stream verzoek: plcmt=1 Verzoek voor bijbehorende content: plcmt=2 Vereiste   Vereist voor internet en inkomsten genereren met Programmatic
pmad (maximumaantal advertenties in pod)	De parameter voor maximum aantal advertenties in een pod accepteert een variabele waarde om het maximale aantal advertenties in een pod aan te geven. Deze parameter is specifiek bedoeld voor geoptimaliseerde pods, die beschikbaar zijn voor uitgevers met een geavanceerd videopakket. De parameter moet niet worden gebruikt voor VMAP (als ad_rule=1 is). Voorbeeld van gebruik pmad=4
pmnd (minimumduur van pod) pmxd (maximumduur van pod)	De parameters voor podduur accepteren variabele waarden die gezamenlijk het duurbereik aangeven waaraan een pod moet voldoen, in milliseconden. Deze parameters worden gebruikt om meerdere advertenties aan te vragen. Deze parameters zijn specifiek bedoeld voor geoptimaliseerde pods, die beschikbaar zijn voor uitgevers met een geavanceerd videopakket. Ze moeten niet worden gebruikt voor VMAP (als ad_rule=1 is). Voorbeeld van gebruik pmnd=0&pmxd=60000
pod (podnummer)	De parameter voor podnummer accepteert een variabele waarde die het ordinale getal van de pod in een video vertegenwoordigt (bijvoorbeeld pod 1, pod 2 enzovoort). Voorbeeld van gebruik pod=3 Vereiste Vereist voor een juiste werking van concurrentie-uitsluitingen, frequentielimieten en gerelateerde functies.
pp (profiel van advertentiemateriaal)	De parameter voor profiel van advertentiemateriaal accepteert een variabele waarde die het advertentiemateriaal bepaalt dat in aanmerking komt voor weergave op basis van de configuratie die is ingesteld in een profiel voor video- en audioadvertentiemateriaal. Voorbeeld van gebruik pp=creative_profile Vereiste Aanbevolen voor programmatic inkomsten genereren
ppt (privacybehandeling voor uitgevers)	De parameter voor de privacybehandeling van uitgevers accepteert een constante waarde die wordt gebruikt om aan te geven of advertentiepersonalisatie moet worden uitgezet voor het advertentieverzoek. Meer informatie over de privacybehandeling voor uitgevers Voorbeeld van gebruik Zo zet u advertentiepersonalisatie uit: ppt=1
ppid (door de uitgever verstrekte ID)	De parameter voor door de uitgever verstrekte ID's (PPID) accepteert een variabele waarde van de ID die wordt gebruikt voor frequentielimieten, doelgroepsegmentering en -targeting, opeenvolgende advertentieroulatie, en andere beheeropties voor op doelgroepen gebaseerde advertentieweergave op verschillende apparaten. Voorbeeld van gebruik ppid=12JD92JD8078S8J29SDOAKC0EF230337
ppos (positie in pod)	De parameter voor positie in een podaccepteert een variabele waarde die de positie binnen een pod vertegenwoordigt (bijvoorbeeld positie 1, positie 2 enzovoort). Deze parameter is alleen bedoeld voor standaardpods en is nodig voor automatisch invullen van begeleidend materiaal. Voorbeeld van gebruik ppos=2 Vereiste Vereist voor een juiste werking van concurrentie-uitsluitingen, frequentielimieten en gerelateerde functies.
ppsj (JSON voor door de uitgever verstrekte signalen)	De json-parameter voor door de uitgever verstrekte signalen accepteert een base64-gecodeerd json-object met doelgroep- en contextuele gegevens die door de uitgever worden geleverd om het programmatic genereren van inkomsten te verbeteren. Meer informatie over door de uitgever verstrekte signalen en ondersteunde taxonomieën Bekijk de details van geldige json-sleutel/waarde-paren in het voorbeeld van de IMA-SDK voor HTML5. Voorbeeld van gebruik Json-object: {   "PublisherProvidedTaxonomySignals": [{      "taxonomy": "IAB_AUDIENCE_1_1",      "values": ["6", "284"]   }] } Base64-gecodeerde waarde: eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ
ptpl (ID van template voor advertentie-onderbreking) ptpln (Naam van template voor advertentie-onderbreking)	De ID en naam van de template voor advertentie-onderbreking accepteren variabelewaarden en geven aan welke template voor advertentie-onderbreking moet worden toegepast op het geoptimaliseerde podverzoek. Met templates voor advertentie-onderbreking kunt u aangeven welke advertentieplaatsingen of aangepaste advertentieplaatsingen moeten worden opgenomen in een advertentie-onderbreking en in welke volgorde deze moeten worden weergegeven. Er is maar 1 van de 2 parameters (naam of ID) vereist om een template voor advertentie-onderbreking aan te vragen. Voorbeeld van gebruik Hier vindt u meer informatie over het instellen en aanvragen van templates voor advertentie-onderbreking.
pubf (openbare minimumprijzen in Ad Exchange-tags) pvtf (privé-minimumprijzen in Ad Exchange-tags)	pubf is het equivalent van google_ad_public_floor en pvtf is het equivalent van google_ad_private_floor. Deze worden gebruikt om minimumprijzen toe te voegen aan Ad Exchange-tags. Voorbeeld van gebruik pubf=123 pvtf=123
pvid (app-set-ID) pvid_s (app-set-bereik)	De waarden van de app-set-ID zijn nodig om inkomsten te genereren als gebruikers zich op Android-apparaten afmelden voor personalisatie. De parameter pvid accepteert een variabele waarde die is ingesteld op de Android-app-set-ID en de parameter pvid_s accepteert een constante waarde die het bereik van de app-set-ID vertegenwoordigt (scope_app of scope_developer). Hoewel de IMA-/PAL-SDK dit veld automatisch doorgeeft, moeten uitgevers met niet-SDK-implementaties de app-set-SDK aanroepen en deze parameters handmatig doorgeven in het advertentieverzoek. Bekijk de Android-documentatie over hoe u de app-set-ID kunt ophalen. Voorbeeld van gebruik pvid=[AppSetID_value] pvid_s=scope_app Vereiste Vereist voor apps Aanbevolen voor programmatic inkomsten genereren
rdid idtype is_lat (resetbare apparaat-ID's)	De opnieuw instelbare apparaat-ID's accepteren variabele waarden. Bij ingebouwde apps (niet op internet of mobiel internet) stuurt de SDK opnieuw instelbare apparaat-ID's voor gebruikerstargeting in uw streamverzoeken met de parameters voor rdid, idtype en is_lat. Bij SSB-streams moet u deze doorsturen als expliciete parameters, net als bij een advertentieverzoek aan de clientzijde. Meer informatie over apparaat-ID's. Voor vrijwel alle programmatic videoadvertenties is de aanwezigheid van deze waarden vereist. Vanaf iOS 14.5 heeft Apple het LAT-signaal beëindigd. Google vertrouwt in plaats daarvan op de aanwezigheid van een IDFA die niet nul is, om aan te geven dat de gebruiker toestemming heeft gegeven voor tracking in versies van iOS die App-trackingtransparantie ondersteunen. Daarom is een geldige UserAgent vereist die de juiste OS-versie aangeeft. Voorbeeld van gebruik Bekijk gedetailleerde voorbeelden van opnieuw instelbare apparaat-ID's. Vereiste Vereist voor apps Aanbevolen voor programmatic inkomsten genereren
rdp (gegevensverwerking beperken)	De parameter voor beperkte gegevensverwerking accepteert een constante waarde om aan te geven dat het advertentieverzoek de gegevensverwerking moet beperken. U moet specifiek rdp=1 instellen of rdp (zonder een ingestelde waarde) opnemen om gegevensverwerking te beperken. Advertentieverzoeken die deze parameter niet bevatten of zijn ingesteld op rdp=0, worden niet beperkt, tenzij de netwerkinstelling Gegevensverwerking beperken aanstaat. Voorbeeld van gebruik rdp=1
schain (Toeleveringsketen)	De parameter voor de toeleveringsketen accepteert een variabele waarde die een geserialiseerd SupplyChain-object moet zijn. Als deze parameter is opgenomen, voegt Google een node toe aan alle ontvangen schain-objecten voordat deze naar kopers worden gestuurd. Bekijk de volledige IAB-documentatie voor de communicatie van SupplyChain-informatie via een tag (in plaats van OpenRTB). Bekijk de vereisten voor correcte parsering van schain Op basis van de IAB-documentatie definieert het volgende de serialisatie voor het SupplyChain-object: {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject en SupplyChainNode worden van elkaar gescheiden door komma's, zodat optionele velden kunnen worden weggelaten en komma's als scheidingstekens optioneel kunnen worden uitgesloten. Elk SupplyChainNode-element wordt gescheiden door een !. Als de waarde van een property tekens bevat waarvoor URL-codering is vereist (bijvoorbeeld , of !), moet de waarde vóór de serialisatie worden gecodeerd met een URL. Serialisatievolgorde SupplyChainObject-property's worden in deze volgorde geserialiseerd: ver,complete SupplyChainNode-property's worden in deze volgorde geserialiseerd: asi,sid,hp,rid,name,domain,ext Opmerking: De inhoud van ext is exchange-specifiek. Google Ad Manager parseert deze property niet. Voorbeelden van hoe u het SupplyChain-object serialiseert Hieronder staan 2 voorbeelden van manieren om het bovenstaande SupplyChain-object te serialiseren: Serialiseren met komma's voor lege optionele velden 1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,, Serialiseren zonder komma's voor lege optionele velden 1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1 Meer informatie over het SupplyChain-object Gebruiksvoorbeelden schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,, Als de waarde voor asi exchange,1 was, ziet de serialisatie met escape-tekens er zo uit: 1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1 Vereiste Vereist voor uitgevers die betalingsbemiddelaars gebruiken vóór het verzoek aan Google Ad Manager. Dit geldt ook voor uitgevers die advertentieservertechnologie van derden gebruiken.
scor (stream-correlator)	De parameter voor stream-correlator accepteert een variabele waarde die een geheel getal moet zijn dat voor elke videostream wordt gegenereerd.Het getal moet hetzelfde zijn binnen een stream en uniek zijn in een paginaweergave. Dit getal wordt gebruikt voor concurrentie-uitsluitingen, frequentielimieten en gerelateerde functies als een gebruiker meerdere video's op dezelfde pagina bekijkt. Voorbeeld van gebruik scor=17 Vereiste Vereist voor een juiste werking van concurrentie-uitsluitingen, frequentielimieten en gerelateerde functies.
sdk_apis (SDK API-framework)	De parameter voor SDK API-framework accepteert een door komma's gescheiden lijst met constante gehele getallen die alle API-frameworks aangeven die de speler ondersteunt. Bekijk een lijst met mogelijke waarden voor API-frameworks. Deze parameter ondersteunt API's in de Programmatic Access Library (PAL) voor uitgevers die de IMA-SDK niet gebruiken. De IMA-SDK overschrijft alle waarden die zijn ingesteld met de waarden die worden ondersteund door de IMA-SDK. Voorbeeld van gebruik sdk_apis=2,7,9
sdmax (max. duur voor advertenties die kunnen worden overgeslagen)	De advertentieverzoekparameter sdmax (max. duur voor advertenties die kunnen worden overgeslagen) accepteert een variabele waarde waarmee uitgevers de gewenste maximale advertentieduur kunnen opgeven voor de advertenties die kunnen worden overgeslagen. De parameter gebruikt een duur in milliseconden die staat voor de bovengrens die moet worden toegestaan voor de duur van video-/audioadvertentiemateriaal dat kan worden overgeslagen voor dat specifieke advertentieverzoek. Gebruik sdmax onafhankelijk voor advertenties die kunnen worden overgeslagen of in combinatie met de bestaande parameter max_ad_duration om verschillende max. duur aan te geven voor advertenties die wel en niet kunnen worden overgeslagen. Voorbeeld van gebruik De volgende instellingen gebruiken: max_ad_duration = 15.000 (15 seconden) sdmax = 45.000 (45 seconden) Voor het volgende advertentiemateriaal: Advertentiemateriaal A: kan niet worden overgeslagen; 30 s Advertentiemateriaal B: kan worden overgeslagen, 30 s Resulteert in: Advertentiemateriaal A wordt gefilterd omdat het niet kan worden overgeslagen en de duur ervan langer is dan het maximum voor (kan niet worden overgeslagen). Advertentiemateriaal B wordt niet gefilterd omdat hoewel de duur langer is dan max_ad_duration, het kan worden overgeslagen en de duur ervan niet langer is dan het maximum dat kan worden overgeslagen.
sid (sessie-ID)	De parameter voor sessie-ID accepteert een variabele waarde die een privacybehoudende advertentie-ID is die uitsluitend wordt gebruikt voor frequentielimieten. De sessie-ID wordt ondersteund voor verzoeken voor in-stream video van verbonden tv's en voor in-stream videovoorraad van apparaten met mobiele apps. Dit wordt momenteel niet ondersteund voor het web. Volgens de IFA-richtlijnen van het IAB moet deze parameter worden ingevuld in UUID-indeling. Bekijk meer informatie over opnieuw in te stellen apparaat-ID's voor gebruikerstargeting. U kunt zich afmelden voor het doorgeven van de sessie-ID door sid=0 in te stellen. Voorbeeld van gebruik 123e4567-e89b-12d3-a456-426614174000 Vereiste Aanbevolen voor programmatic inkomsten genereren
ssss (samenvoegingsbron aan de serverzijde)	De parameter voor de samenvoegingsbron aan de serverzijde accepteert een constante waarde die moet worden ingesteld op een herkende, door Google geleverde waarde voor uw leverancier van technologie voor videosamenvoeging. Leveranciers van technologie voor videosamenvoeging die integraties tussen servers met Google gebruiken, krijgen deze waarde van Google en kunnen deze aan u leveren. Neem contact op met uw Google-accountmanager als u vragen heeft over de waarde die u voor deze parameter instelt. Voorbeeld van gebruik ssss=mystitcher Vereiste Vereist voor implementaties aan de serverzijde
sz (formaat)	De parameter voor grootte accepteert een variabele waarde die moet worden ingesteld op de grootte van de primaire videoadvertentieruimte. Meerdere formaten moeten van elkaar worden gescheiden met een sluisteken (|). Voeg geen v toe na het formaat. Voorbeeld van gebruik sz=400x300 Vereiste Vereist voor internet en apps Deze parameter is optioneel als uitsluitend ad_type=audio wordt aangevraagd.
tfcd (tag voor op kinderen gerichte content)	De parameter voor op kinderen gerichte content accepteert een constante waarde waarmee het advertentieverzoek wordt getagd voor behandeling van content die bedoeld is voor kinderen Voorbeeld van gebruik tfcd=1
trt (verkeerstype)	De parameter voor het verkeerstype accepteert een constante waarde die functioneert om gekocht of organisch verkeer aan te vragen. De IMA-SDK vult geen standaardwaarde in als de parameter voor het verkeerstype ontbreekt in een verzoek. In deze gevallen levert de server de standaardwaarde 0 (niet-gedefinieerd verkeer). Voorbeeld van gebruik Verzoek voor gekocht verkeer: trt=1 Verzoek voor organisch verkeer: trt=2
unviewed_position_start (vertraagde vertoningen)	De parameter voor vertraagde vertoningen accepteert een constante waarde om vertraagde vertoningen voor video's aan te geven. Voorbeeld van gebruik unviewed_position_start=1 Vereiste Vereist voor internet en apps
url (URL)	De URL-parameter accepteert een variabele waarde die moet worden ingesteld op de volledige URL waar het verzoek vandaan wordt verstuurd. Deze waarde is nodig zodat kopers de context kunnen herkennen en begrijpen van waar dit verzoek vandaan komt. Voor zover mogelijk moet deze waarde dynamisch worden ingevuld in het advertentieverzoek. Op een webpagina is dit de URL van de pagina waarop de videospeler wordt weergegeven. Als u de IMA-SDK gebruikt, wordt de URL-waarde automatisch ingesteld. Als uw speler deze waarde instelt, houdt de IMA-SDK rekening met de waarde die wordt ingesteld. In een app (mobiel of CTV) moet deze waarde worden ingesteld op een URL die het nauwkeurigst de video- of audiovoorraad weergeeft waarmee inkomsten worden gegenereerd. Als de gebruiker bijvoorbeeld in een mobiele app een video bekijkt die ook beschikbaar is op een desktop-equivalente URL.* De waarde van deze parameter moet worden gecodeerd. Voorbeeld van gebruik url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Als het voor apps niet mogelijk is om deze parameter in te stellen op een variabele URL-waarde, raden we u aan deze in te stellen met het volgende patroon: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Vereiste Vereist voor internet en apps Aanbevolen voor programmatic inkomsten genereren
vad_type (type videoadvertentie)	De parameter voor videoadvertentietype accepteert een constante waarde om aan te geven of er een lineaire of niet-lineaire advertentie moet worden geretourneerd. Voorbeeld van gebruik Lineaire advertentie retourneren: vad_type=linear Niet-lineaire advertentie retourneren: vad_type=nonlinear
vid_d (videoduur)	Deze parameter accepteert een variabele waarde die de duur van de content aangeeft (in seconden). De parameters vid_d en allcues worden gebruikt om midroll-advertenties zonder contentopname weer te geven. Advertentieregels zijn ook vereist om midrolls te retourneren. Voorbeeld van gebruik Videocontentduur van 90.000 seconden (25 uur): vid_d=90000
vconp (video continu afspelen)	Aanbevolen in overeenstemming met de MRC-richtlijnen voor videometing De parameter voor doorlopende video accepteert een constante waarde om aan te geven of de speler videocontent continu moet afspelen, net als bij een tv-uitzending. Deze parameter moet niet worden ingesteld als deze onbekend is. Voorbeeld van gebruik Continu afspelen AAN: vconp=2 Continu afspelen UIT: vconp=1
vpa (video automatisch afspelen)	Aanbevolen op basis van MRC-richtlijnen voor het meten van video's De parameter voor automatisch afspelen van video's accepteert een constante waarde om aan te geven of videocontent in een advertentie wordt gestart via autoplay of klikken. Mogelijke waarden zijn click als de pagina wacht op een gebruikersactie of auto als de video automatisch wordt afgespeeld. Deze parameter moet niet worden ingesteld als deze onbekend is. Voorbeeld van gebruik Automatisch afspelen: vpa=auto Click-to-play: vpa=click Vereiste Aanbevolen voor programmatic inkomsten genereren
vpi (inred-parameter voor videoplaylist, video playlist inred)	De inred-parameter voor videoplaylists accepteert een constante waarde om aan te geven of inline VMAP moet worden weergegeven (VAST retourneren binnen VMAP). Deze parameter kan worden gebruikt om de wachttijd te verkorten en frequentielimieten en concurrentie-uitsluitingen voor een videostream te garanderen. Voorbeeld van gebruik VAST retourneren: vpi=1 Omleidingen retourneren: vpi=0
vpmute (video zonder geluid afspelen)	Aanbevolen op basis van MRC-richtlijnen voor het meten van video's De parameter voor gedempte video accepteert een constante waarde om aan te geven of de advertentieweergave start terwijl de videospeler is gedempt. Voorbeeld van gebruik Gedempt: vpmute=1 Dempen opgeheven: vpmute=0 Vereiste   Vereist voor internet en inkomsten genereren met Programmatic
vpos (videopositie)	De parameter voor videopositie accepteert een constante waarde om aan te geven of het advertentieverzoek is verstuurd via preroll, midroll of postroll. Voorbeeld van gebruik Preroll: vpos=preroll Midroll: vpos=midroll Postroll: vpos=postroll Vereiste Aanbevolen voor programmatic inkomsten genereren
wta (Waarom deze advertentie?)	De parameter 'Waarom deze advertentie?' accepteert een constante waarde die aangeeft of de videospeler het renderen van advertentiebadges ondersteunt. Als er geen &wta-parameter wordt gestuurd, wordt deze standaard ingesteld op &wta=1. De functionaliteit voor advertentiebadges wordt automatisch ondersteund als u de IMA-SDK gebruikt. Als u de IMA-SDK niet gebruikt, moeten videospelers ondersteuning voor VAST Icon en IconClickFallbackImage implementeren, zoals beschreven in de IAB VAST-norm. Uitgevers moeten &wta=0 sturen als de uitgever het Info-icoon niet rendert, zoals verstrekt in de VAST-reactie. Als een advertentieverzoek &wta=1 of geen &wta-parameter bevat, wordt ervan uitgegaan dat dit aangeeft dat de uitgever de verstrekte Info-informatie rendert. Audioadvertentieverzoeken kunnen wta=1 sturen als het Info-icoon, zoals verstrekt in de VAST-reactie, wordt gerenderd bij begeleidende advertenties of op een andere manier aan de gebruiker wordt geleverd. Voor verkeer uit de EER komen verzoeken met &wta=0 niet in aanmerking voor reserveringsadvertentiemateriaal waarvoor Google-badges aanstaan. Advertenties moeten voldoen aan de toepasselijke wettelijke vereisten voor advertenties die worden weergegeven in de Europese Economische Ruimte (EER). Hieronder valt ook een mechanisme waarmee gebruikers illegale content kunnen melden. Uitgevers moeten via het juiste formulier melding doen bij Google over illegale content. Voorbeeld van gebruik Ondersteund: wta=1 of geen wta-parameter Niet ondersteund: wta=0 Vereiste Vereist voor Ad Exchange Vereist voor EER-verkeer voor web en app Aanbevolen voor programmatic inkomsten genereren