Parametry adres URL pro značky reklam VAST

Adresy URL pro značky reklamy VAST používá přehrávač k načítání videoreklam a audioreklam. Adresu URL pro značku reklamy VAST můžete sestavit ručně (nebo pomocí níže uvedených parametrů upravit stávající adresu URL) a poté ji otestovat pomocí nástroje VAST Suite Inspector. Můžete si také prohlédnout a otestovat tyto vzorové značky.

Obecné požadavky na adresu URL

• Protokol: Značky reklam VAST podporují protokol http i https. Adresy URL k měření zobrazení respektují aktuální nastavení SSL a v závislosti na něm používají buď protokol http, nebo https. Cílová adresa URL a adresa URL na měření prokliků používají protokol http, protože přesměrovávají z jiné stránky.
• Doména: Použití dynamických domén vytvořených pomocí makra shody se vzorem nebo jinou dynamickou metodou není povoleno a povede k chybě.
• Přímé přenosy: Adresy URL pro značky reklam pro videa v přímém přenosu musejí v cestě obsahovat řetězec /live, aby zvládaly velké objemy provozu, když se všechny reklamní přestávky zobrazují zároveň.

Příklad značky reklamy VAST

Ukázková adresa URL pro značku reklamy VAST s parametry a přiřazenými hodnotami by vypadala nějak takto:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

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

aconp ad_rule ad_type addtl_consent afvsz allcues an ciu_szs correlator cmsid cust_params description_url dth env excl_cat gdfp_req gdpr gdpr_consent givn

hl iabexcl idtype ipd ipe is_lat iu lip ltd max_ad_duration min_ad_duration mridx msid nofb npa omid_p output paln plcmt

pmad pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp schain scor

sdk_apis sdmax sid ssss sz tfcd trt unviewed_position_start url vad_type vconp vid vid_d vpa vpi vpmute vpos wta

Parametr	Podrobnosti
aconp (Nepřetržité přehrávání zvuku)	Doporučeno v pokynech rady MRC k měření audioreklam Pomocí parametru nepřetržitého přehrávání zvukového obsahu se předává konstantní hodnota, která udává, zda bude přehrávač zvukový obsah přehrávat souvisle. Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený. Příklad použití Nepřetržité přehrávání zapnuto: aconp=2 Nepřetržité přehrávání vypnuto: aconp=1
ad_rule (Pravidlo reklamy)	Pomocí parametru pravidla reklamy 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ě Ad Manager. Nastavení konkrétních značek reklam můžete přepsat podle příkladů níže. Příklad použití Žádost o kreativu VAST: ad_rule=0 Žádost o pravidla reklamy (VMAP): ad_rule=1 Požadavek Povinné pro pravidla videoreklamy
ad_type (Typ reklamy)	Pomocí parametrů typu reklamy se předává konstantní hodnota, která určuje, jaké typy reklam mají být pro žádost vráceny. Tento parametr je povinný pouze u zvukových reklam. 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 (Při této hodnotě mohou soutěžit oba formáty, ale zobrazí se pouze jeden.) Typ reklamy audio_video je určen pouze 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 pro obsah, který ve své podstatě může být poslouchatelný. Může se jednat například o sportovní přenosy, videocasty, zprávy atd. 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žadavek Povinné pro zvukové reklamy
addtl_consent (Další souhlas)	Pomocí parametru dalšího souhlasu 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. 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 najdete v technické specifikaci režimu dalšího souhlasu. Příklad použití addtl_consent=1~1.35.41.101
afvsz (Velikosti nelineárních reklam)	Pomocí parametru velikosti nelineární reklamy 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 bude toto pole přepsáno a vyplněno 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říklad 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žadavek Vyžadováno u nelineárních videoreklam, pokud se nepoužívá sada IMA SDK
allcues (Všechny signální body)	Pomocí tohoto parametru 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 služba Ad Manager vytvoří 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říklad použití Signální body v časech 10 a 20 sekund: allcues=10000,20000
ciu_szs (Velikosti doprovodných reklam)	Pomocí parametru velikostí doprovodných reklam 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říklad použití ciu_szs=728x90,300x250 Velikosti s blokem pro více velikostí: ciu_szs=728x90,300x200|300x250
cmsid (ID zdroje obsahu) vid (ID videa)	Pomocí parametru ID zdroje obsahu a ID videa 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ě Ad Manager ho najdete tak, že kliknete na Video  Zdroje obsahu a poté 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ě Ad Manager ho najdete tak, že kliknete na Video  Obsah a poté na konkrétní videoobsah. Příklad použití cmsid=[value]&vid=[value] Pokud vytváříte značku pro dynamické vkládání reklam do videí na vyžádání, 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žadavek Povinné pro Cílení na videobsah
correlator (Korelátor)	Pomocí parametru korelátoru 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ři použití sady IMA SDK se hodnota parametru correlator 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. Příklad použití correlator=4345645667 Požadavek Povinné pro web a aplikace Doporučeno pro programatické zpeněžování
cust_params (Vlastní parametry klíč–hodnota)	Pomocí parametru pro vlastní parametry 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říklad použití Příklady přidání párů klíč–hodnota
description_url (Adresa URL popisu)	Parametr adresy URL popisu se nastavuje na proměnnou hodnotu, která by měla popisovat video přehrávané na stránce. Rozvrhněte stránku v 1–3 odstavcích s popisem obsahu. Můžete například dynamicky sešít obsah stránky description_url z předdefinovaných bloků. Další informace o poskytnutí samostatné adresy URL popisu U přehrávačů videí na webových stránkách, televizích připojených k internetu a zařízení over-the-top musí být hodnota description_url zakódována pro URL a u přehrávačů videí v mobilních aplikacích nesmí být zakódována. Sada IMA SDK tento parametr nenastavuje automaticky. Je třeba ho nastavit ručně. Příklad použití Zakódováno pro URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Nezakódováno: description_url= https://www.sample.com/golf.html Požadavek Povinné pro web, aplikace a Ad Exchange Doporučeno pro programatické zpeněžování
dth (Informace o typu zařízení)	Pomocí parametru pro informace o typu zařízení 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žadavek Doporučeno pro programatické zpeněžování na televizích připojených k internetu. 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.
env (Prostředí)	Pomocí parametru prostředí 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říklad použití Video nebo zvuk: env=instream Pouze video: env=vp Požadavek Povinné pro web a aplikace
excl_cat (Kategorie vyloučení)	Pomocí parametru vyloučení kategorií se předávají proměnné hodnoty a používá se k blokování řádkových položek, které obsahují příslušný štítek vyloučení, aby se u dané žádosti o reklamy nemohly zobrazit. Tento parametr funguje s parametrem cust_params. Příklad použití &cust_params=excl_cat%3Dairline_excl_label%7C
gdfp_req (Indikátor schématu služby Ad Manager)	Pomocí parametru indikátoru schématu služby Ad Manager se předává konstantní hodnota, která udává, že uživatel podporuje schéma služby Ad Manager. Příklad použití gdfp_req=1 Požadavek Povinné pro web a aplikace
gdpr (GDPR)	Pomocí parametru pro 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říklad použití Na žádost se vztahuje GDPR: gdpr=1 Na žádost se nevztahuje GDPR: gdpr=0
gdpr_consent (Souhlas podle GDPR)	Pomocí parametru souhlasu pro GDPR 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říklad použití gdpr_consent=GDPR_CONSENT_123
givn paln (Nonce videa)	For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value. The nonce is URL safe—you don't need to URL-encode it. Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters. Usage example You can read more about the value passed to this parameter in the getting started guides for PAL.
hl (Jazyk)	Pomocí parametru jazyka se předává konstantní hodnota, která se používá k žádání o reklamy v určitém jazyce a k určení jazyka pro výběr reklam a vykreslování videoreklam v dynamické alokaci pro služby Ad Exchange a AdSense pro video. Hodnota parametru může být libovolný kód ISO 639-1 (dvoupísmenný) nebo ISO 639-2 (třípísmenný). Viz seznam platných kódů. V případě vynechání tohoto parametru se použije hodnota libovolného jazyka s cílením reklam podle jazyka v Ad Exchange. Příklad použití hl=it Požadavek Doporučeno pro programatické zpeněžování
iabexcl (Adresa URL vyloučení IAB)	Pomocí parametru adresy URL iabexcl se předává seznam kategorií oddělených čárkami. Příklad použití iabexcl=3,14,527 vylučuje kategorie Komerční nákladní auta, Terénní vozidla a Ragby. Další informace o taxonomii obsahu IAB
ipd (Doména partnera pro inventář)	Pomocí parametru domény partnera pro inventář 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). Další informace o souborech ads.txt/app-ads.txt a partnerech pro sdílení inventáře.
ipe (Entita signálu pro hlášení zobrazení)	Pomocí parametru entity signálu pro hlášení 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. Příklad použití Signalizace na straně serveru (SSB): ipe=ssb
iu Reklamní jednotka	Pomocí parametru reklamní jednotky se předává proměnná hodnota, která by měla být nastavena na aktuální reklamní jednotku v následujícím formátu: /network_code/.../ad_unit Příklad použití iu=/6062/videodemo Požadavek Povinné pro web a aplikace
lip (Poslední pozice v podu)	Pomocí parametru poslední pozice v podu se předává konstantní hodnota, která udává, že se jedná o žádost z poslední pozice v podu. Tento parametr je určen pouze pro standardní pody. Příklad použití lip=true
ltd (Omezené reklamy)	Pomocí parametru omezených reklam 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. 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říklad použití ltd=1
min_ad_duration (Minimální trvání reklamy) max_ad_duration (Maximální trvání reklamy)	Pomocí parametrů trvání reklamy se předávají proměnné hodnoty, které společně určují rozsah požadovaného trvání reklamy v milisekundách. Pomocí tohoto parametru můžete omezit trvání jednotlivých reklam u jednotlivých žádostí o reklamy a optimalizovaných podů. Příklad použití min_ad_duration=15000&max_ad_duration=30000
mridx (Číslo reklamy uprostřed videa)	Pomocí parametru čísla reklamy uprostřed videa 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říklad použití mridx=2
msid (ID aplikace) an (Název aplikace)	Pomocí parametrů ID aplikace a názvu aplikace se předávají proměnné hodnoty, které by měly být použity u žádostí odeslaných z mobilních aplikací a televizních zařízení připojených k internetu, protože jsou u většiny programatických videoreklam vyžadovány. Sada IMA SDK vyplní oba parametry automaticky. V prostředích bez sady SDK je však potřeba je zadat ručně. Týká se to i přímých volání šablony VAST, použití knihovny programatického přístupu (PAL) a inventáře ověřeného majitelem stránek (PAI). Název aplikace by měl být pro člověka čitelný. V systémech iOS a tvOS však sada SDK k ID aplikace nemá přístup. V těchto případech se parametr msid neodešle a sada SDK odešle balíček aplikace prostřednictvím parametru an. Příklad použití msid=com.package.publisher&an=sample%20app Název a formát ID aplikací se v jednotlivých obchodech s aplikacemi liší. Viz pokyny organizace IAB pro identifikaci aplikací nebo příklady běžných jedinečných identifikátorů. U platforem bez obchodu s aplikacemi organizace IAB majitelům obsahu doporučuje používat pro ID v obchodě následující formát: com.publisher.deviceplatform Požadavek Oba parametry jsou u aplikací povinné. Doporučeno pro programatické zpeněžování
nofb (Záložní reklama zakázána)	Pomocí parametru k zakázání záložních reklam 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říklad použití Zakázání záložních reklam: nofb=1
npa (Nepersonalizované reklama)	Pomocí parametru nepersonalizovaných reklam 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 konkrétně hodnotu npa=1, nebo zahrnout parametr npa 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říklad použití Nepersonalizované reklamy: npa=1
omid_p (Název partnera OMID)	Pomocí parametru názvu partnera OMID se předává proměnná hodnota, která udává název a verzi partnera provádějícího měření OMID. 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). Tento parametr by se neměl používat při použití sady IMA SDK, protože je nastaven automaticky. 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 rozhraní API omidPartnerName a omidPartnerVersion. Pokud nepoužíváte knihovnu PAL ani sadu IMA SDK, musíte nastavit parametry omid_p a sdk_apis (podporovaná rozhraní API, která mohou zahrnovat i další rozhraní API oddělená čárkami). Příklad použití Při použití knihovny PAL: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Pokud knihovnu PAL nepoužíváte: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
output (Výstupní formát reklamy)	Pomocí parametru výstupního formátu reklamy se předává konstantní hodnota, kterou je potřeba nastavit na výstupní formát reklamy. Pro výchozí verzi šablony VAST nastavenou pro síť použijte hodnotu output=vast. Pro konkrétní značky reklam nebo části webu můžete žádat o konkrétní verze VAST nebo VMAP. Pokud přehrávač 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. Pokud chcete použít výchozí verzi VMAP (například VMAP 1), kterou máte aktivovanou pro síť, použijte output=vmap. Pokud v šabloně VMAP odesíláte šablonu VAST, můžete pomocí hodnot xml_vmap1_vast3 nebo xml_vmap1_vast4 zadat, která verze šablony VAST se má odeslat. Příklad použití Výchozí nastavení šablony VAST sítě: output=vast VAST 4: output=xml_vast4 Výchozí nastavení verze VMAP sítě: output=vmap VMAP 1: output=xml_vmap1 VMAP 1, vrací VAST 4: output=xml_vmap1_vast4 Požadavek Povinné pro web a aplikace
plcmt (Umístění)	Pomocí parametru umístění se předává konstantní hodnota, která udává, zda je inventář in-stream deklarován jako in-stream, nebo doprovodný (podle pokynů ve specifikacích organizace IAB). U žádostí jiného typu než in-stream se toto pole pro kupující vyplňuje automaticky na základě deklarovaného formátu inventáře a případnou deklaraci obsahu in-stream nebo doprovodného obsahu přepíše. Příklad použití Žádost z umístění in-stream: plcmt=1 Žádost z umístění v doprovodném obsahu: plcmt=2 Požadavek Povinné pro web a programatické zpeněžování
pmad (Maximální počet reklam v podu)	Pomocí parametru maximálního počtu reklam v podu se předává proměnná hodnota, která udává maximální počet reklam v podu. Tento parametr je specifický pro optimalizované pody, které jsou k dispozici majitelům stránek s rozšířeným balíčkem pro videa. Neměl by se používat pro VMAP (když ad_rule=1). Příklad použití pmad=4
pmnd (Minimální trvání podu) pmxd (Maximální trvání podu)	Pomocí parametrů trvání podů 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. * Jsou specifické pro optimalizované pody, které jsou k dispozici majitelům stránek s rozšířeným balíčkem pro videa. Neměly by se používat pro VMAP (když ad_rule=1). Příklad použití pmnd=0&pmxd=60000
pod (Číslo podu)	Pomocí parametru čísla podu se předává proměnná hodnota, která představuje pořadí podu ve videu (například 1. pod, 2. pod atd.) Příklad použití pod=3 Požadavek Je potřeba ke správnému fungování konkurenčních vyloučení, omezení frekvence a souvisejících funkcí.
pp (Profil kreativ)	Pomocí parametru profilu kreativ se předává proměnná hodnota určující, které kreativy se na základě konfigurace nastavené v profilu videokreativ a zvukových kreativ mohou zobrazit. Příklad použití pp=creative_profile Požadavek Doporučeno pro programatické zpeněžování
ppt (Publisher Privacy Treatment)	Pomocí parametru rozhraní Publisher Privacy Treatment se předává konstantní hodnota, která udává, zda má být u žádosti o reklamy vypnuta personalizace reklam. Další informace o rozhraní Publisher Privacy Treatment Příklad použití Vypnutí personalizace reklam: ppt=1
ppid (Identifikátor poskytnutý majitelem stránek)	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. Příklad použití ppid=12JD92JD8078S8J29SDOAKC0EF230337
ppos (Pozice v podu)	Pomocí parametru pozice v podu 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. Příklad použití ppos=2 Požadavek Je potřeba ke správnému fungování konkurenčních vyloučení, omezení frekvence a souvisejících funkcí.
ppsj (Signály poskytnuté majitelem obsahu ve formátu JSON)	Pomocí parametru signálů poskytnutých majitelem obsahu ve formátu JSON se předává 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í. Další informace o signálech poskytovaných majitelem obsahu a podporovaných taxonomiích Podrobnosti o platných párech klíč–hodnota v objektu JSON najdete v ukázce sady HTML5 IMA SDK. Příklad použití Objekt JSON: {   "PublisherProvidedTaxonomySignals": [{      "taxonomy": "IAB_AUDIENCE_1_1",      "values": ["6", "284"]   }] } Hodnota zakódovaná pomocí kódování base64: eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ
ptpl (ID šablony reklamní přestávky) ptpln (Název šablony reklamní přestávky)	Pomocí ID a názvu šablony reklamní přestávky se předávají hodnoty proměnných. Tyto parametry určují, která šablona reklamní přestávky se má pro žádost o optimalizovaný pod použít. Š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 dvou parametrů (název nebo ID). Příklad použití Další podrobnosti o nastavení šablon reklamních přestávek aq žádání o ně najdete zde.
pubf (Veřejné minimální ceny ve značkách Ad Exchange) pvtf (Soukromé minimální ceny ve značkách Ad Exchange)	pubf je ekvivalentem parametru google_ad_public_floor a pvtf je ekvivalentem parametru google_ad_private_floor. Tyto parametry se používají k přidání minimálních cen do značek Ad Exchange. Příklad použití pubf=123 pvtf=123
pvid (ID sady aplikací) pvid_s (Rozsah sady aplikací)	Hodnoty ID sady aplikací jsou ke zpeněžení potřeba v případě, že se uživatelé na zařízeních Android odhlásí z personalizace. Pomocí parametru pvid se předává proměnná hodnota nastavená na ID sady aplikací pro Android a pomocí parametru pvid_s se předává konstantní hodnota, která představuje rozsah ID sady aplikací (buď scope_app, nebo scope_developer). 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ě. Viz informace o načtení ID sady aplikací v dokumentaci pro Android. Příklad použití pvid=[AppSetID_value] pvid_s=scope_app Požadavek Povinné pro aplikace Doporučeno pro programatické zpeněžování
rdid idtype is_lat (Resetovatelné identifikátory zařízení)	Pomocí resetovatelných identifikátorů zařízení se předávají proměnné hodnoty. U nativních aplikací sada SDK do žádostí o streamy pomocí parametrů rdid, idtype a is_lat předává resetovatelné identifikátory zařízení k cílení na uživatele. (U webů a mobilních webů tyto identifikátory nepředává.) U streamů SSB tyto identifikátory musíte předávat jako explicitní parametry, jako byste to dělali v případě žádosti o reklamy na straně klienta. Další informace o identifikátorech zařízení Tyto hodnoty jsou vyžadovány téměř u všech programatických videoreklam. Od systému iOS 14.5 společnost Apple ukončila podporu signálu LAT. Google místo toho spoléhá na přítomnost nenulového identifikátoru IDFA, který značí, že uživatel souhlasil se sledováním ve verzích systému iOS, které podporují transparentnost měření aplikací. Je proto vyžadována platná hodnota UserAgent udávající správnou verzi operačního systému. Příklad použití Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení. Požadavek Povinné pro aplikace Doporučeno pro programatické zpeněžování
rdp (Omezit zpracování dat)	Pomocí parametru omezení zpracování dat se předává konstantní hodnota, která značí, že u žádosti o reklamu musí být omezeno zpracování dat. Chcete-li omezit zpracování dat, musíte buď konkrétně nastavit parametr rdp=1, nebo parametr rdp jen zahrnout (bez nastavené hodnoty). U žádostí o reklamy, v nichž tento parametr buď chybí, nebo je nastaven na hodnotu rdp=0, bude zpracování dat omezeno pouze v případě, že je na úrovni sítě zapnuto nastavení Omezit zpracování dat. Příklad použití rdp=1
schain (Dodavatelský řetězec)	Pomocí parametru dodavatelského řetězce 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 SupplyChainNode 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 Další informace o objektu SupplyChain 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žadavek Vyžadováno 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)	Pomocí parametru korelátoru streamu se předává proměnná hodnota, která by měla být celé číslo vygenerované pro jednotlivé streamy videa. Číslo musí být v rámci streamu stejné a v rámci zobrazení stránky jedinečné. Používá se k vyloučení reklam konkurence, omezení frekvence a souvisejícím funkcím, pokud uživatel na jedné stránce sleduje více videí. Příklad použití scor=17 Požadavek Je potřeba ke správnému fungování konkurenčních vyloučení, omezení frekvence a souvisejících funkcí.
sdk_apis (Aplikační rámec SDK API)	Pomocí tohoto parametru aplikačního rámce SDK API 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. Viz seznam možných hodnot rozhraní API. Tento parametr podporuje rozhraní API v knihovně Programmatic Access Library (PAL) pro majitele stránek, kteří nepoužívají sadu IMA SDK. Sada IMA SDK všechny nastavené hodnoty přepíše hodnotami, které podporuje. Příklad použití sdk_apis=2,7,9
sdmax (Max. délka přeskočitelné reklamy)	Pomocí parametru žádosti o reklamu sdmax (maximální trvání přeskočitelné reklamy) se předává proměnná hodnota, pomocí níž mohou majitelé stránek zadat 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říklad 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.
sid (ID relace)	Pomocí parametru ID relace se předává proměnná hodnota, která představuje inzertní identifikátor zachovávající soukromí používaný pouze pro účely omezení frekvence. ID relace je podporováno u žádostí o reklamy in-stream z televizí připojených k internetu a u inventáře videí in-stream ze zařízení s mobilními aplikacemi. Pro web v současné době podporováno není. Podle pokynů organizace IAB ohledně reklamních identifikátorů by tento parametr musí být vyplněn ve formátu UUID. Další informace o resetovatelných identifikátorech zařízení pro cílení na uživatele. Z předávání ID relace se můžete odhlásit nastavením parametru sid=0. Příklad použití 123e4567-e89b-12d3-a456-426614174000 Požadavek Doporučeno pro programatické zpeněžování
ssss (Zdroj spojování na straně serveru)	Pomocí parametru zdroje spojování na straně serveru 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říklad použití ssss=mystitcher Požadavek Povinné pro implementace na straně serveru.
sz (Velikost)	Pomocí parametru velikosti 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říklad použití sz=400x300 Požadavek Povinné pro web a aplikace Pokud žádáte pouze o zvukové reklamy (ad_type=audio), je tento parametr volitelný.
tfcd (Označení obsahu určeného dětem)	Pomocí parametru k označení obsahu jako určeného dětem se předává konstantní hodnota, která udává, že má být žádost o reklamu považována za určenou dětem. Příklad použití tfcd=1
trt (Typ provozu)	Pomocí parametru typu provozu se předává konstantní hodnota, která slouží k vyžádání zakoupeného nebo neplaceného provozu. 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). Příklad použití Žádost pro zakoupený provoz: trt=1 Žádost pro neplacený provoz: trt=2
unviewed_position_start (Zpožděná zobrazení)	Pomocí parametru zpožděných zobrazení se předává konstantní hodnota, která značí zpožděná zobrazení videa. Příklad použití unviewed_position_start=1 Požadavek Povinné pro web a aplikace
url (Adresa URL)	Pomocí parametru adresy URL se předává proměnná hodnota, která by měla být nastavena na úplnou adresu URL, z níž byla žádost odeslána. Tato hodnota je potřeba k tomu, aby kupující poznali, ze kterého kontextu tato žádost pochází. Pokud je to možné, měla by být tato hodnota u žádosti o reklamy vyplněna dynamicky.  U webové stránky se jedná o adresu URL stránky, na které se zobrazuje přehrávač videí. Pokud používáte sadu IMA SDK, nastavuje se hodnota parametru URL automaticky. Pokud tuto hodnotu nastaví přehrávač, sada IMA SDK bude nastavenou hodnotu respektovat. V aplikaci (pro mobilní zařízení nebo televize připojené k internetu) by tato hodnota měla být nastavena na adresu URL, která nejlépe reprezentuje zpeněžovaný videoinventář nebo zvukový inventář. Pokud se například uživatel dívá na video v mobilní aplikaci, která je k dispozici také ve formě adresy URL pro počítače, měl by být tento parametr nastaven na příslušnou adresu URL.* Hodnota tohoto parametru by měla být zakódována. Příklad použití url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Pokud tento parametr u aplikací nelze nastavit na proměnnou hodnotu adresy URL, doporučujeme použít hodnotu v následujícím formátu: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Požadavek Povinné pro web a aplikace Doporučeno pro programatické zpeněžování
vad_type (Typ reklamy Video)	Pomocí parametru typu reklamy Video se předává konstantní hodnota, která udává, zda má být vrácena lineární či nelineární reklama. Příklad použití Vrátit lineární reklamu: vad_type=linear Vrátit nelineární reklamu: vad_type=nonlinear
vid_d (Trvání videa)	Pomocí tohoto parametru 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 jsou potřeba také pravidla reklamy. Příklad použití Trvání videa 90000 sekund (25 hodin): vid_d=90000
vconp (Nepřetržité přehrávání videa)	Doporučeno v pokynech rady MRC k měření videí Pomocí parametru nepřetržitého videa se předává konstantní hodnota, která udává, zda bude přehrávač videobsah přehrávat souvisle (podobně jako v televizním vysílání). Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený. Příklad použití Nepřetržité přehrávání zapnuto: vconp=2 Nepřetržité přehrávání vypnuto: vconp=1
vpa (Automatické přehrávání videí)	Doporučeno v pokynech rady MRC k měření videí Pomocí parametru automatického přehrávání se předává konstantní hodnota, která udává, zda se reklama ve videoobsahu spouští automaticky, nebo kliknutím. Možné hodnoty jsou click, pokud stránka čeká na akci uživatele, nebo auto, pokud se video začne přehrávat automaticky. Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený. Příklad použití Automatické přehrání: vpa=auto Přehrání kliknutím: vpa=click Požadavek Doporučeno pro programatické zpeněžování
vpi (Video playlist inred)	Pomocí parametru inred playlistu videí 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říklad použití Vrátit šablonu VAST: vpi=1 Vrátit přesměrování: vpi=0
vpmute (Přehrání videa s vypnutým zvukem)	Doporučeno v pokynech rady MRC k měření videí Pomocí parametru videa s vypnutým zvukem se předává konstantní hodnota, která udává, zda se reklama začne přehrávat, když je v přehrávači videa vypnutý zvuk. Příklad použití Vypnutý zvuk: vpmute=1 Zapnutý zvuk: vpmute=0 Požadavek Povinné pro web a programatické zpeněžování
vpos (Pozice videa)	Pomocí parametru pozice videa se předává konstantní hodnota, která udává, zda se jedná o žádost o reklamu před videem, uprostřed videa nebo za videem. Příklad použití Reklama před videem: vpos=preroll Reklama uprostřed videa: vpos=midroll Reklama za videem: vpos=postroll Požadavek Doporučeno pro programatické zpeněžování
wta (Proč tato reklama)	Pomocí parametru zprávy „Proč tato reklama?“ se předává konstantní hodnota, která udává, zda přehrávač videa podporuje zobrazení odznaku reklamy. Pokud parametr &wta není odeslán, použije se výchozí hodnota &wta=1. 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. Pokud majitel stránek ikonu AdChoices zahrnutou v odpovědi VAST nevykreslí, musí odeslat parametr &wta=0. Pokud žádost o reklamu zahrnuje parametr &wta=1 nebo parametr &wta​ nezahrnuje, znamená to, že majitel stránek poskytnuté informace AdChoices vykreslí. U žádostí o zvukové reklamy je parametr wta=1 povoleno odeslat v případě, že bude ikona AdChoices z odpovědi VAST vykreslena v doprovodných reklamách nebo jinak poskytnuta uživateli. U provozu z EHP nebudou žádosti s parametrem &wta=0 způsobilé pro rezervační kreativy, u kterých je zapnuté označování reklam od Googlu. 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í nezákonného obsahu musí vydavatelé společnost Google informovat pomocí příslušného formuláře. Příklad použití Podporováno: wta=1 nebo bez parametru wta Nepodporováno: wta=0 Požadavek Povinné pro Ad Exchange Povinné pro návštěvnost webů a aplikací z EHP Doporučeno pro programatické zpeněžování