AdSense voor video en AdSense voor games gebruiken een heel andere tagstructuur dan AdSense voor inhoud. Ze vereisen een IMA-tag (Interactive Media Ads) en retourneren alleen advertenties wanneer ze worden aangeroepen met een video- of gamespeler die integratie biedt met de IMA-SDK van Google en/of voldoet aan VAST en VPAID (bijvoorbeeld de IMA Adapter).
Deze tags maakt u normaal gesproken met de taggenerator voor AdSense voor games. Hieronder vindt u een uitgebreide lijst van de diverse criteria die u voor deze advertentietags kunt hanteren. Er zijn maar een paar parameters verplicht om advertenties te kunnen weergeven via een AdSense voor games-tag, maar door toevoeging van optionele parameters zoals kanaal-ID's, minimale/maximale advertentieduur, taal enzovoort, kunt u ervoor zorgen dat u precies de gewenste advertentiereacties krijgt.
| IMA-parameter voor advertentietag | Vereiste parameter |
|---|---|
| ad_type | Ja |
| client | Ja |
| description_url | Ja, moet als URL zijn gecodeerd |
| channel | Nee, aanbevolen indien beschikbaar |
| adsafe | Nee, aanbevolen |
| videoad_start_delay | Nee, aanbevolen |
| hl | Nee, aanbevolen |
| max_ad_duration | Nee, aanbevolen |
| min_ad_duration | Nee, aanbevolen |
| sdmax | Nee, aanbevolen |
| adtest | Nee |
| cust_age | Nee |
| cust_gender | Nee |
| host | Nee |
| h_ch | Nee |
Basis-URL
De volgende URL vormt de basis van alle queryparameters die hieronder worden beschreven:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(Tekenreeks) Geeft het gewenste type advertentie aan. Moet worden samengesteld met een underscore ('_').
Waarden
- video: alle videoadvertenties; gelijk aan standardvideo_skippablevideo_bumpervideo.
- skippablevideo: alleen videoadvertenties die kunnen worden overgeslagen. Hiervoor is mogelijk aanvullende toestemming van de uitgever vereist voor het ontvangen van advertenties die kunnen worden overgeslagen.
- bumpervideo: staat videoadvertenties van zes seconden toe die niet kunnen worden overgeslagen.
- standardvideo: alleen videoadvertenties die niet kunnen worden overgeslagen.
- image: staat beeldadvertenties toe die passen binnen de opgegeven niet-lineaire afmetingen van de advertentieruimte.
- text: staat tekstadvertenties toe.
Voorbeelden
- &ad_type=video_text_image
- Staat alle indelingen toe.
- &ad_type=video_text
- Staat alle video-indelingen en tekstadvertenties toe.
- &ad_type=standardvideo_image
- Staat alleen standaard video- en beeldadvertenties toe die niet kunnen worden overgeslagen.
client
(Tekenreeks) De webproperty-ID van de uitgever.
Voorbeeld: &client=ca-games-pub-4968145218643279
description_url
(Tekenreeks) Een volledige, als URL gecodeerde URL van een HTML-pagina die de video beschrijft. De waarde description_url kan dynamisch worden gemaakt met de serverside-programmeertaal, of handmatig met behulp van een online URL-coderingstool.
Voorbeeld: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
URL-voorbeeld
Dit is een voorbeeld van een URL met de minimaal vereiste parameters: https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
Vraagt videoadvertenties aan voor de uitgever, ca-video-afvtest, met de beschrijvende URL http:// myurl.com/page?key=value&key2=value2
channel
(Tekenreeks) Een door middel van plustekens gescheiden lijst met kanalen voor AdSense-targeting en -rapportage. Per advertentieverzoek kunnen maximaal vijf kanalen worden opgenomen.
Voorbeeld: &channel=mychannel+otherchannel+targetingchannel
adsafe
(Tekenreeks) Bepaalt de instelling die wordt gebruikt voor het filteren van de advertenties die worden weergegeven. De standaardwaarde is 'high'.
Waarden:
- high -- (standaardwaarde) er worden gezinsvriendelijke advertenties weergegeven. Deze waarde geeft geen niet-gezinsvriendelijke advertenties en advertenties met inhoud voor volwassenen weer.
- medium -- er worden gezinsvriendelijke en niet-gezinsvriendelijke advertenties weergegeven (zoals advertenties voor kansspelen of voor geneesmiddelen op recept). Deze waarde geeft geen advertenties met content voor volwassenen weer.
Voorbeeld: &adsafe=high
adtest
(Tekenreeks) Geeft aan of dit een testimplementatie is. Mogelijke waarden zijn 'on' en 'off'. Als de waarde wordt ingesteld op 'on', worden vertoningen en klikken niet geregistreerd in het AdSense voor video-account. Deze parameter MOET tijdens het testen worden gebruikt. De standaardwaarde is 'off' als de parameter niet wordt ingesteld.
Waarden:
- off -- (standaardwaarde) alle advertenties worden normaal gefactureerd. Dit is de instelling die voor productie moet worden gebruikt.
- on -- met deze instelling zorgt u ervoor dat voor advertenties geen vertoningen of klikken worden geregistreerd tijdens het testen.
Voorbeeld: &adtest=on
videoad_start_delay
(Geheel getal) Het aantal milliseconden na het starten van de video waarna de advertentie wordt weergegeven. De specifieke standaardwaarde is de midroll-waarde '1'.
Waarden:
- -1 -- geeft een postroll-advertentie aan die aan het einde van de content wordt afgespeeld
- 0 -- geeft een preroll-advertentie aan die wordt weergegeven voordat weergave van de content begint
- Elk positief geheel getal -- geeft een midroll-advertentie aan die wordt weergegeven nadat dit aantal milliseconden voor het afspelen van content is verstreken.
Voorbeeld:
- &videoad_start_delay=-1 -- postroll-advertentie
- &videoad_start_delay=15000 -- de advertentie wordt weergegeven vanaf 15 seconden na het starten van de content.
cust_age
(Geheel getal) Geeft de leeftijd van de gebruiker aan. De exacte leeftijd wordt ondersteund, evenals een leeftijdsgroep die wordt gedefinieerd in incom.google.ads.ima.api.Demographics.
Voorbeeld:
- &cust_age=1001 -- leeftijd van 18 t/m 24
- &cust_age=38 -- precies 38
cust_gender
(Geheel getal) Geeft het geslacht van de gebruiker aan zoals gedefinieerd in com.google.ads.ima.api.Demographics.
Waarden:
- 1 -- mannelijk
- 2 -- vrouwelijk
Voorbeeld:
- &cust_gender=1 -- mannelijk
- &cust_gender=2 -- vrouwelijk
host
(Tekenreeks) Host-ID die wordt gebruikt voor het delen van inkomsten tussen drie partijen.
Voorbeeld: &host=ca-host-test -- de inkomsten worden gedeeld met deze host.
h_ch
(Tekenreeks) Een door middel van plustekens gescheiden lijst met tekenreeksen die de kanaal-ID's van de host voor AdSense-targeting en -rapportage vertegenwoordigen.
Voorbeeld: &h_ch=channel1+channel2+channel3 -- zorgt voor rapportage en targeting van deze aanvullende kanalen voor de host.
ht_id
(Getal) De niveau-ID die wordt gebruikt om de mate van inkomstendeling tussen uitgever en host op te geven.
Voorbeeld: &ht_id=2 -- host van niveau 2.
hl
(Tekenreeks) Een taalcode die wordt gebruikt voor het aanvragen van advertenties in de betreffende taal. Dit kan een ISO 639-1- (twee letters) of ISO 639-2-code (drie letters) zijn. Lijst met geldige codes.
Voorbeeld:
- &hl=en -- Engels
- &hl=es -- Spaans
max_ad_duration
(Geheel getal) Geeft de maximumlengte van de video aan, die moet worden geretourneerd in milliseconden. De standaardwaarde is 100 seconden als deze parameter niet wordt ingesteld.
Voorbeeld: &max_ad_duration=30000 -- de maximale duur van advertenties die niet kunnen worden overgeslagen, is 30 seconden.
min_ad_duration
(Geheel getal) Geeft de minimumlengte van de video aan, die moet worden geretourneerd in milliseconden. De standaardwaarde is 0 seconde als deze parameter niet wordt ingesteld.
Voorbeeld:
- &min_ad_duration=15000 -- de duur van een geretourneerde advertentie die niet kan worden overgeslagen moet 15 seconden of langer zijn.
- &min_ad_duration=0 -- de duur wordt alleen beperkt door de waarde max_ad_duration value.
sdmax
(Geheel getal) Geeft de maximumlengte van de video aan in milliseconden voor advertenties die kunnen worden overgeslagen. De standaardwaarde is 'onbeperkt' als deze parameter niet wordt ingesteld.
Voorbeeld: &sdmax=120000 -- de duur van de geretourneerde advertentie die kan worden overgeslagen mag niet langer zijn dan twee minuten.
