Povinné a doporučené parametry pro web

Implementace řešení videí založeného na značkách pro poptávku Ad Exchange bez použití sady IMA SDK je momentálně ve verzi beta a nemusí být ve vaší síti k dispozici. Další informace vám poskytne váš správce účtu.

Níže uvádíme podmnožinu parametrů adres URL značek reklam VAST. Tyto parametry jsou určeny pro řešení videí pro web založených na značkách bez integrace se sadou IMA SDK.

Můžete si také prohlédnout seznam povinných parametrů pro aplikace nebo povinných a doporučených parametrů pro programatické zpeněžování.

 Přeskočte na konkrétní parametr v seznamu

correlator description_url env gdfp_req iu

output plcmt sz unviewed_position_start

url vpa vpmute wta

 

Parametr	Podrobnosti
correlator (Korelátor)	Pomocí parametru korelátoru se předává proměnná hodnota, která je společná pro několik žádostí pocházejících ze stejného zobrazení stránky. Používá se k vyloučení reklam konkurence, a to i v prostředích bez podpory souborů cookie. Při použití sady IMA SDK se hodnota parametru correlator nastavuje automaticky. Pokud se tuto hodnotu pokusí nastavit přehrávač, sada SDK ji přepíše svojí vlastní hodnotou Pokud nepoužíváte sadu IMA SDK, zajistěte, abyste tuto hodnotu nastavovali na skutečně náhodné kladné celé číslo, které nebude použito opakovaně pro více zobrazení stránek. Příklad použití correlator=4345645667 Požadavek Povinné pro web a aplikace Doporučeno pro programatické zpeněžování
description_url (Adresa URL popisu)	Parametr adresy URL popisu se nastavuje na proměnnou hodnotu, která by měla popisovat video přehrávané na stránce. Rozvrhněte stránku v 1–3 odstavcích s popisem obsahu. Můžete například dynamicky sešít obsah stránky description_url z předdefinovaných bloků. Další informace o poskytnutí samostatné adresy URL popisu U přehrávačů videí na webových stránkách, televizích připojených k internetu a zařízení over-the-top musí být hodnota description_url zakódována pro URL a u přehrávačů videí v mobilních aplikacích nesmí být zakódována. Sada IMA SDK tento parametr nenastavuje automaticky. Je třeba ho nastavit ručně. Příklad použití Zakódováno pro URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Nezakódováno: description_url= https://www.sample.com/golf.html Požadavek Povinné pro web, aplikace a Ad Exchange Doporučeno pro programatické zpeněžování
env (Prostředí)	Pomocí parametru prostředí se předává konstantní hodnota, která udává, buď že se jedná o žádost o reklamu in-stream, nebo že žádost pochází konkrétně z přehrávače videa. Možné hodnoty jsou instream (lze použít pro videoreklamy a audioreklamy) a vp (lze použít pouze pro videoreklamy). Příklad použití Video nebo zvuk: env=instream Pouze video: env=vp Požadavek Povinné pro web a aplikace
gdfp_req (Indikátor schématu služby Ad Manager)	Pomocí parametru indikátoru schématu služby Ad Manager se předává konstantní hodnota, která udává, že uživatel podporuje schéma služby Ad Manager. Příklad použití gdfp_req=1 Požadavek Povinné pro web a aplikace
iu Reklamní jednotka	Pomocí parametru reklamní jednotky se předává proměnná hodnota, která by měla být nastavena na aktuální reklamní jednotku v následujícím formátu: /network_code/.../ad_unit Příklad použití iu=/6062/videodemo Požadavek Povinné pro web a aplikace
output (Výstupní formát reklamy)	Pomocí parametru výstupního formátu reklamy se předává konstantní hodnota, kterou je potřeba nastavit na výstupní formát reklamy. Pro výchozí verzi šablony VAST nastavenou pro síť použijte hodnotu output=vast. Pro konkrétní značky reklam nebo části webu můžete žádat o konkrétní verze VAST nebo VMAP. Pokud přehrávač používá sadu IMA SDK, bude u šablony VAST parametr výstupu pro žádost o videoreklamu vždy nastaven na možnost output=xml_vast4. Nepředstavuje to žádné riziko pro spolehlivost, protože sada SDK je zpětně kompatibilní se všemi verzemi formátu VAST, které reklamní server třetí strany může zobrazit. Pokud chcete použít výchozí verzi VMAP (například VMAP 1), kterou máte aktivovanou pro síť, použijte output=vmap. Pokud v šabloně VMAP odesíláte šablonu VAST, můžete pomocí hodnot xml_vmap1_vast3 nebo xml_vmap1_vast4 zadat, která verze šablony VAST se má odeslat. Příklad použití Výchozí nastavení šablony VAST sítě: output=vast VAST 4: output=xml_vast4 Výchozí nastavení verze VMAP sítě: output=vmap VMAP 1: output=xml_vmap1 VMAP 1, vrací VAST 4: output=xml_vmap1_vast4 Požadavek Povinné pro web a aplikace
plcmt (Umístění)	Pomocí parametru umístění se předává konstantní hodnota, která udává, zda je inventář in-stream deklarován jako in-stream, nebo doprovodný (podle pokynů ve specifikacích organizace IAB). U žádostí jiného typu než in-stream se toto pole pro kupující vyplňuje automaticky na základě deklarovaného formátu inventáře a případnou deklaraci obsahu in-stream nebo doprovodného obsahu přepíše. Příklad použití Žádost z umístění in-stream: plcmt=1 Žádost z umístění v doprovodném obsahu: plcmt=2 Požadavek Povinné pro web a programatické zpeněžování
sz (Velikost)	Pomocí parametru velikosti se předává proměnná hodnota, která musí být nastavena na velikost bloku hlavní videoreklamy. Více velikostí je potřeba oddělit znakem svislé čáry (|). Za velikostí neuvádějte písmeno „v“. Příklad použití sz=400x300 Požadavek Povinné pro web a aplikace Pokud žádáte pouze o zvukové reklamy (ad_type=audio), je tento parametr volitelný.
unviewed_position_start (Zpožděná zobrazení)	Pomocí parametru zpožděných zobrazení se předává konstantní hodnota, která značí zpožděná zobrazení videa. Příklad použití unviewed_position_start=1 Požadavek Povinné pro web a aplikace
url (Adresa URL)	Pomocí parametru adresy URL se předává proměnná hodnota, která by měla být nastavena na úplnou adresu URL, z níž byla žádost odeslána. Tato hodnota je potřeba k tomu, aby kupující poznali, ze kterého kontextu tato žádost pochází. Pokud je to možné, měla by být tato hodnota u žádosti o reklamy vyplněna dynamicky.  U webové stránky se jedná o adresu URL stránky, na které se zobrazuje přehrávač videí. Pokud používáte sadu IMA SDK, nastavuje se hodnota parametru URL automaticky. Pokud tuto hodnotu nastaví přehrávač, sada IMA SDK bude nastavenou hodnotu respektovat. V aplikaci (pro mobilní zařízení nebo televize připojené k internetu) by tato hodnota měla být nastavena na adresu URL, která nejlépe reprezentuje zpeněžovaný videoinventář nebo zvukový inventář. Pokud se například uživatel dívá na video v mobilní aplikaci, která je k dispozici také ve formě adresy URL pro počítače, měl by být tento parametr nastaven na příslušnou adresu URL.* Hodnota tohoto parametru by měla být zakódována. Příklad použití url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Pokud tento parametr u aplikací nelze nastavit na proměnnou hodnotu adresy URL, doporučujeme použít hodnotu v následujícím formátu: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Požadavek Povinné pro web a aplikace Doporučeno pro programatické zpeněžování
vpa (Automatické přehrávání videí)	Doporučeno v pokynech rady MRC k měření videí Pomocí parametru automatického přehrávání se předává konstantní hodnota, která udává, zda se reklama ve videoobsahu spouští automaticky, nebo kliknutím. Možné hodnoty jsou click, pokud stránka čeká na akci uživatele, nebo auto, pokud se video začne přehrávat automaticky. Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený. Příklad použití Automatické přehrání: vpa=auto Přehrání kliknutím: vpa=click Požadavek Doporučeno pro programatické zpeněžování
vpmute (Přehrání videa s vypnutým zvukem)	Doporučeno v pokynech rady MRC k měření videí Pomocí parametru videa s vypnutým zvukem se předává konstantní hodnota, která udává, zda se reklama začne přehrávat, když je v přehrávači videa vypnutý zvuk. Příklad použití Vypnutý zvuk: vpmute=1 Zapnutý zvuk: vpmute=0 Požadavek Povinné pro web a programatické zpeněžování
wta (Proč tato reklama)	Pomocí parametru zprávy „Proč tato reklama?“ se předává konstantní hodnota, která udává, zda přehrávač videa podporuje zobrazení odznaku reklamy. Pokud parametr &wta není odeslán, použije se výchozí hodnota &wta=1. Při použití sady IMA SDK je funkce označování reklam podporována automaticky. Pokud se nepoužívá sada IMA SDK, musí přehrávače videa implementovat podporu prvků Icon a IconClickFallbackImage podle dokumentace ve standardu IAB VAST. Pokud majitel stránek ikonu AdChoices zahrnutou v odpovědi VAST nevykreslí, musí odeslat parametr &wta=0. Pokud žádost o reklamu zahrnuje parametr &wta=1 nebo parametr &wta​ nezahrnuje, znamená to, že majitel stránek poskytnuté informace AdChoices vykreslí. U žádostí o zvukové reklamy je parametr wta=1 povoleno odeslat v případě, že bude ikona AdChoices z odpovědi VAST vykreslena v doprovodných reklamách nebo jinak poskytnuta uživateli. U provozu z EHP nebudou žádosti s parametrem &wta=0 způsobilé pro rezervační kreativy, u kterých je zapnuté označování reklam od Googlu. Reklamy musí splňovat příslušné regulační požadavky na reklamy zobrazované v Evropském hospodářském prostoru (EHP). To zahrnuje mechanismus, pomocí něhož mohou uživatelé nahlásit nezákonný obsah. O případných nahlášení nezákonného obsahu musí vydavatelé společnost Google informovat pomocí příslušného formuláře. Příklad použití Podporováno: wta=1 nebo bez parametru wta Nepodporováno: wta=0 Požadavek Povinné pro Ad Exchange Povinné pro návštěvnost webů a aplikací z EHP Doporučeno pro programatické zpeněžování