Tento článek obsahuje úplný seznam parametrů, které lze použít ve značce reklamy VAST. Může být užitečný, pokud chcete zjistit další informace o konkrétním parametru.
Zobrazit klikatelný abecední index všech parametrů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í
- Ostatní parametry
Seznamy parametrů podle typu implementace
Pokud používáte konkrétní implementaci, můžete použít seznamy vlastních parametrů, které popisují použití a požadavky pro danou implementaci. Jsou k dispozici seznamy vlastních parametrů pro tyto implementace:
Web Mobilní aplikace Televize připojená k internetu Zvuk Digitální venkovní reklama
Všechny parametry
Parametry povinné k zobrazování reklam
Tyto parametry jsou obecně pro zobrazování reklam u většiny implementací povinné. V některých případech ale povinné nejsou. Nejpřesnější záznam získáte, když použijete seznam parametrů pro konkrétní typ implementace.
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.
description_url
(Adresa URL popisu)
Popis
Pomocí parametru adresy URL popisu (description_url
) se předává proměnná hodnota, která by měla popisovat video přehrávané na stránce.
Adresa URL popisu by měla odpovídat videím přehrávaným na konkrétní stránce webové, mobilní nebo televizní aplikace. Nemělo by se jednat o doménu nejvyšší úrovně pro všechna videa nebo všechny žádosti o reklamy. Pokud například máte stránku https://www.sample.com/golf.html
, na které zobrazujete videa o golfu, nastavte ji jako hodnotu parametru description_url
.
Příklady použití
U webových stránek s videi, televizí připojených k internetu a zařízení OTT musí být hodnota description_url
zakódována pro URL. U mobilních aplikací ale hodnota description_url
nesmí být zakódována.
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žadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu a v mobilních aplikacích. Je také povinný, pokud k dynamické alokaci používáte Ad Exchange nebo AdSense.
Tento parametr je doporučen pro programatické zpeněžování.
Použití sady SDK
Sada IMA SDK tento parametr nenastavuje automaticky. Je třeba ho nastavit ručně.
Projděte si průvodce sadou IMA SDK pro svou platformu.
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ý.
unviewed_position_start
(Zpožděná zobrazení)
Popis
Pomocí parametru zpožděných zobrazení (unviewed_position_start
) se předává konstantní hodnota, která značí zpožděná zobrazení videí.
Příklady použití
unviewed_position_start=1
Požadavky a doporučení
Tento parametr je vyžadován k implementaci zobrazování reklam na webu a v mobilních aplikacích u příležitostí k zobrazení s prodlevou.
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%2Fwww.example.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 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
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í
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ě.
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.
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í.
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
omidPartnerName
aomidPartnerVersion
. Pokud nepoužíváte sadu PAL ani IMA SDK, musíte nastavit parametryomid_p
asdk_apis
. - Tento parametr by se neměl používat při použití sady IMA SDK, protože je nastaven automaticky.
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.
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_d
aallcues
se 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
allcues
se 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 parametrwta
vynechte, případně předejte parametrwta
bez 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=0
nelze u poptávky z Googlu používat některé typy personalizace. - V provozu z EHP s parametrem
&wta=0
se 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.Ostatní parametry
Obecně tyto parametry nejsou k zobrazování reklam výslovně vyžadovány, ale mohou být vyžadovány k používání určitých funkcí nebo mohou být vyžadovány u určitých typů implementace.
ad_rule
(Pravidlo reklamy)
Popis
Pomocí parametru pravidla reklamy (ad_rule
) se předává konstantní hodnota, která udává, zda má být vrácena kreativa VAST nebo odpověď s pravidly reklamy.
Výchozí nastavení pravidel reklamy závisí na nastavení sítě Google Ad Manager, které pro všechny žádosti o reklamy aktivuje pravidla reklamy. Pokud se používá nastavení sítě, parametr ad_rule
ve značce reklamy nastavovat nemusíte. Pokud chcete pravidla reklamy na úrovni žádosti o reklamu deaktivovat, můžete nastavení sítě přepsat předáním parametru ad_rule=0
. Pokud pravidla reklamy ve výchozím nastavení nemáte zapnutá, můžete je zapnout/vypnout zadáním parametrů ad_rule=1
a ad_rule=0
.
Příklady použití
Pokud je nastavení pravidel reklamy vypnuté:
- Žádost o kreativu VAST:
ad_rule=0
nebo parametr nenastavujte
Pokud je zapnuté nastavení hromadné aktivace pravidel reklamy:
- Žádost o kreativu VAST:
ad_rule=0
- Žádost o pravidla reklamy (VMAP):
ad_rule=1
nebo parametr nenastavujte
Pokud nepoužíváte pravidla reklam, můžete trvání reklamní přestávky a podu ve značce VAST nastavit pomocí parametrů značky reklamy pmnd
, pmxd
a pmad
.
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam u žádného konkrétního typu implementace povinný, ale je nutný ke správnému použití pravidel pro videoreklamy.
addtl_consent
(Další souhlas)
Popis
Pomocí parametru dalšího souhlasu (addtl_consent
) se předávají proměnné hodnoty a používají ho majitelé obsahu, kteří chtějí integrovat systém IAB TCF 2.0 a používat dodavatele, který dosud není zaregistrován v globálním seznamu dodavatelů organizace IAB Europe, ale je uveden v seznamu poskytovatelů reklamních technologií společnosti Google.
Další informace o hodnotách předávaných pomocí tohoto parametru najdete v technické specifikaci režimu dalšího souhlasu.
Příklad použití
addtl_consent=1~1.35.41.101
adtest
(Test reklamy)
Popis
Pomocí parametru testu reklamy (adtest
) zajistíte, aby dotazy používané k testování záložních (nezaručených) reklam nebyly identifikovány jako neplatný provoz a neměly dopad na tržby.
Při testování záložních reklam nastavte tento parametr na hodnotu on
, aby reklamy během testování nezaznamenávaly zobrazení ani kliknutí. V jiných než testovacích prostředích ho nastavte na hodnotu off
, aby byla standardně účtována. Pokud tento parametr ponecháte nenastavený, použije se výchozí hodnota off
.
Poznámka: Při testování řádkových položek prodávaných přímo byste měli použít testovací řádkové položky bez dopadu na tržby.
Příklady použití
Zapnuto:
adtest=on
Vypnuto:
adtest=off
ad_type
(Typ reklamy)
Popis
Pomocí parametru typu reklamy (ad_type
) se předává konstantní hodnota, která určuje, jaké typy reklam mají být pro žádost vráceny.
Když je parametr ad_type
nastaven na hodnotu audio
nebo audio_video
, musí být parametr vpmute nastaven na hodnotu 0
.
Příklady použití
Povoluje pouze zvukové reklamy:
ad_type=audio
Povoluje přeskočitelné i nepřeskočitelné videoreklamy:
ad_type=video
Povoluje zvukové reklamy i videoreklamy:
ad_type=audio_video
Tato hodnota
audio_video
povoluje soutěžit oběma formátům, ale zobrazí se jen jeden. Je určena jen k zobrazování videoreklam ve zvukovém obsahu, který podporuje přehrávání videoreklam nebo k zobrazování audiokreativ v přehrávačích videí in-stream u obsahu, který ve své podstatě může být poslouchatelný, jako jsou sportovní přenosy, videocasty, zprávy apod. Další informace o zvukovém obsahu ve videích
Povoluje pouze přeskočitelné videoreklamy:
ad_type=skippablevideo
Povoluje pouze nepřeskočitelné videoreklamy:
ad_type=standardvideo
Požadavky a doporučení
- Pokud má aplikace videoobsah, nastavte tento parametr na
video
,audio_video
nebo ho nechte nenastavený. - Pokud má aplikace jen zvukový obsah (jako například rádio nebo aplikace pro řeč), musíte tento parametr nastavit na hodnotu
audio
. Pokud ho ponecháte nenastavený, nebudou vráceny žádné zvukové reklamy.
afvsz
(Velikosti nelineárních reklam)
Popis
Pomocí parametru velikosti nelineární reklamy (afvsz
) se předávají konstantní hodnoty ve formě seznamu čárkami oddělených velikostí nelineárních reklam, které lze v reklamním bloku zobrazit.
Musí se jednat o některé z těchto podporovaných velikostí:
200x200
250x250
300x250
336x280
450x50
468x60
480x90
729x90
Při použití sady IMA SDK se toto pole přepíše a vyplní všemi podporovanými velikostmi, které vyhovují nastaveným rozměrům nonLinearAdSlotWidth a nonLinearAdSlotHeight.
Pokud nejsou podporovány žádné velikosti nelineárních reklam, může být tento parametr vynechán nebo ponechán prázdný.
Příklady použití
Jsou podporovány všechny velikosti:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
Maximální šířka je 250:
afvsz=200x200,250x250
Maximální výška je 60:
afvsz=450x50,468x60
Maximální šířka je 100:
//empty; no values supported
Požadavky a doporučení
Tento parametr není vyžadován k zobrazování reklam v rámci žádné konkrétní implementace ani typu transakce. Je ale vyžadován k zobrazování nelineárních videoreklam, pokud se nepoužívá sada IMA SDK.
allcues
(Všechny signály)
Popis
Pomocí parametru všech signálů (allcues
) se předávají proměnné hodnoty, které představují seznam čárkami oddělených signálních bodů v milisekundách. Pro každou hodnotu vytvoří Google Ad Manager reklamní přestávku.
- Parametry
vid_d
aallcues
se používají k zobrazování reklam uprostřed videa bez zpracování obsahu. - K vrácení reklam uprostřed videa jsou potřeba také 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
allcues
se ignorují. Reklamy uprostřed videa přesto vyžadují trvání, proto je nutné předávat parametrvid_d
.
Příklady použití
Signální body v časech 10 a 20 sekund:
allcues=10000,20000
ciu_szs
(Velikosti doprovodných reklam)
Popis
Pomocí parametru velikostí doprovodných reklam (ciu_szs
) se předávají proměnné hodnoty, které představují seznam čárkami oddělených velikostí doprovodných reklam.
Hodnoty oddělené svislou čarou (|
) určují reklamní blok pro více velikostí.
Příklady použití
ciu_szs=728x90,300x250
Velikosti s blokem pro více velikostí:
ciu_szs=728x90,300x200|300x250
cmsid
(ID zdroje obsahu)
Popis
Pomocí parametru ID zdroje obsahu (cmsid
) a ID videa (vid
) se předávají proměnné hodnoty.
Aby bylo možné cílit reklamy na videoobsah, musí značka hlavního videa obsahovat oba tyto parametry.
- Parametr
cmsid
je pro každý zdroj obsahu jedinečné číslo. Ve službě Google Ad Manager ho najdete tak, že kliknete na Video, pak na Zdroje obsahu a pak na název zdroje. - Parametr
vid
je řetězec nebo číslo, které označuje konkrétní video. Toto ID je přidělováno systémem CMS, ve kterém je obsah hostován. Ve službě Google Ad Manager ho najdete tak, že kliknete na Video, pak na Obsah a pak na konkrétní videoobsah.
Příklady použití
cmsid=[value]&vid=[value]
Pokud vytváříte značku pro videa na vyžádání s dynamickým vkládáním reklam, měli byste použít makra, která dynamicky vloží správný zdroj obsahu a ID videa:
Příklad: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Požadavky a doporučení
Tyto parametry nejsou u žádné konkrétní implementace ani u žádného typu transakce povinné k zobrazování reklam, ale jsou povinné k použití cílení na videoobsah.
cust_params
(Vlastní parametry)
Popis
Pomocí parametru pro vlastní parametry (cust_params
) se předávají proměnné hodnoty představující páry klíč–hodnota, pomocí nichž lze nastavit konkrétní cílení, například podle demografických údajů, na konkrétní pozice na stránce nebo na konkrétní stránku či stránky.
Příklady použití
excl_cat
(Kategorie vyloučení)
Popis
Pomocí parametru vyloučení kategorií (excl_cat
) se předávají proměnné hodnoty a používá se k blokování řádkových položek, které v žádosti o reklamu obsahují štítek vyloučení. Pomocí parametru cust_params
nastavte kategorii vyloučení a štítky vyloučení.
Příklady použití
Pokud chcete nastavit kategorii vyloučení pro dva štítky vyloučení (airline_excl_label
a train_excl_label
), oddělte je svislou čarou (|
):
excl_cat=airline_excl_label%7Ctrain_excl_label
Pak hodnotu zakódujte pro URL a zakódovaný řetězec použijte v parametru cust_params
:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr
(GDPR)
Popis
Pomocí parametru pro GDPR (gdpr
) se předávají konstantní hodnoty a používají ho majitelé obsahu, kteří chtějí integrovat systém IAB TCF 2.0. U přímých žádostí o reklamy VAST se hodnoty automaticky nečtou, ale v případě přidání do značek reklamy jsou přijímány.
Platné hodnoty tohoto parametru jsou pouze 0
a 1
, přičemž 0
znamená, že se na žádost GDPR nevztahuje, a 1
znamená, že se na ni vztahuje. Pokud se na žádost GDPR vztahuje, musíte pomocí parametru gdpr_consent zadat také platný řetězec TC.
Další informace o hodnotách předávaných pomocí tohoto parametru naleznete v obecných pokynech k implementaci tohoto systému nebo v sekci o řetězci TC ve specifikaci IAB TCF 2.0.
Příklady použití
Na žádost se vztahuje GDPR:
gdpr=1
Na žádost se nevztahuje GDPR:
gdpr=0
gdpr_consent
(Souhlas podle GDPR)
Popis
Pomocí parametru souhlasu pro GDPR (gdpr_consent
) se předávají proměnné hodnoty a používají ho majitelé obsahu, kteří chtějí integrovat systém IAB TCF 2.0. U přímých žádostí o reklamy VAST se hodnoty automaticky nečtou, ale v případě přidání do značek reklamy jsou přijímány.
Další informace o hodnotách předávaných pomocí tohoto parametru naleznete v obecných pokynech k implementaci tohoto systému nebo v sekci o řetězci TC ve specifikaci IAB TCF 2.0.
Příklady použití
gdpr_consent=GDPR_CONSENT_123
iabexcl
(Adresa URL vyloučení IAB)
Popis
Pomocí parametru adresy URL vyloučení IAB (iabexcl
) se předávají proměnné hodnoty, které představují seznam kategorií oddělených čárkami.
Příklady použití
iabexcl=3,14,527
vylučuje kategorie Komerční nákladní auta, Terénní vozidla a Ragby.
Můžete si stáhnout seznam kategorií taxonomie obsahu IAB a jejich ID.
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ě.
ipd
(Doména partnera pro inventář)
Popis
Pomocí parametru domény partnera pro inventář (ipd
) se předávají proměnné hodnoty, které by měly být nastaveny na deklaraci inventorypartnerdomain
v souboru app-ads.txt
(nebo ads.txt
) majitele stránek.
Parametr inventorypartnerdomain
je specifikace IAB, která majitelům stránek pomáhá určit doménu partnera pro sdílení inventáře pro účely ověření souboru ads.txt/app-ads.txt
.
Deklarace IPD je obzvláště důležitá u sdílení inventáře, kdy reklamní inventář, ze kterého žádost pochází, může vlastnit jiný partner (partner pro sdílení inventáře).
Přečtěte si další informace o souborech ads.txt/app-ads.txt a partnerech pro sdílení inventáře.
Příklady použití
Doménainventorypartnerdomain
je v souboru app-ads.txt, který odkazuje na soubor .txt partnera, který může inventář zpeněžovat. Hodnota parametru ipd
by se měla odpovídat hodnotě v souboru app-ads.txt pod jednou z položek inventorypartnerdomain
.Požadavky a doporučení
Tento parametr je povinný pro majitele stránek, kteří zpeněžují inventář, který nevlastní.
ipe
(Entita signálu pro hlášení zobrazení)
Popis
Pomocí parametru entity signálu pro hlášení (ipe
) zobrazení se předává konstantní hodnota, která se používá k označení signálů o zobrazení odeslaných ze serveru, nikoliv z klienta.
Entita signálu pro hlášení zobrazení se používá, když server odesílá pingy / webové signály zobrazení ze serveru.
Příklady použití
Signalizace na straně serveru (SSB):
ipe=ssb
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ě.
lip
(Poslední pozice v podu)
Popis
Pomocí parametru poslední pozice v podu (lip
) se předává konstantní hodnota, která pro účely cílení nebo vytváření přehledů udává, že se jedná o žádost z poslední pozice v podu.
Poznámka: Tento parametr se nevztahuje na optimalizované pody, a pokud je u nich použit, je ignorován.
Příklady použití
lip=1
ltd
(Omezené reklamy)
Popis
Pomocí parametru omezených reklam (ltd
) se předává konstantní hodnota, která udává, zda se při absenci souhlasu s použitím souborů cookie či jiných místních identifikátorů reklamy mají zobrazit omezeným způsobem.
Tento parametr se používá k označení žádosti o omezené reklamy a liší se od parametru is_lat
. Deaktivuje personalizaci a používání identifikátorů pro podobné účely.
ltd=1
změní chování sady IMA SDK tak, aby žádost považovala za žádost bez ID a zakázala úložiště.Příklady použití
ltd=1
max_ad_duration
(Maximální trvání reklamy)
Popis
Pomocí parametru minimální délky reklamy (min_ad_duration
) a maximální délky reklamy (max_ad_duration
) se předávají proměnné hodnoty, které společně určují rozsah požadovaného trvání reklamy v milisekundách.
Tento parametr lze použít k omezení kreativ na dobu trvání požadovanou ve značce reklamy pro jednotlivé reklamy nebo v žádostech o optimalizované pody.
Příklady použití
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration
(Minimální délka reklamy)
Popis
Pomocí parametru minimální délky reklamy (min_ad_duration
) a maximální délky reklamy (max_ad_duration
) se předávají proměnné hodnoty, které společně určují rozsah požadovaného trvání reklamy v milisekundách.
Tento parametr lze použít k omezení kreativ na dobu trvání požadovanou ve značce reklamy pro jednotlivé reklamy nebo v žádostech o optimalizované pody.
Příklady použití
min_ad_duration=15000&max_ad_duration=30000
mridx
(Číslo reklamy uprostřed videa)
Popis
Pomocí parametru čísla reklamy uprostřed videa (mridx
) se předává proměnná hodnota, která představuje pořadí reklamy uprostřed videa (například 1. reklama uprostřed videa, 2. reklama uprostřed videa atd.)
Příklady použití
mridx=2
Požadavky a doporučení
Tento parametr není vyžadován k zobrazování reklam v rámci žádné konkrétní implementace ani typu transakce. Je ale vyžadován k cílení na konkrétní reklamu uprostřed videa, vytváření přehledů o reklamách uprostřed videa a vytváření prognóz pro reklamy uprostřed videa.
nofb
(Bez záložní reklamy)
Popis
Pomocí parametru vyloučení záložních reklam (nofb
) se předává konstantní hodnota, která udává, že u této žádosti o reklamu nemá být vrácen playlist se záložními videoreklamami.
Příklady použití
Zakázání záložních reklam:
nofb=1
Záložní reklamy a výběr samostatných reklam pro optimalizované pody lze u jednotlivých žádostí o reklamy zakázat předáním parametru nofb=1
.
npa
(Nepersonalizovaná reklama)
Popis
Pomocí parametru nepersonalizovaných reklam (npa
) se předává konstantní hodnota, která určuje, že má být žádost o reklamu považována za žádost o nepersonalizovanou reklamu.
Pokud žádost chcete označit jako žádost o nepersonalizovanou reklamu, musíte buď nastavit hodnotu parametru npa=1
, nebo parametr npa
jen zahrnout (bez nastavené hodnoty). Žádosti o reklamy, v nichž tento parametr chybí nebo je nastaven na hodnotu npa=0
, se považují za žádosti o personalizované reklamy.
Příklady použití
Nepersonalizované reklamy:
npa=1
Požadavky a doporučení
Tento parametr je povinný pouze jen případě, že uživatel zakáže personalizaci. Majitelé obsahu musí zajistit, aby při ovládání stavu přesně reprezentovali stav uživatele.
ott_placement
(Vlastní formáty)
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.
paln
(nonce knihovny programatického přístupu – starší)
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ě.
pmad
(Maximální počet reklam v podu)
Popis
Pomocí parametru maximálního počtu reklam v podu (pmad
) se předává proměnná hodnota, která udává maximální počet reklam v podu.
Tento parametr omezuje celkový počet reklam v optimalizovaném podu, což je funkce dostupná majitelům stránek s rozšířeným balíčkem pro videa.
Tento parametr byste neměli používat pro VMAP (když ad_rule=1
).
Příklady použití
pmad=4
pmnd
(Minimální délka podu)
Popis
Pomocí parametru minimálního trvání podu (pmnd
) a parametru maximálního trvání podu (pmxd
) se předávají proměnné hodnoty, které společně určují rozsah požadovaného trvání podu v milisekundách.
Tyto parametry se používají v žádostech o několik reklam v optimalizovaném podu, což je funkce dostupná majitelům stránek s rozšířeným balíčkem pro videa. Pokud jsou používána pravidla reklamy, přidá služba Google Ad Manager tyto informace automaticky.
Tento parametr byste neměli používat pro VMAP (když ad_rule=1
).
Příklady použití
pmnd=0&pmxd=60000
pmxd
(Maximální trvání podu)
Popis
Pomocí parametru minimálního trvání podu (pmnd
) a parametru maximálního trvání podu (pmxd
) se předávají proměnné hodnoty, které společně určují rozsah požadovaného trvání podu v milisekundách.
Tyto parametry se používají v žádostech o několik reklam v optimalizovaném podu, což je funkce dostupná majitelům stránek s rozšířeným balíčkem pro videa. Pokud jsou používána pravidla reklamy, přidá služba Google Ad Manager tyto informace automaticky.
Tento parametr byste neměli používat pro VMAP (když ad_rule=1
).
Příklady použití
pmnd=0&pmxd=60000
pmxfwt
(Maximální vynucená doba sledování podu)
Popis
Pomocí parametru maximální vynucené doby sledování podu (pmxfwt
) se předává proměnná hodnota, která udává maximální trvání nepřeskočitelné části podu v milisekundách.
Pokud podporujete pody s kombinací nepřeskočitelných a přeskočitelných videoreklam a chcete omezit dobu zobrazování reklam uživatelům, definujte pomocí tohoto parametru maximální trvání nepřeskočitelných reklam, na které se uživatel musí podívat.
Poznámka: Při definování maximálního celkového trvání podu (včetně celé doby trvání přeskočitelných reklam) má před tímto parametrem přednost parametr maximální doby trvání podu (pmxd
).
Příklad použití
pmxfwt=30000
pod
(Číslo podu)
Popis
Pomocí parametru čísla podu (pod
) se předává proměnná hodnota, která představuje pořadí podu ve videu (například 1. pod, 2. pod atd.)
Příklady použití
pod=3
Požadavky a doporučení
Tento parametr sice není nutný k zobrazování reklam v rámci žádné konkrétní implementace nebo typu transakce, ale je nutný k tomu, aby se stejná reklama mohla zobrazovat v různých podech a aby bylo možné správně používat vyloučení konkurenčních reklam, omezení frekvence a související funkce.
pp
(Profil kreativ)
Popis
Pomocí parametru profilu kreativ (pp
) se předává proměnná hodnota určující, které kreativy se na základě konfigurace nastavené v profilu videokreativ a audiokreativ mohou zobrazit.
Příklady použití
pp=creative_profile
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci vyžadován, ale je nutný k omezení mediálních souborů u kreativ hostovaných ve službě Google Ad Manager s profily videokreativ a audiokreativ. U přesměrování nebo programatických reklam se tímto způsobem zajišťuje, aby byl požadavek k dispozici, ale neomezoval mediální soubory na ty vybrané v profilu kreativy.
ppt
(Publisher Privacy Treatment)
Popis
Pomocí parametru rozhraní Publisher Privacy Treatment (ppt
) se předává konstantní hodnota, která udává, zda má být u žádosti o reklamy vypnuta personalizace reklam.
Tento parametr umožňuje vynutit nepersonalizované reklamy, které se mohou lišit od parametrů npa=1
a rdp=1
. Má vliv na rezervace i na programatickou poptávku.
Další informace o rozhraní Publisher Privacy Treatment
Příklady použití
Vypnutí personalizace reklam:
ppt=1
ppid
(identifikátor poskytnutý majitelem stránek)
Popis
Pomocí parametru identifikátoru poskytnutého majitelem stránek (ppid
) se předává proměnná hodnota identifikátoru, který se používá k omezení frekvence, segmentaci publika, cílení na publikum, postupnému střídání reklam a dalšímu ovládání zobrazování reklam na zařízeních podle publika.
Další informace o identifikátorech poskytovaných majitelem obsahu
Příklady použití
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Požadavky a doporučení
Tento parametr není k zobrazování reklam u žádné konkrétní implementace ani u žádného typu transakce vyžadován, ale je vyžadován k používání konzistentního identifikátoru nezávislého na platformě. Může být použit, když nejsou k dispozici jiné identifikátory a může být poskytnut kupujícím.
ppos
(Pozice v podu)
Popis
Pomocí parametru pozice v podu (ppos
) se předává proměnná hodnota, která představuje pozici reklamy v rámci podu (například 1. pozice, 2. pozice atd.)
Tento parametr je určen pouze pro standardní pody a je nezbytný k automatickému vyplňování doprovodných reklam. Pokud jsou používána pravidla reklamy, přidá služba Google Ad Manager tyto informace automaticky.
Příklady použití
ppos=2
Požadavky a doporučení
Tento parametr není vyžadován k zobrazování reklam v rámci žádné konkrétní implementace ani typu transakce. Je však vyžadován u standardních podů, pokud je potřeba cílit na pozici, a pro prognózy a přehledy o standardních podech. Je také potřeba ke správnému používání konkurenčních vyloučení, omezení frekvence a souvisejících funkcí.
ppsj
(Signály poskytnuté majitelem obsahu ve formátu JSON)
Popis
Pomocí parametru signálů poskytovaných majitelem obsahu ve formátu JSON (ppsj
) se předává proměnná hodnota – objekt JSON zakódovaný pomocí kódování base64, který obsahuje údaje o publiku a kontextová data poskytnutá majitelem obsahu za účelem vylepšení programatického zpeněžování.
Tento parametr lze použít k odesílání určitých signálů kupujícím/nabízejícím.
Další informace o signálech poskytovaných majitelem obsahu a podporovaných taxonomiích
Příklady použití
Objekt JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Použijte hodnotu zakódovanou pomocí kódování base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Podrobnosti o platných párech klíč–hodnota v objektu JSON najdete v
ukázce sady HTML5 IMA SDK.
ptpl
(ID šablony reklamní přestávky)
Popis
Pomocí parametru ID šablony reklamní přestávky (ptpl
) a parametru názvu (ptpln
) se předávají proměnné hodnoty, které určují, která šablona reklamní přestávky se má použít pro žádost o optimalizovaný pod.
Šablony reklamních přestávek umožňují nakonfigurovat, která vlastní či jiná místa k zobrazení reklam by v reklamní přestávce měla být zahrnuta a v jakém pořadí by se měla zobrazovat.
K odeslání žádosti o šablonu reklamní přestávky stačí pouze jeden z těchto parametrů.
Požadavky a doporučení
Tyto parametry jsou povinné jen v případě, že přímo žádáte o šablonu reklamní přestávky.
ptpln
(Název šablony reklamní přestávky)
Popis
Pomocí parametru ID šablony reklamní přestávky (ptpl
) a parametru názvu (ptpln
) se předávají proměnné hodnoty, které určují, která šablona reklamní přestávky se má použít pro žádost o optimalizovaný pod.
Šablony reklamních přestávek umožňují nakonfigurovat, která vlastní či jiná místa k zobrazení reklam by v reklamní přestávce měla být zahrnuta a v jakém pořadí by se měla zobrazovat.
K odeslání žádosti o šablonu reklamní přestávky stačí pouze jeden z těchto parametrů.
Požadavky a doporučení
Tyto parametry jsou povinné jen v případě, že přímo žádáte o šablonu reklamní přestávky.
pubf
(Veřejné minimální ceny ve značkách Ad Exchange)
Popis
Parametr veřejné minimální ceny pro Ad Exchange (pubf
) a soukromé minimální ceny pro Ad Exchange (pvtf
) přijímají proměnné hodnoty, které se používají k přidání minimálních cen do značek Ad Exchange.
Tyto parametry jsou ekvivalentem parametrů google_ad_public_floor
a google_ad_private_floor
.
Příklady použití
Veřejná minimální cena:
pubf=123
Soukromá minimální cena:
pvtf=123
Požadavky a doporučení
Tyto parametry jsou k dispozici jen majitelům obsahu v Evropském hospodářském prostoru (EHP) nebo ve Švýcarsku, kterým bylo schváleno používání funkce minimální ceny.
Přečtěte si, jak odeslat žádost.
pvid
(ID sady aplikací)
Popis
Pomocí parametru ID sady aplikací (pvid
) se předává proměnná hodnota nastavená na ID sady aplikací pro Android a pomocí parametru rozsahu sady aplikací (pvid_s
) se předává konstantní hodnota, která představuje rozsah ID sady aplikací (buď scope_app
, nebo scope_developer
).
Viz informace o načtení ID sady aplikací v dokumentaci pro Android.
Příklady použití
pvid=[AppSetID_value]
pvid_s=scope_app
Požadavky a doporučení
Ačkoli tento parametr není k zobrazování reklam v žádné konkrétní implementaci vyžadován, je doporučen pro programatické zpeněžování v mobilních aplikacích na zařízeních Android.
Použití sady SDK
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ě.
pvid_s
(Rozsah sady aplikací)
Popis
Pomocí parametru ID sady aplikací (pvid
) se předává proměnná hodnota nastavená na ID sady aplikací pro Android a pomocí parametru rozsahu sady aplikací (pvid_s
) se předává konstantní hodnota, která představuje rozsah ID sady aplikací (buď scope_app
, nebo scope_developer
).
Viz informace o načtení ID sady aplikací v dokumentaci pro Android.
Příklady použití
pvid=[AppSetID_value]
pvid_s=scope_app
Požadavky a doporučení
Ačkoli tento parametr není k zobrazování reklam v žádné konkrétní implementaci vyžadován, je doporučen pro programatické zpeněžování v mobilních aplikacích na zařízeních Android.
Použití sady SDK
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ě.
pvtf
(Soukromé minimální ceny ve značkách Ad Exchange)
Popis
Parametr veřejné minimální ceny pro Ad Exchange (pubf
) a soukromé minimální ceny pro Ad Exchange (pvtf
) přijímají proměnné hodnoty, které se používají k přidání minimálních cen do značek Ad Exchange.
Tyto parametry jsou ekvivalentem parametrů google_ad_public_floor
a google_ad_private_floor
.
Příklady použití
Veřejná minimální cena:
pubf=123
Soukromá minimální cena:
pvtf=123
Požadavky a doporučení
Tyto parametry jsou k dispozici jen majitelům obsahu v Evropském hospodářském prostoru (EHP) nebo ve Švýcarsku, kterým bylo schváleno používání funkce minimální ceny.
Přečtěte si, jak odeslat žádost.
rdp
(Omezit zpracování dat)
Popis
Pomocí parametru omezení zpracování dat (rdp
) se předává konstantní hodnota, která značí, že u žádosti o reklamu musí být omezeno zpracování dat.
Zpracování dat můžete omezit na úrovni sítě tím, že povolíte nastavení sítě Omezit zpracování dat.
Příklady použití
Omezit zpracování dat:
rdp=1
nebo rdp
(bez nastavené hodnoty)
Neomezovat zpracování dat:
rdp=0
schain
(Dodavatelský řetězec)
Popis
Pomocí parametru dodavatelského řetězce (schain
) se předává proměnná hodnota, která by měla být serializovaným objektem SupplyChain. Pokud je tento parametr zahrnut, před odesláním kupujícím připojí Google k přijatým objektům schain
svůj uzel.
Přečtěte si úplnou dokumentaci organizace IAB k předávání informací o dodavatelském řetězci prostřednictvím značky (nikoli prostřednictvím protokolu OpenRTB).
Požadavky na správné zpracování poleschain
Podle dokumentace IAB definuje serializaci objektu SupplyChain
následující kód:
{SupplyChainObject}!{SupplyChainNode array}
. VlastnostiSupplyChainObject
aSupplyChainNode
jsou odděleny čárkami. Volitelná pole lze vynechat a prázdné oddělovací čárky na konci lze vynechat.- Jednotlivé prvky
SupplyChainNode
jsou odděleny znakem!
. - Pokud hodnota některé vlastnosti obsahuje znaky, které je potřeba zakódovat pro URL (například „
,
“ nebo „!
“), je hodnotu před serializací potřeba zakódovat pro URL.
Pořadí serializace
Vlastnosti SupplyChainObject
se serializují v tomto pořadí:
ver,complete
Vlastnosti SupplyChainObject
se serializují v tomto pořadí:
asi,sid,hp,rid,name,domain,ext
ext
se liší podle burzy. Služba Google Ad Manager tuto vlastnost neanalyzuje.Příklady serializace objektu SupplyChain
Níže uvádíme dva příklady serializace výše uvedeného objektu SupplyChain
:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Příklady použití
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Pokud by hodnota asi
byla exchange,1
, serializace s escapovanými znaky by vypadala takto:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Požadavky a doporučení
Ačkoli tento parametr není u žádné konkrétní implementace ani typu transakce k zobrazování reklam vyžadován, je vyžadován u majitelů stránek, kteří využívají zprostředkovatele plateb před žádostí do služby Google Ad Manager. Týká se to i majitelů stránek, kteří používají reklamní servery třetích stran.
scor
(Korelátor streamu)
Popis
Pomocí parametru korelátoru streamu (scor
) se předává proměnná hodnota, která by měla být celé číslo vygenerované pro jednotlivé videostreamy.
Parametry score
a correlator
nemusí mít stejnou celočíselnou hodnotu. Jejich hodnoty by se však během přehrávání videostreamu neměly měnit, aby bylo možné identifikovat jedinečnou relaci sledování.
Příklady použití
scor=17
Požadavky a doporučení
Tento parametr sice není k zobrazování reklam v žádné konkrétní implementaci nebo typu transakce vyžadován, ale doporučuje se pro 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 se používá pro konkurenční vyloučení, omezení frekvence a souvisejíce, když uživatel na jedné stránce sleduje více videí.
sdk_apis
(Aplikační rámec SDK API)
Popis
Pomocí parametru aplikačního rámce SDK API (sdk_apis
) se předává seznam konstantních celočíselných hodnot oddělených čárkami, které představují všechny aplikační rámce API podporované přehrávačem.
Požadavky a doporučení
Použití sady SDK
Tento parametr používají majitelé obsahu, kteří používají knihovnu programatického přístupu (PAL). Pokud se při používání sady IMA SDK pokusíte nastavit hodnoty tohoto parametru, budou přepsány hodnotami, které sada IMA SDK podporuje.
sdmax
(Maximální trvání přeskočitelné reklamy)
Popis
Pomocí parametru maximálního trvání přeskočitelné reklamy (sdmax
) se předává proměnná hodnota, pomocí níž mohou majitelé stránek uvést požadované maximální trvání přeskočitelných reklam.
Jedná se o dobu v milisekundách, která představuje horní limit trvání přeskočitelných videokreativ nebo zvukových kreativ pro danou žádost o reklamu.
Parametr sdmax
můžete použít pro přeskočitelné reklamy nezávisle, nebo v kombinaci se stávajícím parametrem max_ad_duration
k zadání různého maximálního trvání pro přeskočitelné a nepřeskočitelné reklamy.
Příklady použití
Použití těchto nastavení:
max_ad_duration
= 15000 (15 sekund)sdmax
= 45000 (45 sekund)
Pro tyto kreativy:
- Kreativa A: nepřeskočitelná, 30 s
- Kreativa B: přeskočitelná, 30 s
Povede k těmto výsledkům:
- Kreativa A bude odfiltrována, protože je nepřeskočitelná a delší, než je maximální povolené trvání nepřeskočitelných reklam.
- Kreativa B odfiltrována nebude. Její délka sice překračuje hodnotu
max_ad_duration
, ale je přeskočitelná a její délka nepřekračuje maximální trvání přeskočitelné reklamy.
ssss
(Zdroj spojování na straně serveru)
Popis
Pomocí parametru zdroje spojování na straně serveru (ssss
) se předává konstantní hodnota, kterou je třeba nastavit na podporovanou hodnotu poskytnutou Googlem pro vašeho dodavatele technologie spojování videí.
Dodavatelé technologií spojování videí, kteří u Googlu používají integraci mezi servery, tuto hodnotu dostanou od Googlu a mohou vám ji poskytnout. S případnými dotazy ohledně toho, na jakou hodnotu tento parametr máte nastavit, se můžete obrátit na svého správce účtu Google.
Příklady použití
ssss=mystitcher
Požadavky a doporučení
Tento parametr není k zobrazování reklam u žádné konkrétní implementace ani typu transakce vyžadován, ale je potřeba k používání implementací na straně serveru.
tfcd
(Označení obsahu určeného dětem)
Popis
Pomocí parametru určení obsahu jako určeného dětem (tfcd
) se předává konstantní hodnota, která udává, že má být žádost považována za určenou dětem.
Příklady použití
tfcd=1
trt
(Typ provozu)
Popis
Pomocí parametru typu provozu (trt
) se předává konstantní hodnota, která slouží k vyžádání zakoupeného nebo organického provozu.
Příklady použití
Žádost pro zakoupený provoz:
trt=1
Žádost pro organický provoz:
trt=2
Požadavky a doporučení
Použití sady SDK
Pokud parametr typu provozu v žádosti chybí, sada IMA SDK nevyplní výchozí hodnotu. V těchto případech server poskytne výchozí hodnotu 0
(nedefinovaný provoz).
us_privacy
(Řetězec ochrany soukromí pro USA organizace IAB)
Popis
Podporu řetězceus_national
organizace IAB ukončila a nahradila ho platformou GPP. Pokud je však tento řetězec předán, služba Ad Manager ho kvůli zpětné kompatibilitě i nadále čte a zohledňuje. Majitelům obsahu doporučujeme seznámit se s platformou GPP nebo jinými možnostmi nastavení ochrany soukromí a řetězec us_national
přestat používat.
vad_type
(Typ videoreklamy)
Popis
Pomocí parametru typu videoreklamy (vad_type
) se předává konstantní hodnota, která udává, zda má být vrácena lineární, či nelineární reklama.
Příklady použití
Vrátit lineární reklamu:
vad_type=linear
Vrátit nelineární reklamu:
vad_type=nonlinear
vid
(ID videa)
Popis
Pomocí parametru ID zdroje obsahu (cmsid
) a ID videa (vid
) se předávají proměnné hodnoty.
Aby bylo možné cílit reklamy na videoobsah, musí značka hlavního videa obsahovat oba tyto parametry.
- Parametr
cmsid
je pro každý zdroj obsahu jedinečné číslo. Ve službě Google Ad Manager ho najdete tak, že kliknete na Video, pak na Zdroje obsahu a pak na název zdroje. - Parametr
vid
je řetězec nebo číslo, které označuje konkrétní video. Toto ID je přidělováno systémem CMS, ve kterém je obsah hostován. Ve službě Google Ad Manager ho najdete tak, že kliknete na Video, pak na Obsah a pak na konkrétní videoobsah.
Příklady použití
cmsid=[value]&vid=[value]
Pokud vytváříte značku pro videa na vyžádání s dynamickým vkládáním reklam, měli byste použít makra, která dynamicky vloží správný zdroj obsahu a ID videa:
Příklad: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Požadavky a doporučení
Tyto parametry nejsou u žádné konkrétní implementace ani u žádného typu transakce povinné k zobrazování reklam, ale jsou povinné k použití cílení na videoobsah.
vpi
(Vložený playlist videí)
Popis
Pomocí parametru vloženého playlistu s videi (vpi
) se předává konstantní hodnota, která udává, zda se má zobrazit vložená šablona VMAP (vrácení šablony VAST v šabloně VMAP).
Pomocí tohoto parametru lze snížit latenci a zajistit omezení frekvence a konkurenčních vyloučení v celém videostreamu.
Příklady použití
Vrátit šablonu VAST:
vpi=1
Vrátit přesměrování:
vpi=0