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 digitální venkovní reklamy.
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í
Povinné a doporučené parametry pro digitální venkovní reklamu
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.
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 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ě.
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ě.
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.
venuetype (Typ místa)
Popis
Parametr typu místa (venuetype) slouží k označení typu místa u venkovních reklam. Jedná se o číselná ID podle taxonomie typu míst OpenOOH 1.1 organizace IAB.
Příklady použití
Hotelové pokoje:
venuetype=80703
Tablet na zadním sedadle taxi:
venuetype=103
Požadavky a doporučení
Tento parametr je povinný pro programatické zpeněžování v digitálních venkovních reklamách.
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.
