Povinné parametry pro aplikace

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 povinné u řešení videí pro aplikace založených na značkách bez integrace se sadou IMA SDK.

Můžete se podívat také na seznam povinných parametrů pro web a povinných parametrů pro aplikace.

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

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url 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
msid (ID aplikace) an (Název aplikace)	Pomocí parametrů ID aplikace a názvu aplikace se předávají proměnné hodnoty, které by měly být použity u žádostí odeslaných z mobilních aplikací a televizních zařízení připojených k internetu, protože jsou u většiny programatických videoreklam vyžadovány. Sada IMA SDK vyplní oba parametry automaticky. V prostředích bez sady SDK je však potřeba je zadat ručně. Týká se to i přímých volání šablony VAST, použití knihovny programatického přístupu (PAL) a inventáře ověřeného majitelem stránek (PAI). Název aplikace by měl být pro člověka čitelný. V systémech iOS a tvOS však sada SDK k ID aplikace nemá přístup. V těchto případech se parametr msid neodešle a sada SDK odešle balíček aplikace prostřednictvím parametru an. Příklad použití msid=com.package.publisher&an=sample%20app Název a formát ID aplikací se v jednotlivých obchodech s aplikacemi liší. Viz pokyny organizace IAB pro identifikaci aplikací nebo příklady běžných jedinečných identifikátorů. U platforem bez obchodu s aplikacemi organizace IAB majitelům obsahu doporučuje používat pro ID v obchodě následující formát: com.publisher.deviceplatform Požadavek Oba parametry jsou u aplikací povinné. Doporučeno pro programatické zpeněžování
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
pvid (ID sady aplikací) pvid_s (Rozsah sady aplikací)	Hodnoty ID sady aplikací jsou ke zpeněžení potřeba v případě, že se uživatelé na zařízeních Android odhlásí z personalizace. Pomocí parametru pvid se předává proměnná hodnota nastavená na ID sady aplikací pro Android a pomocí parametru pvid_s se předává konstantní hodnota, která představuje rozsah ID sady aplikací (buď scope_app, nebo scope_developer). Sada IMA/PAL SDK toto pole předává automaticky. Majitelé stránek s implementací bez sady SDK však musí zavolat sadu SDK sady aplikací a tyto parametry v žádosti o reklamu předat ručně. Viz informace o načtení ID sady aplikací v dokumentaci pro Android. Příklad použití pvid=[AppSetID_value] pvid_s=scope_app Požadavek Povinné pro aplikace Doporučeno pro programatické zpeněžování
rdid idtype is_lat (Resetovatelné identifikátory zařízení)	Pomocí resetovatelných identifikátorů zařízení se předávají proměnné hodnoty. U nativních aplikací sada SDK do žádostí o streamy pomocí parametrů rdid, idtype a is_lat předává resetovatelné identifikátory zařízení k cílení na uživatele. (U webů a mobilních webů tyto identifikátory nepředává.) U streamů SSB tyto identifikátory musíte předávat jako explicitní parametry, jako byste to dělali v případě žádosti o reklamy na straně klienta. Další informace o identifikátorech zařízení Tyto hodnoty jsou vyžadovány téměř u všech programatických videoreklam. Od systému iOS 14.5 společnost Apple ukončila podporu signálu LAT. Google místo toho spoléhá na přítomnost nenulového identifikátoru IDFA, který značí, že uživatel souhlasil se sledováním ve verzích systému iOS, které podporují transparentnost měření aplikací. Je proto vyžadována platná hodnota UserAgent udávající správnou verzi operačního systému. Příklad použití Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení. Požadavek Povinné pro aplikace Doporučeno pro 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í
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í