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 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. Obvykle se jedná o stránku s přehrávačem videa, ale může to být i stránka s textem, který video popisuje. U přehrávačů videí na webových stránkách, televizí 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_id/.../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í
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í zprávy „Proč tato reklama?“. Při použití sady IMA SDK je funkce „Proč tato reklama?“ 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 bude ikona AdChoices, jak je uvedena v odpovědi VAST, vykreslena v doprovodných reklamách nebo jinak poskytnuta uživateli, měly by žádosti o zvukové reklamy odeslat parametr wta=1. Aby byly žádosti o reklamy způsobilé pro poptávku Google a rezervační návštěvnost hostovanou na Googlu v EHP, musí odesílat parametr wta=1, který značí, že se uživateli pro všechny kreativy zobrazuje ikona AdChoices (jak je poskytnuta v odpovědi VAST). Může se zobrazovat ve videoreklamě nebo v doprovodných reklamách nebo může být uživateli poskytnuta jiným způsobem. Příklad použití Podporováno: wta=1 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í