Oznámení

K dispozici pouze ve službě Google Ad Manager 360.

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

záložkaPř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 rdididtypeis_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, idtypeis_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.

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.

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 omidPartnerNameomidPartnerVersion. Pokud nepoužíváte knihovnu PAL ani sadu IMA SDK, musíte nastavit parametry omid_psdk_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

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.

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ů IconIconClickFallbackImage 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.

Video na vyžádání

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
 
lineární živé vysílání

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.

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
11692754730902299907
true
Prohledat Centrum nápovědy
true
true
true
true
true
148
false
false