Poskytnutí parametrů cílení pro stream

Poskytnutí všech následujících parametrů cílení je volitelné.

Při vytváření nebo konfiguraci zdroje obsahu pro video na vyžádání (VOD) nebo nastavování přímého přenosu pro DAI je třeba zadat výchozí značku videoreklamy. Ve výchozím nastavení budou všechny streamy DAI používat tuto značku a její parametry. Parametry značky reklamy se vztahují na reklamy uprostřed videa i na reklamy před videem. Pokud z přehrávače budete chtít pro konkrétní stream požádat o něco jedinečného, máte k dispozici tyto možnosti.

Parametry značek reklam Ad Manager, které lze přepsat

Přechod na konkrétní parametr:

addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent givn|paln idtype is_lat iu

iu is_lat ltd mpt mpv npa omid_p ppid ptpl ptpln rdid rdid

rdp sdk_apis sid sz tfcd trt vconp vpa vpmute wta

 

Přepsání výchozí značky reklamy

Když přehrávač videa požádá o stream, použije se výchozí značka reklamy přesně tak, jak jste ji v uživatelském rozhraní nastavili. Některé parametry této značky však v žádosti o stream můžete přepsat. Přepsat lze pouze parametry uvedené v tabulce níže.

Přečtěte si, jak přepsat výchozí značku reklamy pomocí sady IMA SDK nebo pomocí SSB.

Parametr	Popis	Příklad hodnoty
iu	Aktuální reklamní jednotka. Měla by mít tento formát: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	Páry klíč–hodnota, které mají být použity k cílení kampaní Ad Manager. Některé platformy vyžadují zakódování pro URL. Na sadu IMA DAI SDK pro HTML5 se tento požadavek nevztahuje, protože u ní je hodnota zakódována automaticky. Tento parametr nebude fungovat v případě, že je již zakódován v kódu HTML5.	Příklady s několika páry klíč–hodnota: section=sports  page=golf,tennis   Streamy SSB: Celou hodnotu parametru cust_params zakódujte a spojte dohromady, ale nezakódovávejte ji dvakrát. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: Zakódujte pouze hodnoty. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: Celou hodnotu parametru cust_params zakódujte a spojte dohromady, ale nezakódovávejte ji dvakrát. request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS a tvOS: Nic nezakódovávejte. request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: Nic nezakódovávejte. Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	Přepíše parametr sz z výchozí značky reklamy, což umožňuje dynamicky jej měnit pro různá zařízení. Za velikostí neuvádějte písmeno „v“.	sz=400x300
tfcd	Označuje žádost z hlediska určení dětem. Když požadavek DAI obsahuje parametr tfcd=1, kvůli zajištění souladu se zákonem COPPA se odstraní všechny hodnoty přiřazené parametrům rdid, idtype a is_lat.	tfcd=1
description_url	Hodnota by měla popisovat video, které se na stránce přehrává. Obvykle se jedná o stránku, na které je umístěn přehrávač videa, ale může to být i stránka s textem, který video popisuje. U streamů SSB a při použití sady IMA DAI SDK pro Roku je parametr description_url vždy potřeba zakódovat pro URL. Na sadu IMA DAI SDK pro HTML5 se tento požadavek nevztahuje, protože u ní je hodnota zakódována automaticky. Tento parametr nebude fungovat v případě, že je již zakódován v kódu HTML5. Sada IMA SDK tento parametr nenastavuje automaticky. Je třeba ho nastavit ručně. Pokud používáte službu Ad Exchange, je toto pole povinné. Další informace	Příklad zakódovaný pro URL: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html Nezakódovaný příklad: description_url= http://www.sample.com/ golf.html
ppid	Pomocí identifikátoru poskytnutého majitelem stránek (PPID) mohou majitelé stránek odeslat identifikátor, který bude používán k omezení frekvence, segmentaci publika, cílení na publikum, sekvenčnímu střídání reklam a dalšímu řízení zobrazování reklam napříč zařízeními. Další informace	ppid= 12JD92J...
ciu_szs	Seznam čárkou oddělených velikostí doprovodných reklam. Doprovodné reklamy jsou u DAI podporovány pouze při použití sady SDK HTML5.	ciu_szs=728x90,300x250
mpt	Udává název přehrávače partnera. Tento parametr budou používat zejména partneři jako jsou JWPlayer, Brightcove nebo Ooyala, kteří provádějí integraci se sadou SDK.	mpt=JWPlayer
mpv	Udává verzi přehrávače partnera. Tento parametr by měl být nastaven pouze v případě, že je nastaven také parametr mpt. Představuje verzi přehrávače partnera, která je integrována se sadou SDK.	mpv=2.1
ptpl	ID šablony reklamní přestávky. Toto ID naleznete v adrese URL služby Ad Manager při zobrazení nastavení šablony přestávky v rozhraní služby Ad Manager. Zobrazuje se jako hodnota parametru break_template_id.	ptpl=1234
ptpln	Název šablony reklamní přestávky. Odpovídá poli Název ve službě Ad Manager, nikoli zobrazovanému názvu.	ptpln=my_break_template
an	Parametr an je název aplikace. U žádostí odeslaných z mobilních aplikací a televizí připojených k internetu by měl být zahrnut, protože ho většina programatických videoreklam vyžaduje.* Sada IMA SDK tento parametr vyplní automaticky. U DAI API a SSB (prostředí bez sady SDK) je ho však nutné zadat ručně. * Název aplikace by měl být pro člověka čitelný. V systémech iOS a tvOS však sada SDK nemá přístup k devítimístnému ID v obchodě App Store. V těchto případech sada SDK odešle balíček aplikace prostřednictvím parametru an (ve formátu com.package.publisher).	an=sample%20app
ltd	Určuje, zda se mají reklamy zobrazovat omezeným způsobem, pokud není k dispozici souhlas s používáním souborů cookie nebo jiných místních identifikátorů. Další informace	ltd=1
rdid idtype is_lat	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 Řešení pro práci s videoreklamami na straně klienta. 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.	Prohlédněte si podrobné příklady resetovatelných identifikátorů zařízení.
trt	Označuje provoz jako zakoupený nebo jiný.	Nedefinovaný typ provozu: trt=0 Zakoupený provoz: trt=1 Neplacený provoz: trt=2
vconp	Doporučeno v pokynech rady MRC k měření videí Udává, zda má přehrávač v úmyslu přehrávat videa s obsahem souvisle po sobě, podobně jako v televizním vysílání. Možné hodnoty jsou 2, pokud je nepřetržité přehrávání zapnuté, a 1, pokud je vypnuté. Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený.	Nepřetržité přehrávání zapnuto: vconp=2   Nepřetržité přehrávání vypnuto: vconp=1
vpa	Doporučeno v pokynech rady MRC k měření videí Udává, zda se reklama začne přehrávat automaticky, nebo po kliknutí. 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ý.	Automatické přehrání: vpa=auto   Přehrání po kliknutí: vpa=click
vpmute	Doporučeno v pokynech rady MRC k měření videí Udává, zda se reklama začne přehrávat v přehrávači videa s vypnutým zvukem. Možné hodnoty jsou 1 pro vypnutý zvuk a 0 pro zapnutý zvuk. Pokud toto chování není známo, měl by být tento parametr ponechán nenastavený.	Vypnutý zvuk: vpmute=1   Zapnutý zvuk: vpmute=0
npa	Nastavení personalizace žádostí o reklamy. Tento parametr byste měli uvést na začátku značky, abyste předešli riziku jeho oříznutí. Zadáním hodnoty npa=1 označíte žádost jako žádost o nepersonalizovanou reklamu. Pokud tento parametr vynecháte, použijí se personalizované reklamy.	npa=1
omid_p	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ř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
gdpr gdpr_consent	Tato pole se používají k předávání informací o souhlasu systému TCF 2.0 pro příchozí i odchozí požadavky na synchronizaci souborů cookie.	Viz specifikace pro GDPR.
givn|paln	U integrací, které používají knihovnu programatického přístupu (PAL), se pomocí parametru video nonce předává proměnlivá 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.	Další informace o hodnotě předávané pomocí tohoto parametru najdete v příručkách Začínáme ke knihovně PAL.
addtl_consent	Seznam poskytovatelů reklamních technologií Google, pro které byl udělen souhlas a kteří nejsou zaregistrováni u organizace IAB.	Viz specifikace režimu dalšího souhlasu.
rdp	Pokud chcete 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í údajů omezeno pouze v případě, že je na úrovni sítě zapnuto nastavení Omezit zpracování dat.	rdp=1
sdk_apis	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 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.	sdk_apis=2,7,9
sid	Typ reklamního identifikátoru, který zachovává soukromí a který lze používat pouze k omezení frekvence. Podle pokynů organizace IAB ohledně reklamních identifikátorů musí být tento parametr vyplněn ve formátu UUID. Další informace Z předávání ID relace se můžete odhlásit nastavením parametru sid=0.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Udává, zda přehrávač videa podporuje vykreslení zprávy „Proč tato reklama?“. Při použití sady IMA SDK je tato funkce podporována automaticky. Pokud se nepoužívá sada IMA SDK, musí přehrávače videa implementovat podporu prvků Icon a IconClickFallbackImage standardu VAST podle dokumentace v tomto průvodci rozhraním DAI API.*  Zpráva „Proč tato reklama“ není podporována u SSB. Pokud používáte službu Ad Exchange, je toto pole povinné. Další informace * Podpora prvku IconClickFallbackImage je vyžadována pouze u televizních zařízení připojených k internetu.	Podporováno: wta=1 Nepodporováno: wta=0

Přepsání výchozí značky reklamy pomocí sady IMA SDK

Když přehrávač videa žádá o stream DAI pomocí sady IMA SDK, může předat pole adTagParameters. V této struktuře podobné slovníku lze nastavit páry klíč–hodnota, v nichž lze jako klíče použít parametry značek Ad Manager uvedené v tabulce výše.

Pomocí této struktury můžete stream přizpůsobit a předávat parametry, které nesouvisejí se žádostí o reklamu služby Ad Manager. Přečtěte si, jak požádat o konkrétní varianty streamu a jak nastavit reklamní prázdniny.

Implementace pole adTagParameters se u jednotlivých programovacích jazyků a platforem mírně liší. Další informace naleznete ve vývojářské dokumentaci pro iOS, Android, tvOS, Chromecast a HTML5 nebo v další dokumentaci v průvodci pro vývoj přehrávačů a aplikací s DAI.

 

Nastavení parametrů adTagParameters pomocí sady SDK

Při nastavování parametrů cust_params nebo description_url pomocí sady SDK v aplikacích pro iOS, tvOS a Android řetězce nezakódovávejte pro URL. Parametry cust_params můžete předávat pomocí jednoho řetězce se všemi páry klíč hodnota spojenými za sebou a oddělenými znakem &.

Příklad nastavení parametru cust_params na hodnotu sport=football&city=newyork:

Struktura adTagParams s nezakódovanými hodnotami:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport=football&city=newyork",
  "description_url": "http://www.sample.com/golf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Struktura adTagParameters se zakódovanými hodnotami pro žádosti o stream z prostředí HTML5:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport%3Dfootball%26city%3Dnewyork",
  "description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Struktura adTagParams se zakódovanými hodnotami pro žádosti o stream z prostředí Roku:

request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

Přepsání výchozí značky reklamy pomocí DAI API ^{(verze beta)} 

Když přehrávač videa žádá o stream DAI pomocí rozhraní DAI API, může volitelně předat páry klíč–hodnota, v nichž lze jako klíče použít parametry značek Ad Manager uvedené v tabulce výše.

Tyto parametry je u lineárního/živého streamu i u videí na vyžádání (VOD) potřeba odeslat v těle požadavku HTTP POST jako typ formuláře application/x‐www‐form‐urlencoded.

Pomocí této struktury můžete stream přizpůsobit a předávat parametry, které nesouvisejí se žádostí o reklamu služby Ad Manager. Přečtěte si, jak požádat o konkrétní parametry varianty streamu a ověření HMAC.

Další informace naleznete v ukázkové implementaci rozhraní DAI API.

Přepsání výchozí značky reklamy pomocí SSB

Níže jsou uvedeny příklady úprav výchozí značky reklamy SSB pro videa na vyžádání. Přepsané parametry předané přehrávačem nebo aplikací jsou zvýrazněny.

Příklady videa na vyžádání

	Příklad
Základní adresa URL streamu VOD	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8
(se zadanou reklamní jednotkou)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit
(s přepsanými páry klíč–hodnota)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2
(s deklarací obsahu určeného dětem)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfcd=1
(s přepsanou reklamní jednotkou A páry klíč–hodnota A vlastním parametrem description_url A deklarací obsahu určeného dětem)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

 

Příklady streamů živého lineárního vysílání

	Příklad
Základní adresa URL streamu živého lineárního vysílání	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8
(se zadanou reklamní jednotkou)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit
(s přepsanými páry klíč–hodnota)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2
(s deklarací obsahu určeného dětem)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1
(s přepsanou reklamní jednotkou A páry klíč–hodnota A vlastní adresou description_url A deklarací obsahu určeného dětem)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

Dynamická aktualizace parametrů cílení během živého přenosu

Pomocí metody replaceAdTagParameters sady IMA DAI SDK můžete dynamicky aktualizovat údaje o cílení pro konkrétního uživatele během sledování streamu.

Ohledně záležitostí souvisejících s odstraňováním problémů s DAI nebo s výpadky DAI kontaktujte podporu pro majitele obsahu.