Célzási paraméterek megadása a streamben

Az alábbi célzási paraméterek egyikét sem kötelező megadni.

Amikor egy igény szerinti videó (VOD) tartalomforrását hozza létre vagy konfigurálja, illetve élő közvetítést állít be a DAI (dinamikus hirdetésbeillesztés) számára, meg kell adnia az alapértelmezett videóhirdetési címkét. Alapértelmezés szerint minden DAI-stream ezt a hirdetési címkét és paramétereit használja. A hirdetésicímke-paraméterek a tartalom közbeni és a tartalom előtti hirdetésekre egyaránt érvényesek. Ha azt szeretné, hogy lejátszója valami egyedit kérjen egy adott stream számára, az alábbi lehetőségek állnak rendelkezésére.

Az Ad Manager felülbírálható hirdetésicímke-paraméterei

Ugrás a kívánt paraméterhez:

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

 

Az alapértelmezett hirdetéscímke felülírása

Amikor a videólejátszó streamet kér, a rendszer pontosan úgy fogja használni az alapértelmezett hirdetési címkét, ahogyan Ön meghatározta a kezelőfelületen. Önnek azonban a streamkérelemben lehetősége van a címke bizonyos paramétereinek felülbírálására. Ezek az egyedüli felülbírálható paraméterek.

További információ arról, hogyan írhatja felül az alapértelmezett hirdetési címkét az IMA SDK és az SSB használatával.

Paraméter	Leírás	Példaérték
iu	A jelenlegi hirdetési egység. A formátumnak a következőnek kell lennie: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	Kulcsértékpárok, melyeket az Ad Manager-kampánycélzásnál kell használni. Egyes platformoknál URL-kódolás szükséges. Az URL-kódolási követelmény nem vonatkozik az IMA DAI SDK HTML5 formátumban történő használatára, mert az értéket a rendszer automatikusan kódolja. Ez a paraméter nem működik, ha már kódolva van HTML5-ben.	Példák több kulcsértékpárral: section=sports  page=golf,tennis   SSB-streamek: Kódolja és fűzze össze a teljes cust_params értéket, de ne kódolja duplán. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: Csak az értékeket kódolja. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: Kódolja és fűzze össze a teljes cust_params értéket, de ne kódolja duplán. request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS és tvOS: Ne kódoljon semmit. request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: Ne kódoljon semmit. Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	Felülbírálja az Ön alapértelmezett hirdetési címkéjében szereplő sz paramétert, és lehetővé teszi a dinamikus váltást más eszközöknél. A méret után ne használja a „v” paramétert.	sz=400x300
tfcd	Gyermekközpontú bánásmód címkével látja el a kérelmet. Ha a DAI-kérelem tartalmazza a tfcd=1 paramétert, akkor a rendszer eltávolítja az rdid, az idtype és az is_lat paraméterhez tartozó értékeket a COPPA való megfelelés érdekében.	tfcd=1
description_url	Az értéknek az oldalon lejátszott videót kell leírnia. Ez általában az az oldal, amelyen a videólejátszó is megtalálható, de olyan oldal is lehet, amelyen a videót bemutató szöveg van. A description_url értéket mindig URL-kódolnia kell az SSB-streameknél és az IMA DAI SDK Roku eszközön való használata esetén. Ez a követelmény nem vonatkozik az IMA DAI SDK HTML5 formátumban történő használatára, mert az értéket a rendszer automatikusan kódolja. Ez a paraméter nem működik, ha már kódolva van HTML5-ben. Ezt a paramétert az IMA SDK nem állítja be automatikusan. Manuálisan kell beállítani. Az Ad Exchange használata esetén a mező kitöltése kötelező. További információ	Példa kódolt URL-re: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html Példa nem kódolt URL-re: description_url= http://www.sample.com/ golf.html
ppid	A megjelenítő által biztosított azonosító (PPID) lehetővé teszi a megjelenítők számára, hogy egy olyan azonosítót küldjenek a rendszernek, amelyet a gyakoriságkorlátozás, a közönségszegmentálás és -célzás, az egymást követő hirdetésrotáció, valamint más közönségalapú hirdetésmegjelenítési vezérlők esetében használhatnak többféle eszközön. További információ	ppid= 12JD92J...
ciu_szs	Kísérőhirdetések méreteinek vesszővel elválasztott listája. A kísérőhirdetéseket csak a HTML5 SDK használata esetén támogatja dinamikus hirdetésbeillesztéssel a rendszer.	ciu_szs=728x90,300x250
mpt	A partner lejátszójának nevét jelzi. Ezt többnyire olyan partnerek használják (például JWPlayer, Brightcove és Ooyala), amelyek integrálva vannak az SDK-val.	mpt=JWPlayer
mpv	A partner lejátszójának verzióját jelzi. Ezt csak akkor kell beállítani, ha az mpt paraméter is be van állítva, és az SDK-val integrált partneri lejátszó verziószámát jelzi.	mpv=2.1
ptpl	A hirdetésszünet sablonjának azonosítója. Ezt az azonosítót az Ad Manager URL-jében találja, amikor a hirdetésszünet beállításait nézi az Ad Manager kezelőfelületén. A break_template_id paraméter értékeként jelenik meg.	ptpl=1234
ptpln	A hirdetésszünet sablonjának neve. Ez az Ad Managerben lévő „Név” mezőnek felel meg, nem a megjelenített névnek.	ptpln=my_break_template
an	Az an paraméter az alkalmazás neve. A mobilalkalmazásokból és a csatlakoztatott tévéktől érkező összes kérelemre alkalmazni kell, mivel a legtöbb automatizált videóhirdetés megköveteli.* Az IMA SDK automatikusan kitölti, de a DAI API és a szerveroldali beaconing esetén (nem SDK környezetekben) manuálisan kell megadni. * Míg az alkalmazás nevének ember által olvashatónak kell lennie, iOS és tvOS esetében az SDK nem tud hozzáférni a 9 számjegyből álló App Store-azonosítóhoz. Ilyenkor az SDK az an paraméteren keresztül küldi el az alkalmazáscsomagot (com.package.publisher formátumban).	an=sample%20app
ltd	Azt jelzi, hogy korlátozott módon sor kerüljön-e hirdetések megjelenítésére, amikor a felhasználók nem járulnak hozzá a cookie-k és más helyi azonosítók használatához. További információ	ltd=1
rdid idtype is_lat	Natív alkalmazások esetében (interneten és mobilweben nem) az SDK átadja a felhasználói célzáshoz szükséges visszaállítható eszközazonosítókat a streamelési kérelmeknek a következő paraméterekkel: rdid, idtype és is_lat. SSB-streameknél ezeket explicit paraméterként kell átadni (mint a Videomegoldások ügyféloldali hirdetési kérelmeinél). Az iOS 14.5-ös verziójától kezdve az Apple megszüntette a LAT-jelet. A Google ehelyett a nullától eltérő IDFA meglétére támaszkodik annak jelzésére, hogy a felhasználó beleegyezett a nyomon követésbe olyan iOS-verziók esetén, amelyek támogatják az App Tracking Transparency funkciót. Ekkor érvényes UserAgent jelzi, hogy az operációs rendszer megfelelő verziója szükséges.	Tekintse át a visszaállítható eszközazonosítókat bemutató példákat.
trt	A forgalmat vásároltként vagy más módon jelöli meg.	Nem meghatározott forgalomtípus: trt=0 Vásárolt forgalom: trt=1 Organikus forgalom: trt=2
vconp	Javasolt az MRC videóhirdetések mérésével kapcsolatos irányelvei alapján Azt jelzi, hogy a lejátszó folyamatosan, egymás után játssza-e le a videókat, hasonlóan a televíziós adáshoz. Lehetséges értékek: 2 – a folyamatos lejátszás BE van kapcsolva; 1 – a folyamatos lejátszás KI van kapcsolva. Ezt a paramétert nem kell beállítani, ha ismeretlen.	Folyamatos lejátszás BEKAPCSOLVA: vconp=2   Folyamatos lejátszás KIKAPCSOLVA: vconp=1
vpa	Javasolt az MRC videóhirdetések mérésével kapcsolatos irányelvei alapján Azt jelzi, hogy a hirdetés automatikus lejátszással vagy kattintással kezdődik-e. A lehetséges értékek: click, ha az oldal felhasználói műveletre vár; auto, ha a videó lejátszása automatikusan megtörténik. Ezt a paramétert nem kell beállítani, ha ismeretlen.	Automatikus lejátszás: vpa=auto   Kattintás: vpa=click
vpmute	Javasolt az MRC videóhirdetések mérésével kapcsolatos irányelvei alapján Azt jelzi, hogy a hirdetés lejátszása a videólejátszó elnémított állapotában kezdődik-e meg. Lehetséges értékek: 1 – némított; 0 – nem némított. Ezt a paramétert nem kell beállítani, ha ismeretlen.	Némított: vpmute=1   Nem némított: vpmute=0
npa	A hirdetési kérelmek személyre szabási beállításai. Már a címke elején érdemes meghatározni a paramétert, hogy elkerüljük csonkolás kockázatát. Adja meg az npa=1 függvényt, ha a hirdetési kérelmet nem személyre szabottként szeretné megjelölni. Ha elmulasztja megadni ezt a paramétert, a rendszer alapértelmezés szerint engedélyezi a személyre szabott hirdetéseket.	npa=1
omid_p	Az OMID-partnernév paraméter változó értéket fogad el, amely az OMID-mérést integráló partner nevét, valamint a partnerverziót jelzi. Ez a paraméter csak azokra a megjelenítőkre vonatkozik, akik az Open Measurement SDK (OM SDK) használatakor Aktív megtekintéssel való mérést szeretnének használni. Ezt ne használja az IMA SDK használatakor, mivel automatikusan kerül beállításra. Ha jelezni szeretné az OMID-támogatást az Automatizált Hozzáférési Könyvtár (Programmatic Access Library, PAL) használatakor, a partner nevének és verziójának beállításához az omidPartnerName és az omidPartnerVersion API-t kell használnia. Ha nem PAL vagy IMA szolgáltatást használ, be kell állítania az omid_p és az sdk_apis paramétereket (a támogatott API-k, amelyek más, vesszővel elválasztott API-kat is tartalmazhatnak).	PAL használata esetén: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Ha nem használ PAL-t: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
gdpr gdpr_consent	Ezek a mezők a TCF 2.0-s verziójának beleegyezési információinak átadására szolgálnak mind a bejövő, mind a kimenő cookie-szinkronizálási kérelmekben.	Lásd a GDPR specifikációit.
givn|paln	Az Automatizált Hozzáférési Könyvtárat (Programmatic Access Library, PAL) használó integrációk esetén a videóhirdetési egyszer használatos véletlenszám paraméter változó karakterláncértéket fogad el. Az egyszer használatos véletlenszám URL-ekben problémamentesen használható – nem kell URL-kódolni. Megjegyzés: Ha korábban a régi paln paraméter használatával adott meg egyszer használatos véletlenszámot, akkor erősen javasoljuk, hogy váltson a givn paraméterre, és ne küldje el a paln paramétert. Ne adja meg mindkét paramétert.	A paraméternek átadott értékről a PAL kezdő útmutatóiban talál további információt.
addtl_consent	A Google azon beleegyezéssel rendelkező hirdetéstechnológiai szolgáltatóinak listáját tartalmazza, amelyek nem regisztráltak az IAB-nél.	Lásd a Kiegészítő hozzájárulás specifikációit.
rdp	Az adatfeldolgozás korlátozásához vagy kifejezetten be kell állítania az rdp=1 paramétert, vagy egyszerűen fel kell vennie az rdp paramétert (beállított érték nélkül). Azoknál a hirdetési kérelmeknél nincs korlátozás, amelyek nem tartalmazzák ezt a paramétert, vagy amelyeknél a paraméter beállítása rdp=0 – kivéve, ha a korlátozott adatfeldolgozás hálózati beállítás be van kapcsolva.	rdp=1
sdk_apis	Az SDK API-keretrendszer paraméter a konstans egész számok vesszővel elválasztott listáját fogadja el, amelyek a lejátszó által támogatott API-keretrendszerek mindegyikét jelzik. Tekintse meg az API-keretrendszer lehetséges értékeinek listáját Ezt a paramétert az Automatizált Hozzáférési Könyvtárat (Programmatic Access Library, PAL) használó megjelenítők használják. Ha az IMA SDK használata közben próbál értékeket beállítani ehhez a paraméterhez, akkor az értékeket az IMA SDK által támogatott értékek felülírják.	sdk_apis=2,7,9
sid	Olyan, az adatok védelmére szolgáló hirdetési azonosító, amely csak gyakoriságkorlátozási célból használható. Az IAB IFA irányelvei szerint ezt a paramétert UUID formátumban kell kitölteni. További információ. A sid=0 beállítás megadásával kikapcsolhatja a munkamenet-azonosító továbbítását.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Jelzi, hogy a videólejátszó támogatja-e a „Miért jelent meg ez a hirdetés?” megjelenítését. Ez automatikusan támogatott az IMA SDK használata esetén. Az IMA SDK mellőzése esetén a videólejátszóknak meg kell valósítaniuk a VAST Icon és IconClickFallbackImage címkéinek támogatását a DAI API útmutatóban leírtak szerint.* A szerveroldali beaconing nem támogatja a wta címkét. Az Ad Exchange használata esetén a mező kitöltése kötelező. További információ. * Az IconClickFallbackImage címke támogatása csak CTV-eszközökön kötelező.	Támogatott: wta=1 Nem támogatott: wta=0

Az alapértelmezett hirdetéscímke felülírása az IMA SDK használatával

Amikor a videólejátszó DAI-streamet kér az IMA SDK-n keresztül, akkor az „adTagParameters” nevű mezőben küldi át a rendszer. Ez a szótárszerű szerkezet kulcsértékpárokkal állítható be, ahol a kulcsok az Ad Manager hirdetéscímke-paraméterei lehetnek, amelyeknek felsorolása a fenti táblázatban látható.

Ugyanennek a szerkezetnek a használatával személyre szabhatja a streamet, és olyan paraméterekben küldheti át, amelyek nem kapcsolódnak az Ad Manager hirdetési kérelemhez. További információ arról, hogyan kérhetők konkrét streamváltozatok, valamint hogyan állítható be hirdetésszünet.

Az adTagParameters mező megvalósítása az adott programozási nyelvektől és platformoktól függően kissé eltérő lehet. Lásd az iOS, az Android, a tvOS, a Chromecast és a HTML5 fejlesztői dokumentációját, illetve a DAI lejátszó- és alkalmazásfejlesztési útmutatójában található kiegészítő dokumentációt.

 

Az adTagParameters értékeinek beállítása az SDK-n keresztül

Amikor beállítja a cust_params vagy a description_url értékeit az SDK-n keresztül, az iOS, tvOS vagy Android rendszerre készített alkalmazásaiban, ne URL-kódolja a karakterláncokat. A cust_params átküldhető egyetlen karakterláncként, amelyben összefűzi a kulcsértékpárokat az „&” karakter segítségével.

Ha például a cust_params értékeként a sport=football&city=newyork lehetőséget adta meg:

A kódolatlan értékeket használó adTagParams struktúra a következő lenne:

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

A kódolt értékeket használó adTagParameters struktúra HTML5 streamkérések esetében a következő lenne:

{
  "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"
}
 

A kódolt értékeket használó adTagParams struktúra Roku streamkérések esetében a következő lenne:

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"

Az alapértelmezett hirdetéscímke felülírása a DAI API használatával ^(Béta) 

Amikor a videólejátszó DAI-streamet kér a DAI SDK-n keresztül, akkor igény szerint átadhat olyan kulcsértékpárokat, melyekben a kulcsok a fenti táblázatban felsorolt Ad Manager hirdetéscímke-paraméterek lehetnek.

Ezeket a paramétereket a HTTP POST kérés törzsében, és mind a linear/live, mind a VOD esetében application/x‑www‑form‑urlencoded űrlaptípusként kell elküldeni.

Ugyanennek a szerkezetnek a használatával személyre szabhatja a streamet, és olyan paraméterekben küldheti át, amelyek nem kapcsolódnak az Ad Manager hirdetési kérelemhez. További információ arról, hogyan kérhet adott streamváltozat-paramétereket és HMAC-hitelesítést.

Tekintsen meg egy példát a DAI API megvalósítására.

Az alapértelmezett hirdetéscímke felülírása SSB használatával

A következőkben az SSB alapértelmezett VOD-hirdetéscímkéjének módosítására mutatunk be példákat. A lejátszó vagy alkalmazás által átadott felülírt paraméterek kiemelve jelennek meg.

Igény szerinti videók példái

	Példa
Alap VOD streamelési URL	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8
(megadott hirdetési egységgel)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit
(felülbírált kulcsértékekkel)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2
(gyermekeknek készült tartalom deklarálásával)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfcd=1
(felülbírált hirdetési egységgel ÉS kulcsértékekkel ÉS egyéni description_url paraméterrel ÉS gyermekeknek készült tartalom deklarálásával)	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éldák élő/lineáris közvetítésre

	Példa
Élő/lineáris közvetítés alap-URL-je	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8
(megadott hirdetési egységgel)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit
(felülbírált kulcsértékekkel)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2
(gyermekeknek készült tartalom deklarálásával)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1
(felülbírált hirdetési egységgel ÉS kulcsértékekkel ÉS egyéni description_url paraméterrel ÉS gyermekeknek készült tartalom deklarálásával)	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

A célzási paraméterek dinamikus frissítése az adott élő közvetítés során

A replaceAdTagParameters metódus használatával az IMA DAI SDK-ban frissítheti dinamikusan a célzási adatokat olyan felhasználó esetén, aki épp megtekinti a streamet.

A DAI hibaelhárításával vagy szolgáltatáskimaradásaival kapcsolatos problémák esetén forduljon a megjelenítői ügyfélszolgálathoz.