Požadovaná stránka nie je momentálne k dispozícii vo vašom jazyku. V dolnej časti stránky si môžete vybrať iný jazyk alebo si môžete okamžite preložiť ľubovoľnú webovú stránku do požadovaného jazyka pomocou vstavanej funkcie prekladu v prehliadači Google Chrome.

Parametry adres URL značek reklam VAST

Všechny parametry značek reklam VAST

Úplný seznam parametrů bez ohledu na implementaci

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

Poznámka: Kategorizace na této stránce se vztahuje na používání těchto parametrů k zobrazování reklam. Některé parametry však mohou být povinné nebo doporučené pro konkrétní typy implementace nebo použití funkcí. Projděte si požadavky a doporučení pro konkrétní typ implementace.

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

Rozbalit vše Sbalit vše

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ý.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web

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. 

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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í.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

Tento parametr je povinný pro programatické zpeněžování v digitálních venkovních reklamách.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy

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í.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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í.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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í.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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 omidPartnerNameomidPartnerVersion. Pokud nepoužíváte sadu PAL ani IMA SDK, musíte nastavit parametry omid_psdk_apis.
  • Tento parametr by se neměl používat při použití sady IMA SDK, protože je nastaven automaticky.

Zpět do seznamového zobrazení

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.

Varování

Od systému iOS 14.5 společnost Apple ukončila podporu signálu LAT. Google místo toho spoléhá na přítomnost nenulového identifikátoru IDFA, který značí, že uživatel souhlasil se sledováním ve verzích systému iOS, které podporují transparentnost měření aplikací. Je proto vyžadována platná hodnota UserAgent udávající správnou verzi operačního systému.

Příklady použití

Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení.

Požadavky a doporučení

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy

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í.

Zpět do seznamového zobrazení

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 a allcues 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 parametr vid_d.

Příklady použití

Trvání videa 90000 sekund (25 hodin):
vid_d=90000

Požadavky a doporučení

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy

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.

Zpět do seznamového zobrazení

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 parametr wta vynechte, případně předejte parametr wta 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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy

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ů IconIconClickFallbackImage podle dokumentace ve standardu IAB VAST.

Zpět do seznamového zobrazení

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=1ad_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.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy

  • 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.

Zpět do seznamového zobrazení

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 nonLinearAdSlotWidthnonLinearAdSlotHeight.

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.

Zpět do seznamového zobrazení

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 a allcues 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 parametr vid_d.

Příklady použití

Signální body v časech 10 a 20 sekund:
allcues=10000,20000

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Varování

Od systému iOS 14.5 společnost Apple ukončila podporu signálu LAT. Google místo toho spoléhá na přítomnost nenulového identifikátoru IDFA, který značí, že uživatel souhlasil se sledováním ve verzích systému iOS, které podporují transparentnost měření aplikací. Je proto vyžadována platná hodnota UserAgent udávající správnou verzi operačního systému.

Příklady použití

Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení.

Požadavky a doporučení

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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éna inventorypartnerdomain 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í.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Varování

Od systému iOS 14.5 společnost Apple ukončila podporu signálu LAT. Google místo toho spoléhá na přítomnost nenulového identifikátoru IDFA, který značí, že uživatel souhlasil se sledováním ve verzích systému iOS, které podporují transparentnost měření aplikací. Je proto vyžadována platná hodnota UserAgent udávající správnou verzi operačního systému.

Příklady použití

Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení.

Požadavky a doporučení

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Na rozdíl od ostatních parametrů adresy URL nastavení 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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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ě.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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í.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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_floorgoogle_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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web

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ě.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web

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ě.

Zpět do seznamového zobrazení

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_floorgoogle_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.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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í pole schain

Podle dokumentace IAB definuje serializaci objektu SupplyChain následující kód:

  • {SupplyChainObject}!{SupplyChainNode array}. Vlastnosti SupplyChainObject a SupplyChainNode 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

Poznámka: Obsah pole 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:

Serializace s čárkami pro prázdná volitelná pole

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Serializace bez čárek pro prázdná volitelná pole

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.

Zpět do seznamového zobrazení

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í

Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro mobilní web Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro televize připojené k internetu Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro zvukové reklamy Kliknutím zobrazíte seznam parametrů VAST, které jsou povinné nebo doporučené pro digitální venkovní reklamu

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í.

Zpět do seznamového zobrazení

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.

Příklady použití

sdk_apis=2,7,9

Viz seznam možných hodnot rozhraní API.

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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).

Zpět do seznamového zobrazení

us_privacy (Řetězec ochrany soukromí pro USA organizace IAB)

Popis

Podporu řetězce us_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.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

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.

Zpět do seznamového zobrazení

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

Zpět do seznamového zobrazení

Pomohly vám tyto informace?

Jak bychom článek mohli vylepšit?
Vyhledávání
Vymazat vyhledávání
Zavřít vyhledávání
Hlavní nabídka
5571512644119948154
true
Prohledat Centrum nápovědy
true
true
true
true
true
148
false
false
false