Produkty AdSense pro video i AdSense pro hry používají velmi odlišnou strukturu značek, než jaká se používá v produktu AdSense pro obsah. Oba tyto produkty vyžadují značku Interaktivní mediální reklamy (IMA) a reklamy zobrazují pouze tehdy, když jsou vyvolány videopřehrávačem nebo spouštěčem her, který umožňuje integraci sady IMA SDK společnosti Google nebo splňuje normy VAST a VPAID (například Adaptér IMA).
Tyto značky lze obvykle vytvořit pomocí generátoru značek AdSense pro hry. Níže uvádíme podrobný seznam různých kritérií, která můžete u těchto značek reklamy nastavit. Značka AdSense pro hry má jen pár povinných parametrů pro zobrazování reklam, ale požadovaných reakcí na reklamu lze dosáhnout přidáním nepovinných parametrů, například čísla kanálu, min. a max. trvání reklamy, jazyka atd.
| Parametr značky reklamy pro IMA | Je parametr povinný? |
|---|---|
| ad_type | Ano |
| client | Ano |
| description_url | Ano – je třeba zadat ve formátu adresy URL |
| channel | Ne – Pokud je však k dispozici, doporučuje se |
| adsafe | Ne – Doporučeno |
| videoad_start_delay | Ne – Doporučeno |
| hl | Ne – Doporučeno |
| max_ad_duration | Ne – Doporučeno |
| min_ad_duration | Ne – Doporučeno |
| sdmax | Ne – Doporučeno |
| adtest | Ne |
| cust_age | Ne |
| cust_gender | Ne |
| host | Ne |
| h_ch | Ne |
Základní adresa URL
Následující adresa URL slouží jako základ pro všechny parametry v URL uvedené níže:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(Řetězec) Určuje typ požadované reklamy. Výrazy se spojují podtržítky („_“).
Hodnoty
- video: Všechny videoreklamy: Ekvivalent parametru standardvideo_skippablevideo_bumpervideo.
- skippablevideo: Pouze přeskočitelné videoreklamy. Parametr může vyžadovat dodatečná oprávnění majitele stránek k příjmu přeskočitelných reklam.
- bumpervideo: Umožňuje šestisekundové nepřeskočitelné videoreklamy.
- standardvideo: Pouze nepřeskočitelné videoreklamy.
- image: Umožňuje grafické reklamy, které se vejdou do určené nelineární velikosti bloku.
- text: Umožňuje textové reklamy.
Příklady
- &ad_type=video_text_image
- Umožňuje všechny formáty.
- &ad_type=video_text
- Umožňuje všechny formáty videoreklamy a textové reklamy.
- &ad_type=standardvideo_image
- Umožňuje pouze standardní nepřeskočitelné videoreklamy a grafické reklamy.
client
(Řetězec) Identifikátor webové služby majitele stránek.
Příklad: &client=ca-games-pub-4968145218643279
description_url
(Řetězec) Úplná adresa URL ve formátu adresy URL stránky HTML s popisem videa. Hodnota description_url může být vytvořena dynamicky pomocí online nástroje pro kódování URL.
Příklad: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
Příklad adresy URL
Příklad adresy URL obsahující minimální povinné parametry: 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
Adresa vyžaduje videoreklamy pro majitele stránek, parametr ca-video-afvtest a adresu URL s popisem pro adresu http://myurl.com/page?key=value&key2=value2
channel
(Řetězec) Seznam kanálů s hodnotami oddělenými znaménkem plus, který se používá pro cílení a vytváření přehledů AdSense. Pro každou žádost o reklamu lze použít až pět kanálů.
Příklad: &channel=mychannel+otherchannel+targetingchannel
adsafe
(Řetězec) Určuje nastavení použité k filtrování zobrazovaných reklam. Výchozí hodnota je „high“.
Hodnoty:
- high („vysoká“ – výchozí hodnota) – Zobrazí se reklamy vhodné pro děti. Nezobrazí se reklamy nevhodné pro děti a reklamy se sexuálním a jiným obsahem jen pro dospělé.
- medium („střední“) – Zobrazí se reklamy vhodné pro děti a nevhodné pro děti (například reklamy na hazardní hry nebo léky na předpis). Nezobrazí se reklamy se sexuálním obsahem jen pro dospělé.
Příklad: &adsafe=high
adtest
(Řetězec) Určuje, zda se jedná o test implementace. Možné hodnoty jsou „on“ nebo „off“. Je-li nastavena hodnota „on“, nebudou se kliknutí a zobrazení v účtu AdSense pro video zaznamenávat. Tento parametr JE NEZBYTNĚ NUTNÉ používat při testování. Výchozí hodnota je „off“.
Hodnoty:
- off – (výchozí) Všechny reklamy se účtují normálně. Toto nastavení se používá při běžném provozu.
- on – Tímto nastavením zajistíte, že žádná reklama nebude během testování zaznamenávat zobrazení ani kliknutí.
Příklad: &adtest=on
videoad_start_delay
(Celé číslo) Doba v milisekundách po spuštění videa, po kterou se bude reklama přehrávat. Výchozí hodnota je ve videu, konkrétně „1“.
Hodnoty:
- -1 – Znamená reklamu za videem, která se zobrazí po přehrání obsahu.
- 0 – Znamená reklamu před videem, která se zobrazí před začátkem přehrávání obsahu.
- Kladné celé číslo – Znamená reklamu ve videu, která se zobrazí po příslušném počtu milisekund přehrávání videa.
Příklad:
- &videoad_start_delay=-1 – Reklama za videem
- &videoad_start_delay=15000 – Reklama se přehraje po 15 sekundách přehrávání obsahu.
cust_age
(Celé číslo) Určuje věk uživatele. Lze zadat přesný věk nebo věkovou skupinu (definice: com.google.ads.ima.api.Demographics).
Příklad:
- &cust_age=1001 – Věk 18–24
- &cust_age=38 – Přesně 38
cust_gender
(Celé číslo) Určuje pohlaví uživatele (definice: com.google.ads.ima.api.Demographics).
Hodnoty:
- 1 – Muž
- 2 – Žena
Příklad:
- &cust_gender=1 – Muž
- &cust_gender=2 – Žena
host
(Řetězec) Identifikátor hostitele pro trojcestné sdílení tržeb.
Příklad: &host=ca-host-test – Takto se tržby rozdělí s uvedeným hostitelem.
h_ch
(Řetězec) Seznam řetězců oddělených znaménkem plus představující identifikátory kanálů pro sdílení a vytváření přehledů AdSense pro daného hostitele.
Příklad: &h_ch=channel1+channel2+channel3 – Takto se pro daného hostitele cílí na další kanály a vytvářejí se pro ně přehledy.
ht_id
(Číslo) Číslo úrovně používané k určení míry sdílení tržeb mezi majitelem stránek a hostitelem.
Příklad: &ht_id=2 – Hostitel druhé úrovně.
hl
(Řetězec) Kód jazyka využívaný k vyžádání reklam v daném jazyce. Lze použít kódy podle standardů ISO 639-1 (dvoupísmenné) nebo ISO 639-2 (třípísmenné). Seznam platných kódů
Příklad:
- &hl=en – anglicky
- &hl=es – španělsky
max_ad_duration
(Celé číslo) Určuje v milisekundách maximální délku videa, která se musí přehrát. Výchozí hodnota je 100 milisekund.
Příklad: &max_ad_duration=30000 – Maximální délka nepřeskočitelné reklamy bude 30 sekund.
min_ad_duration
(Celé číslo) Určuje v milisekundách minimální délku videa, která se musí přehrát. Výchozí hodnota je 0 sekund.
Příklad:
- &min_ad_duration=15000 – Délka přehrané nepřeskočitelné reklamy musí být alespoň 15 sekund.
- &min_ad_duration=0 – Délku videa bude omezovat pouze parametr max_ad_duration.
sdmax
(Celé číslo) Určuje v milisekundách maximální délku videa pro přeskočitelné reklamy. Výchozí hodnota je neomezená.
Příklad: &sdmax=120000 – Délka přehrané přeskočitelné reklamy nepřekročí 2 minuty.
