Povinné a doporučené parametry pro programatické zpeněžování

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í videoreklam založená na značkách pro programatický prodej bez integrace se sadou IMA SDK.

Podívejte se na seznam povinných a doporučených parametrů pro web nebo povinných parametrů pro aplikace.

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

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Parametr	Podrobnosti
hl (Jazyk)	Pomocí parametru jazyka se předává konstantní hodnota, která se používá k žádání o reklamy v určitém jazyce a k určení jazyka pro výběr reklam a vykreslování videoreklam v dynamické alokaci pro služby Ad Exchange a AdSense pro video. Hodnota parametru může být libovolný kód ISO 639-1 (dvoupísmenný) nebo ISO 639-2 (třípísmenný). Viz seznam platných kódů. V případě vynechání tohoto parametru se použije hodnota libovolného jazyka s cílením reklam podle jazyka v Ad Exchange. Příklad použití hl=it Požadavek 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í
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í
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í
pp (Profil kreativ)	Pomocí parametru profilu kreativ se předává proměnná hodnota určující, které kreativy se na základě konfigurace nastavené v profilu videokreativ a zvukových kreativ mohou zobrazit. Příklad použití pp=creative_profile Požadavek 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í
sid (ID relace)	Pomocí parametru ID relace se předává proměnná hodnota, která představuje inzertní identifikátor zachovávající soukromí používaný pouze pro účely omezení frekvence. ID relace je podporováno u žádostí o reklamy in-stream z televizí připojených k internetu a u inventáře videí in-stream ze zařízení s mobilními aplikacemi. Pro web v současné době podporováno není. Podle pokynů organizace IAB ohledně reklamních identifikátorů by tento parametr musí být vyplněn ve formátu UUID. Další informace o resetovatelných identifikátorech zařízení pro cílení na uživatele. Z předávání ID relace se můžete odhlásit nastavením parametru sid=0. Příklad použití 123e4567-e89b-12d3-a456-426614174000 Požadavek Doporučeno pro programatické zpeněžování
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í
vpos (Pozice videa)	Pomocí parametru pozice videa se předává konstantní hodnota, která udává, zda se jedná o žádost o reklamu před videem, uprostřed videa nebo za videem. Příklad použití Reklama před videem: vpos=preroll Reklama uprostřed videa: vpos=midroll Reklama za videem: vpos=postroll Požadavek 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í