Tento článek obsahuje seznam povinných a doporučených parametrů značek reklam VAST používaných k zobrazování reklam v implementacích na televizích připojených k internetu.
Obsah této stránky
- Parametry povinné k zobrazování reklam
- Parametry povinné pro programatické zpeněžování
- Parametry doporučené pro programatické zpeněžování
Můžete si prohlédnout seznamy pro jiné typy implementace nebo požadavky na adresy URL značek reklam VAST.
Povinné a doporučené parametry pro televize připojené k internetu
Parametry povinné k zobrazování reklam
correlator (Korelátor)
Popis
Pomocí parametru korelátoru (correlator) 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říklady použití
correlator=4345645667
Požadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
Použití sady SDK
- Při použití sady IMA SDK se hodnota korelátoru 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.
env (Prostředí)
Popis
Pomocí parametru prostředí (env) 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říklady použití
Video nebo zvuk:
env=instream
Pouze video:
env=vp
Požadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
Tento parametr je vyžadován, aby bylo možné přesně vytvářet přehledy typů žádostí rozdělené podle hodnoty Značka videa.
gdfp_req (Indikátor schématu)
Popis
Pomocí parametru indikátoru schématu služby Google Ad Manager (gdfp_req) se předává konstantní hodnota, která udává, že se žádost o reklamu týká inventáře služby Google Ad Manager.
Příklady použití
gdfp_req=1
Požadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
iu (Reklamní jednotka)
Popis
Pomocí parametru reklamní jednotky (iu) se předává proměnná hodnota, která by měla být nastavena na aktuální reklamní jednotku ve formátu: /kód_sítě/.../reklamní_jednotka.
Příklady použití
iu=/6062/videodemo
Požadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
output (Výstup)
Popis
Pomocí parametru výstupního formátu (output) se předává konstantní hodnota, kterou je potřeba nastavit na výstupní formát reklamy.
Příklady použití
Použít výchozí verzi šablony VAST sítě:
output=vast
Použít formát VAST 4 (pro konkrétní značky můžete nastavit konkrétní verze):
output=xml_vast4
Použít výchozí nastavení šablony VMAP sítě:
output=vmap
Použít VMAP 1:
output=xml_vmap1
Použít VMAP 1 a vrátit VAST 4 (pokud v šabloně VMAP odesíláte šablonu VAST):
output=xml_vmap1_vast4
Požadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě. Je potřeba k vygenerování správného formátu odpovědi s reklamami.
Použití sady SDK
Pokud přehrávač videa 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.
sz (Velikost)
Popis
Pomocí parametru velikosti (sz) 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říklady použití
Jedna velikost:sz=400x300
Více velikostí:sz=300x250|400x300
Požadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu, v mobilních aplikacích, na televizích připojených k internetu a v digitální venkovní reklamě.
Pokud žádáte pouze o zvukové reklamy (ad_type=audio), je tento parametr volitelný.
url (URL)
Popis
Pomocí parametru adresy URL (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.
- Na webu se jedná o adresu URL stránky, na které se zobrazuje přehrávač videí.
- V newebových prostředích 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.*
Poznámka: Parametr url se liší od description_url tím, že url odkazuje na místo, ze kterého byla žádost o reklamu odeslána, zatímco description_url je webová stránka procházená prohledávačem, která popisuje obsah videa.
Hodnota tohoto parametru by měla být zakódována.
Příklady použití
url=https%3A%2F%2Fexample.com%2Fvideo.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>.example.com
Požadavky a doporučení
Tento parametr je vyžadován pouze pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
Použití sady SDK
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.
Parametry povinné pro programatické zpeněžování
idtype (Typ zařízení)
Popis
Pomocí parametrů resetovatelných identifikátorů zařízení (rdid, idtype, is_lat) se předávají proměnné hodnoty. Tato hodnota je známá také jako identifikátor pro inzerci (IFA).
U mobilních aplikací, které používají sadu IMA SDK pro Android nebo iOS, sada IMA 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.
Pokud sadu IMA SDK nepoužíváte nebo se používáte signalizaci na straně serveru (SSB), musíte je předat jako explicitní parametry. 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 |
Příklady použití
Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení.
Požadavky a doporučení
Tyto parametry sice nejsou nezbytné k zobrazování reklam v konkrétní implementaci, ale jsou vyžadovány pro programatické zpeněžování v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
U webových implementací se resetovatelné identifikátory zařízení nepoužívají.
Použití sady SDK
Sada IMA SDK toto pole předává automaticky. Majitelé stránek při použití sady PAL SDK tyto parametry předávají ručně.
is_lat (Omezit měření reklam)
Popis
Pomocí parametrů resetovatelných identifikátorů zařízení (rdid, idtype, is_lat) se předávají proměnné hodnoty. Tato hodnota je známá také jako identifikátor pro inzerci (IFA).
U mobilních aplikací, které používají sadu IMA SDK pro Android nebo iOS, sada IMA 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.
Pokud sadu IMA SDK nepoužíváte nebo se používáte signalizaci na straně serveru (SSB), musíte je předat jako explicitní parametry. 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 |
Příklady použití
Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení.
Požadavky a doporučení
Tyto parametry sice nejsou nezbytné k zobrazování reklam v konkrétní implementaci, ale jsou vyžadovány pro programatické zpeněžování v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
U webových implementací se resetovatelné identifikátory zařízení nepoužívají.
Použití sady SDK
Sada IMA SDK toto pole předává automaticky. Majitelé stránek při použití sady PAL SDK tyto parametry předávají ručně.
ott_placement (umístění OTT)
Popis
Pomocí parametru umístění OTT (ott_placement) se předává konstantní hodnota, která udává, že se jedná o žádost pro non-in-stream umístění OTT.
Definice umístění pro níže uvedené příklady:
- Pozastavení: Formát reklamy out-stream, který se zobrazuje jako překryvná vrstva nad videoobsahem, když uživatel pozastaví přehrávání obsahu.
- Plocha: Reklama, která se zobrazuje na ploše televizního zařízení připojeného k internetu nebo aplikace OTT. Týká se to implementací mastheadů, bannerů a dlaždic na ploše.
- Obraz v obraze: Videoreklama in-stream přehrávaná v samostatném přehrávači vedle videoobsahu. Obvykle vyžaduje sbalení videoobsahu a načtení druhého přehrávače videa.
- L-banner: Obsahová reklama in-stream, při které se videoobsah zmenší a okolo něj se vytvoří prostor na reklamu. Prostor pro obsah reklamy mívá obvykle tvar písmene L (ale může mít i jiný tvar).
- Překryvná reklama: Jakýkoli formát reklamy in-stream, který překrývá videoobsah, ale nezabírá celou obrazovku. Může se jednat o obsahovou reklamu nebo videoreklamu.
Příklady použití
Podporované formáty a jejich odpovídající hodnoty:
Pozastavit:
ott_placement=1
Plocha:
ott_placement=2
Obraz v obraze:
ott_placement=3
L-banner:
ott_placement=4
Překryvná reklama:
ott_placement=5
Vlastní/jiné:
ott_placement=99
Požadavky a doporučení
Tento parametr je vyžadován jen u programatického zpeněžování na webu, v mobilních aplikacích a na televizích připojených k internetu u majitelů obsahu, kteří zpeněžují nestandardní umístění v prostředích streamování OTT.
plcmt (Umístění)
Popis
Pomocí parametru umístění (plcmt) 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 tento parametr pro kupující vyplňuje automaticky na základě deklarovaného formátu inventáře, který přepíše případnou deklaraci obsahu in-stream nebo doprovodného obsahu.
Příklady použití
Žádost z umístění in-stream:
plcmt=1
Žádost z umístění v doprovodném obsahu:
plcmt=2
Požadavky a doporučení
Tento parametr je vyžadován pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
rdid (Resetovatelný identifikátor zařízení)
Popis
Pomocí parametrů resetovatelných identifikátorů zařízení (rdid, idtype, is_lat) se předávají proměnné hodnoty. Tato hodnota je známá také jako identifikátor pro inzerci (IFA).
U mobilních aplikací, které používají sadu IMA SDK pro Android nebo iOS, sada IMA 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.
Pokud sadu IMA SDK nepoužíváte nebo se používáte signalizaci na straně serveru (SSB), musíte je předat jako explicitní parametry. 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 |
Příklady použití
Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení.
Požadavky a doporučení
Tyto parametry sice nejsou nezbytné k zobrazování reklam v konkrétní implementaci, ale jsou vyžadovány pro programatické zpeněžování v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
U webových implementací se resetovatelné identifikátory zařízení nepoužívají.
Použití sady SDK
Sada IMA SDK toto pole předává automaticky. Majitelé stránek při použití sady PAL SDK tyto parametry předávají ručně.
vpa (Automatické spuštění videa)
Popis
Pomocí parametru automatického přehrání videa (vpa) 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. Tento parametr nemění stav přehrávače videa. Chování přehrávání musí být zpracováno přímo přehrávačem videa.
Příklady použití
Automatické přehrání:
vpa=auto
Přehrání kliknutím:
vpa=click
Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený.
Požadavky a doporučení
Tento parametr je vyžadován pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu a ve zvuku.
Tento parametr je doporučen také v pokynech rady Media Rating Council (MRC) k měření videí.
vpmute (Přehrání videa s vypnutým zvukem)
Popis
Pomocí parametru vypnutí zvuku při přehrávání videa (vpmute) 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. Tento parametr nemění stav přehrávače videa. Chování přehrávání musí být zpracováno přímo přehrávačem videa.
Příklady použití
Přehrávání se spustí se ztlumeným zvukem:
vpmute=1
Přehrávání se spustí se zapnutým zvukem:
vpmute=0
Požadavky a doporučení
Tento parametr je vyžadován pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
Tento parametr je doporučen také v pokynech rady Media Rating Council (MRC) k měření videí.
Parametry doporučené pro programatické zpeněžování
aconp (Nepřetržité přehrávání zvuku)
Popis
Pomocí parametru nepřetržitého přehrávání zvukového obsahu (aconp) se předává konstantní hodnota, která udává, zda bude přehrávač zvukový obsah přehrávat souvisle. To službě Google Ad Manager pomáhá vybrat pro daný typ přehrávání ty nejvhodnější reklamy.
Příklady použití
Nepřetržité přehrávání zapnuto:
aconp=2
Nepřetržité přehrávání vypnuto:
aconp=1
Pokud nevíte, zda se zvuk přehrává nepřetržitě, ponechte tento parametr nenastavený nebo ho nastavte na hodnotu aconp=0.
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci povinný, ale je doporučen pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
Tento parametr je doporučen také v pokynech organizace Media Rating Council (MRC) k měření zvukových reklam.
an (Název aplikace)
Popis
Pomocí parametru ID aplikace (msid) a názvu aplikace (an) 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 vyžadovány u většiny programatických videoreklam.
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říklady 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žadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci vyžadován, ale doporučuje se pro programatické zpeněžování v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
V zájmu ochrany značky a větší transparentnosti pro kupující důrazně doporučujeme informace o aplikaci uvést.
Použití sady SDK
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).
Poznámka: V případě použití sady HTML5 IMA SDK se informace o aplikaci nepoužívají.
dth (Informace o typu zařízení)
Popis
Pomocí parametru pro informace o typu zařízení (dth) se předává konstantní hodnota, která pomáhá omezit nesprávnou klasifikaci zařízení, zejména v prostředí televizí připojených k internetu a set-top boxů.
Nesprávná klasifikace zařízení může být důsledkem nechtěných chyb u vydavatele nebo výrobce OEM televizí připojených k internetu. Tento parametr může Google ve spojení s dalšími signály využít k automatickému nahlášení případů změny klasifikace inventáře pro televize připojené k internetu.
Příklady použití
Zdroj žádosti:
- Mobilní telefon střední třídy:
dth=1 - Chytrý telefon:
dth=2 - Počítač:
dth=3 - Tablet:
dth=4 - Televize připojená k internetu:
dth=5 - Herní konzole:
dth=6 - Set-top box:
dth=7
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci povinný, ale je doporučen pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
Použití sady SDK
Tento parametr je doporučen pro implementace PAL a PAI (bez sady SDK). V případě sad IMA SDK a DAI SDK není potřeba.
givn (Nonce videa)
Popis
U integrací, které používají knihovnu programatického přístupu (PAL), se pomocí parametru nonce videa předává proměnná hodnota ve formě textového řetězce.
Náhodné číslo je bezpečné pro adresy URL – není ho potřeba zakódovávat pro adresy URL.
Poznámka: Pokud jste dříve poskytovali nonce pomocí staršího parametru paln, důrazně doporučujeme přejít na parametr givn a parametr paln přestat odesílat. Nezahrnujte oba parametry.
Příklady použití
Další informace o hodnotě předávané pomocí tohoto parametru najdete v průvodcích Začínáme ke knihovně PAL.
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci povinný, ale je doporučen pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
hl (Jazyk)
Popis
Pomocí parametru jazyka (hl) 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.
Příklady použití
Žádost o reklamy v italštině:
hl=it
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.
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci povinný, ale je doporučen pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
msid (ID aplikace)
Popis
Pomocí parametru ID aplikace (msid) a názvu aplikace (an) 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 vyžadovány u většiny programatických videoreklam.
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říklady 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žadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci vyžadován, ale doporučuje se pro programatické zpeněžování v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
V zájmu ochrany značky a větší transparentnosti pro kupující důrazně doporučujeme informace o aplikaci uvést.
Použití sady SDK
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).
Poznámka: V případě použití sady HTML5 IMA SDK se informace o aplikaci nepoužívají.
omid_p (Název partnera OMID)
Popis
Pomocí parametru názvu partnera OMID (omid_p) se předává proměnná hodnota, která udává název a verzi partnera provádějícího měření OMID.
Pomocí parametru podporovaných rozhraní SDK API (sdk_apis) se předávají proměnné hodnoty, které mohou být buď jedním podporovaným rozhraním API, nebo seznamem podporovaných rozhraní API odděleným čárkami.
Tyto parametry jsou součástí sady parametrů používaných k měření viditelnosti a ověřování reklam.
Příklady použití
Pokud knihovnu PAL nepoužíváte:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Viz seznam možných hodnot rozhraní API.
Při použití knihovny PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci povinný, ale je doporučen pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu, ve zvuku a v digitální venkovní reklamě.
Použití sady SDK
- Tento parametr je k dispozici pouze pro majitele obsahu, kteří chtějí používat měření Active View při použití sady Open Measurement SDK (OM SDK).
- Pokud chcete uvést podporu OMID při použití knihovny programatického přístupu (PAL), musíte k nastavení názvu a verze partnera použít parametry
omidPartnerNameaomidPartnerVersion. Pokud nepoužíváte sadu PAL ani IMA SDK, musíte nastavit parametryomid_pasdk_apis. - Tento parametr by se neměl používat při použití sady IMA SDK, protože je nastaven automaticky.
sid (ID relace)
Popis
Pomocí parametru ID relace (sid) 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. U webu v současné době podporováno není.
Z předávání ID relace se můžete odhlásit nastavením parametru sid=0.
Příklady použití
sid=123e4567-e89b-12d3-a456-426614174000
Podle pokynů organizace IAB ohledně reklamních identifikátorů musí být tento parametr vyplněn ve formátu UUID. Další informace o resetovatelných identifikátorech zařízení pro cílení na uživatele
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci vyžadován, je ale nezbytný pro programatické zpeněžování v digitální venkovní reklamě.
Tento parametr je doporučen pro programatické zpeněžování v mobilních aplikacích, na televizích připojených k internetu a ve zvuku.
Použití sady SDK
Tento parametr odesílá sada IMA SDK automaticky.
vconp (Nepřetržité přehrávání videa)
Popis
Pomocí parametru nepřetržitého přehrávání videa (vconp) se předává konstantní hodnota, která udává, zda bude přehrávač videoobsah přehrávat souvisle (podobně jako v televizním vysílání).
Příklady použití
Nepřetržité přehrávání zapnuto:
vconp=2
Nepřetržité přehrávání vypnuto:
vconp=1
Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený.
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci vyžadován, ale doporučuje se pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu a ve zvuku.
Tento parametr je doporučen také v pokynech rady Media Rating Council (MRC) k měření videí.
vid_d (Délka videa)
Popis
Pomocí parametru trvání videa (vid_d) se předává proměnná hodnota, která udává trvání obsahu v sekundách.
- Parametry
vid_daallcuesse používají k zobrazování reklam uprostřed videa bez zpracování obsahu. - K vrácení reklam uprostřed videa je potřeba použít pravidla reklamy. Pokud jsou v pravidlech reklamy použity časové signály (například Každých N sekund nebo V určenou dobu), použijí se signály nastavené v pravidle reklamy a signály předané pomocí parametru
allcuesse ignorují. Reklamy uprostřed videa přesto vyžadují trvání, proto je nutné předávat parametrvid_d.
Příklady použití
Trvání videa 90000 sekund (25 hodin):
vid_d=90000
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci vyžadován, ale doporučuje se pro programatické zpeněžování na webu, v mobilních aplikacích a na televizích připojených k internetu.
vpos (Pozice videa)
Popis
Pomocí parametru pozice videa (vpos) 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říklady použití
Reklama před videem:
vpos=preroll
Reklama uprostřed videa:
vpos=midroll
Reklama za videem:
vpos=postroll
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci vyžadován, ale doporučuje se pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu a ve zvuku.
Pokud se používají pravidla reklamy, tento parametr není potřeba, protože ho reklamní server přidá automaticky.
wta (Proč tato reklama)
Popis
Pomocí parametru zprávy „Proč tato reklama?“ (wta) se předává konstantní hodnota, která udává, zda přehrávač videa podporuje zobrazení odznaku reklamy.
Příklady použití
Pokud má přehrávač vykreslit ikonu AdChoices uvedenou v odpovědi VAST, použijte:
wta=1(nebo parametrwtavynechte, případně předejte parametrwtabez nastavené hodnoty)Pokud bude ikona AdChoices poskytnutá v odpovědi VAST vykreslena v doprovodných reklamách nebo uživateli poskytnuta jinak, měl by být v žádostech o zvukové reklamy použit parametr
wta=1.
Pokud přehrávač nemá vykreslit ikonu AdChoices poskytnutou v odpovědi VAST, použijte:
wta=0
Požadavky a doporučení
Tento parametr není k zobrazování reklam u žádného konkrétního typu implementace vyžadován, ale doporučuje se pro programatické zpeněžování na webu, v mobilních aplikacích, na televizích připojených k internetu a ve zvuku.
Když je parametr použit:
- U provozu s parametrem
&wta=0nelze u poptávky z Googlu používat některé typy personalizace. - V provozu z EHP s parametrem
&wta=0se nemohou zobrazovat kreativy se zapnutým označováním reklam z rezervačních řádkových položek a řádkových položek programatického prodeje zaručeného inventáře spravovaných majitelem obsahu.
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ích nezákonného obsahu musí majitelé obsahu společnost Google informovat pomocí formuláře služby Nahlašování obsahu na Googlu.
Použití sady SDK
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.