Az AdSense Videóhoz és az AdSense Játékokhoz termék teljesen más címkézési struktúrát használ, mint az AdSense Kontextusban. A két előbbi termék IMA (Interactive Media Ads, azaz interaktív multimédiás hirdetések) formátumú címkéket igényel, és csak akkor ad vissza hirdetéseket, ha olyan videolejátszóval vagy játékindítóval hívják meg, amely támogatja a Google IMA SDK integrálását, és/vagy megfelel a VAST és a VPAID szabványnak (példa: az IMA-adapter).
Ezeket a címkéket általában az AdSense Játékokhoz-címkegenerátorral hozzák létre. Az alábbiakban egy átfogó listát talál a különféle feltételekről, amelyek beállíthatók a hirdetési címkékhez. Csupán néhány kötelező paramétert kell megadni ahhoz, hogy az AdSense Játékokhoz-címkék megjelenítsenek; a kívánt hirdetésválaszokat azonban úgy kaphatja meg, ha választható paramétereket – például csatornaazonosítókat, a hirdetés minimális/maximális időtartamát, a nyelvet stb. – is beállít.
IMA hirdetési címke paramétere | Kötelező a paraméter? |
---|---|
ad_type | Igen |
client | Igen |
description_url | Igen – URL-kódolásúnak kell lennie |
channel | Nem – Ajánlott, ha rendelkezésre áll |
adsafe | Nem – Ajánlott |
videoad_start_delay | Nem – Ajánlott |
hl | Nem – Ajánlott |
max_ad_duration | Nem – Ajánlott |
min_ad_duration | Nem – Ajánlott |
sdmax | Nem – Ajánlott |
adtest | Nem |
cust_age | Nem |
cust_gender | Nem |
host | Nem |
h_ch | Nem |
Alap-URL
A következő URL képezi az alapját az alábbiakban leírt összes lekérdezési paraméternek:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(Karakterlánc) A kívánt hirdetés típusát adja meg. Ezeket aláhúzásjel („_”) segítségével kell összekapcsolni.
Értékek
- video: Az összes videóhirdetés: egyenértékű a standardvideo_skippablevideo_bumpervideo elemmel.
- skippablevideo: Csak átugorható videóhirdetések. További megjelenítői engedélyekre lehet szükség az átugorható hirdetések fogadásához.
- bumpervideo: Engedélyez hat másodperces nem átugorható videóhirdetéseket.
- standardvideo: Csak át nem ugorható videóhirdetések.
- image: Megengedi azon képes hirdetések használatát, amelyek elférnek a megadott méretű, nem lineáris hirdetéshelyen.
- text: Megengedi a szöveges hirdetések használatát.
Példák
- &ad_type=video_text_image
- Megengedi az összes formátum használatát.
- &ad_type=video_text
- Megenged bármilyen videoformátumot és szöveges hirdetést.
- &ad_type=standardvideo_image
- Csak a szokásos, nem átugorható videohirdetéseket és képes hirdetéseket engedi meg.
client
(Karakterlánc) A megjelenítő internetes tulajdonazonosítója.
Példa: &client=ca-games-pub-4968145218643279
description_url
(Karakterlánc) A videót leíró HTML-oldal teljes, URL-kódolt URL-címe. A description_url érték dinamikusan létrehozható a kiszolgáló oldali programnyelv használatával, illetve manuálisan is létrehozható egy online URL-kódolóeszköz használatával.
Példa: &description_url=http%3A%2F%2Fsajaturl.hu%2Foldal%3Fkulcs%3Dérték%26kulcs2%3Dérték2
URL-példa
Alább látható egy olyan példa-URL, amely tartalmazza a minimálisan szükséges. 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
A videóhirdetéseket a következő leírási URL-lel: http://sajaturl.hu/oldal?kulcs=érték&kulcs2=érték2
channel
(Karakterlánc) Az AdSense rendszerbeli célzásra és jelentéskészítésre használt csatornák pluszjellel elválasztott listája. Hirdetési kérelmenként legfeljebb öt csatorna adható át.
Példa: &channel=saját_csatorna+másik_csatorna+célzási_csatorna
adsafe
(Karakterlánc) Meghatározza a megjelenített hirdetések szűrésére használt beállítást. Az alapértelmezett értéke „high” (magas).
Értékek:
- high – (alapértelmezett érték) Csak korhatár nélküli hirdetéseket jelenít meg. Nem jelenít meg korhatáros vagy felnőtteknek szóló szexuális tartalmat.
- medium – Korhatár nélküli és korhatáros hirdetéseket is megjelenít (például szerencsejátékra vagy receptre kapható gyógyszerekre vonatkozó hirdetéseket). Nem jelenít meg felnőtteknek szánt, szexuális tartalmú hirdetéseket.
Példa: &adsafe=high
adtest
(Karakterlánc) Meghatározza, hogy ez egy teszt végrehajtása-e. Lehetséges értékek: „on” (bekapcsolva) vagy „off” (kikapcsolva). Ha az „on” értékre van állítva, a megjelenítéseket és a kattintásokat nem rögzíti a rendszer az AFV-fiókban. Ezt a paramétert a teszt során KÖTELEZŐ használni. Alapértelmezett értéke „off”, ha nincs beállítva.
Értékek:
- off – (Alapértelmezett) Minden hirdetés számlázása normál módon történik. Ezt a beállítást kell használni normál üzemben.
- on – Ez a beállítás biztosítja, hogy a hirdetések ne naplózzák a megjelenítéseket vagy a kattintásokat a tesztek során.
Példa: &adtest=on
videoad_start_delay
(Egész szám) A videó azon időpontja ezredmásodpercben, amelynél a hirdetés megjelenik. Alapértelmezésben egy felvétel közbeni értéket, az „1”-et veszi fel.
Értékek:
- -1 – videozáró videohirdetést határoz meg, amely a tartalom végén jelenik meg.
- 0 – tartalom előtti hirdetést határoz meg, amely a tartalom lejátszása előtt jelenik meg.
- Bármilyen pozitív egész szám – tartalom közbeni hirdetést határoz meg, amely a tartalom lejátszásának kezdete után a megadott ezredmásodpercnyi idő elteltével jelenik meg.
Példa:
- &videoad_start_delay=-1 – tartalom utáni hirdetés.
- &videoad_start_delay=15000 – a hirdetés a tartalom kezdete után 15 másodperccel jelenik meg.
cust_age
(Egész szám) A felhasználó korát jelenti. Megadható pontos kor, illetve a com.google.ads.ima.api.Demographics-ban meghatározott korcsoport.
Példa:
- &cust_age=1001 – 18–24 éves
- &cust_age=38 – pontosan 38 éves
cust_gender
(Egész szám) A felhasználó nemét határozza meg a com.google.ads.ima.api.Demographics szerint.
Értékek:
- 1 – Férfi
- 2 – Nő
Példa:
- &cust_gender=1 – Férfi
- &cust_gender=2 – Nő
host
(Karakterlánc) A háromirányú bevételmegosztáshoz használt gazdagép-azonosító.
Példa: &host=ca-host-test – A bevétel megosztása ezzel a gazdagéppel.
h_ch
(Karakterlánc) Karakterláncok pluszjelekkel elválasztott listája, amely a gazdagép AdSense-célzási vagy -jelentéskészítési csatornaazonosítóit tartalmazza.
Példa: &h_ch=csatorna11+csatorna12+csatorna13 – Ezeket a további csatornákat jelenti és célozza a rendszer a gazdagép esetén.
ht_id
(Szám) Szintazonosító, amellyel a megjelenítő és a gazdagép közötti bevételmegosztás határozható meg.
Példa: &ht_id=2 – 2. szintű gazdagép.
hl
(Karakterlánc) Nyelvi kód, amellyel az adott nyelven kérelmezhetők hirdetések. Ez lehet bármilyen ISO 639-1 (kétbetűs), vagy ISO 639-2 (hárombetűs) kód. Érvényes kódok listája.
Példa:
- &hl=hu – magyar.
- &hl=es – spanyol.
max_ad_duration
(Egész szám) Meghatározza a visszaadandó videók maximális hosszát ezredmásodpercben. Alapértelmezett értéke 100 másodperc, ha nincs beállítva.
Példa: &max_ad_duration=30000 – A nem átugorható hirdetések maximális időtartama 30 másodperc lesz.
min_ad_duration
(Egész szám) Meghatározza a visszaadandó minimális videohosszt ezredmásodpercben. Alapértelmezett értéke 0 másodperc, ha nincs beállítva.
Példa:
- &min_ad_duration=15000 – A visszaadott, nem átugorható hirdetés időtartamának legalább 15 másodpercnek kell lennie.
- &min_ad_duration=0 – Az időtartamot csak a max_ad_duration paraméter értéke korlátozza.
sdmax
(Egész szám) Meghatározza az átugorható hirdetések maximális videohosszát ezredmásodpercben. Alapértelmezett értéke a korlátlan, ha nincs beállítva.
Példa: &sdmax=120000 – A visszaadott átugorható hirdetés időtartama nem haladhatja meg a 2 percet.