VAST hirdetési címke URL-paraméterei

_(Környezet)

Videóba ágyazott kérést jelez, vagy azt, hogy a kérés kifejezetten videólejátszótól származik.

A lehetséges értékek a következők: instream (videó- és hangos hirdetésekhez használható) vagy vp (kizárólag videóhirdetésekhez használható).

Példa:

Videó- és/vagy hangos hirdetés:
env=instream

Csak videóhirdetés:
env=vp

Kötelező

_{(Ad Manager sémájának jelzése)}

Azt jelzi, hogy a felhasználó az Ad Manager-sémát használja.

Példa:

gdfp_req=1

Kötelező

_{(Késleltetett megjelenítések)}

Ha 1-es értékre állítja, bekapcsolja a késleltetett megjelenítéseket a videónál.

Példa:

unviewed_position_start=1

Kötelező

_{(A hirdetés kimeneti formátuma)}

A hirdetés kimeneti formátuma.

Használja az output=vast értéket a hálózatán aktivált VAST-verzióhoz (pl. VAST 4). Adott hirdetési címkékhez vagy a webhely egyes részeihez kifejezetten igényelheti a VAST 3 verziót az output=xml_vast3, illetve a VMAP 1 verziót az output=xml_vmap1 paraméterrel.

A VAST esetén, ha a videólejátszó az IMA SDK-t használja, akkor a videóhirdetési kérelem output paramétere mindig a következőre lesz állítva: output=xml_vast4. Ez nem jelent kockázatot a megbízhatóságra nézve, mivel az SDK visszamenőlegesen kompatibilis az összes VAST-verzióval, amelyet a külső hirdetésmegjelenítők használhatnak.

A hálózatnál aktivált alapértelmezett VMAP-verzió (pl. VMAP 1) elküldéséhez használja az output=vmap értéket. VAST VMAP-en belüli visszaküldése esetén használhatja az xml_vmap1_vast3 vagy az xml_vmap1_vast4 értéket annak meghatározásához, hogy melyik VAST-verzió legyen visszaküldve.

Példa:

vast (a hálózat alapértelmezett VAST-beállításához)
xml_vast3 (VAST 3 esetén)
xml_vast4 (VAST 4 esetén)

vmap (a hálózat alapértelmezett VMAP-beállításához)
output=xml_vmap1 (VMAP1 esetén)
xml_vmap1_vast3 (VMAP1 esetén, VAST3 visszaküldésével)
xml_vmap1_vast4 (VMAP1 esetén, VAST4 visszaküldésével)

Kötelező

_{(Hirdetési egység)}

A jelenlegi hirdetési egység.

A formátuma a következő:
/network_id/.../ad_unit

Példa:

iu=/6062/videodemo

Kötelező

_(Méret)

A fő videó hirdetéshelyének mérete. Több méret megadása esetén használja a függőleges vonal (|) karaktert.

A méret után ne használja a „v” paramétert.

Példa:

sz=400x300

Kötelező
(Opcionális csak az „ad_type=audio” kérése esetén)

description_url

_{(Leíró 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 weboldalakon lévő videólejátszók esetében mindig URL-kódolnia kell a description_url értéket.

Az Ad Exchange használata esetén a mező kitöltése kötelező. További információ Ad Exchange-videócímke létrehozásáról.

^{* Ezt a paramétert az IMA SDK nem állítja be automatikusan CTV-kre. Manuálisan kell beállítani.}

Példa:

Kódolt URL:
description_url=https%3A%2F%2Fwww.sample.com%2Fgolf.html

Nem kódolt URL:
description_url=https://www.sample.com/golf.html

Kötelező

_(URL)

Az a teljes URL, amelyről a hirdetési kérelem érkezik. Weboldal esetében ez annak az oldalnak az URL-címe, amely megjeleníti a videólejátszót, alkalmazás esetében pedig a csomagnév.*

Ha az IMA SDK-t használja, az SDK automatikusan beállítja az URL értékét. Ha a lejátszó állítja be ezt az értéket, az IMA SDK felülírja a saját értékével.

^{* Ezt a paramétert az IMA SDK nem állítja be automatikusan CTV-kre. Manuálisan kell beállítani.}

Példa:

url=https://www.videoad.com/golf.html

Kötelező

_{(korrelátor)}

Véletlenszerűen generált pozitív szám, amely megoszlik az azonos oldalmegtekintésektől származó kérések között.

A correlator a versenytársak kizárásának megvalósítására szolgál, például cookie nélküli környezetben.

Ha az IMA SDK-t használja, az SDK automatikusan beállítja a korrelátor értékét. Ha a lejátszó megpróbálja beállítani ezt az értéket, az IMA SDK felülírja a saját véletlenszerűen generált értékével.

Ha nem az IMA SDK-t használja, ügyeljen arra, hogy ezt az értéket valóban olyan, véletlenszerűen generált értékre állítsa, amelyet nem használ más oldalmegtekintés.

Példa:

correlator=4345645667

Kötelező

_{(Hanganyag folyamatos lejátszása)}

Javasolt az MRC audiotartalmak mérésével kapcsolatos irányelvei alapján

Azt jelzi, hogy a lejátszó folyamatosan játssza-e le az audiotartalmakat.

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.

Példa:

Folyamatos lejátszás BEKAPCSOLVA:
aconp=2

Folyamatos lejátszás KIKAPCSOLVA:
aconp=1

Nem kötelező

_{(Hirdetési szabály)}

Azt jelzi, hogy VAST-kreatívot vagy hirdetésszabály-választ kell-e visszaküldeni. Ha hirdetési szabályokat használ, az ad_rule=1 beállítást kell megadni. Más kérések esetében az ad_rule=0 beállítást használja (vagy egyszerűen hagyja el a paramétert).

További információ a hirdetési szabályokról.

Példa:

Az ad_rule=0 beállítás kreatív (VAST) kérését jelzi.

Az ad_rule=1 beállítás hirdetési szabály (VMAP) kérését jelzi.

Nem kötelező

_{(Hirdetés típusa)}

A hirdetés típusát jelzi, amelyet vissza kell küldeni a kérelemre.*

A lehetséges értékek a következők: audio (csak hangos hirdetést küld vissza), videó (csak videóhirdetést küld vissza), illetve audio_video (a kettő közül az egyiket küldi vissza).

* Ez a paraméter jelenleg nem szükséges csak videóhirdetés visszaadásához.

Példa:

Hangos hirdetés visszaküldése:
ad_type=audio

Hangos vagy videóhirdetés visszaküldése:
ad_type=audio_video

Át kell adni a hangos hirdetésekhez.

_{(Kísérőhirdetések méretei)}

Kísérőhirdetések méreteinek vesszővel elválasztott listája.

A függőleges vonallal (|) elválasztott értékek többméretes hirdetési helyet jelölnek.

Példa:

ciu_szs=728x90,300x250

Méretek többméretes hirdetési hellyel:
ciu_szs=728x90,300x200|300x250

Nem kötelező

cmsid
vid

_{(Tartalomforrás-azonosító, videóazonosító)}

Hirdetések videótartalomra történő célzásához a fő videocímkének a cmsid és a vid paramétert is tartalmaznia kell.

A cmsid az egyes tartalomforrások egyedi száma. Úgy találhatja meg az Ad Managerben, hogy rákattint a Videó  Tartalomforrások lehetőségre, majd a tartalomforrás nevére.

A vid olyan karakterlánc vagy szám, amely egy adott videótartalmat azonosít. Ezt az azonosítót a tartalmat tároló CMS rendeli hozzá a videóhoz. Úgy találhatja meg az Ad Managerben, hogy rákattint a Videó  Tartalom lehetőségre, majd a listában szereplő adott tartalomra.

Példa:

cmsid=[value]&vid=[value]

Ha igény szerinti videóval készít címkét a Dinamikus hirdetésbeillesztés funkcióhoz, akkor olyan makrókat használjon, amelyek dinamikusan beszúrják a helyes cmsid és vid értékeket.

Példa:

cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Nem kötelező

_{(Egyéni kulcsérték-paraméterek)}

Tekintsen meg példákat a kulcsértékpárok hozzáadásáráról.

Nem kötelező

_(Nyelv)

Nyelvi kód, amellyel adott nyelvű hirdetések kérhetők.

Rendszerünk ezt a paramétert a hirdetés, illetve a dinamikus elosztás alatt történő videóhirdetés-megjelenítés nyelvének kiválasztásához használja fel az Ad Exchange és az AdSense Videóhoz szolgáltatásban.

A nyelvet bármelyik ISO 639-1 (kétbetűs) vagy ISO 639-2 (hárombetűs) kóddal jelölheti. Tekintse át az érvényes kódok listáját.

Ha elhagyja, az alapértelmezett beállítás bármelyik nyelv lehet az Ad Exchange szolgáltatásban való nyelv szerinti hirdetéscélzás alapján.

Példa:

hl=it

Nem kötelező

_{(Alkalmazás azonosítója és neve)}

Az msid paraméter az alkalmazás azonosítója, az an pedig az alkalmazás neve.

Mindkét paramétert alkalmazni kell a mobilalkalmazásokból és a csatlakoztatott tévéktől érkező összes kérelemre, mivel a legtöbb automatizált videóhirdetés megköveteli őket.*

Az IMA SDK automatikusan kitölti mindkét paramétert, de a közvetlen VAST-hívásokban (nem SDK környezetekben) manuálisan kell megadni őket.

_{* 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. Ilyen esetekben nem küldi el a rendszer az msid paramétert, és az SDK az an paraméteren keresztül küldi el az alkalmazáscsomagot (com.package.publisher formátumban).}

Példa:

msid=com.package.publisher an=sample%20app

Nem kötelező

_{(Tartalék letiltva)}

Azt jelzi, hogy a hirdetési kérelemnek nem szabad „tartalék videóhirdetéseket” tartalmazó lejátszási listát visszaküldenie.

További információ a tartalék videóhirdetésekről.

Példa:

nofb=1

Nem kötelező

_{(Videó- és audiokreatív profilja)}

Azt szabályozza a videó- és audiokreatív profiljának konfigurációja alapján, hogy mely kreatívok jogosultak a megjelenésre.

További információ a kreatívprofilokról.

Példa:

pp=creative_profile

Nem kötelező

_{(Megjelenítő által biztosított azonosító)}

A megjelenítő által biztosított azonosító (publisher provided identifier, 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ó a PPID-kről.

Példa:

ppid=12JD92JD8078S8J29SDOAKC0EF230337

Nem kötelező

_{(Visszaállítható eszközazonosítók)}

Beépített 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). További információ az eszközazonosítókról.

Szinte az összes automatizált videóhirdetés megköveteli az értékek meglétét.

Tekintse át a visszaállítható eszközazonosítókat bemutató példákat.

Nem kötelező

_{(Az adatfeldolgozás korlátozása)}

Olyan címkével látja el a hirdetési kérelmet,
amely korlátozza az adatfeldolgozást.

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.

Példa:

rdp=1

Nem kötelező

_{(Gyermekközpontú bánásmód)}

Gyermekközpontú bánásmód címkével látja el a hirdetési kérelmet. 

További információ a tfcd paraméterről.

Példa:

tfcd=1

Nem kötelező

_{(Nem személyre szabott hirdetés)}

A hirdetési kérelmet nem személyre szabottként jelöli meg.

Ha nem személyre szabottként szeretné megjelölni a kérelmet, akkor vagy kifejezetten be kell állítania az npa=1 paramétert, vagy egyszerűen fel kell vennie az npa paramétert (beállított érték nélkül). Ha a hirdetési kérelmeknél hiányzik ez a paraméter, vagy ha a beállítása npa=0, akkor alapértelmezés szerint személyre szabott hirdetéseket használ a rendszer.

További információ a hirdetések személyre szabásáról.

Példa:

npa=1

Nem kötelező

_{(Videók folyamatos lejátszása)}

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.

Példa:

Folyamatos lejátszás BEKAPCSOLVA:
vconp=2

Folyamatos lejátszás KIKAPCSOLVA:
vconp=1

Nem kötelező

_{(Videó automatikus lejátszása)}

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.

Példa:

Automatikus lejátszás:
vpa=auto

Kattintásra lejátszott:
vpa=click

Nem kötelező

_{(Video playlist inred)}

Azt jelzi, hogy sor kerüljön-e soron belüli VMAP megjelenítésére (VAST visszaküldése VMAP-en belül).

Ez használható a várakozási idő csökkentésére, valamint a gyakoriságkorlátok és a versenytárskizárások garantálására a videóstreamben.

A lehetséges értékek: 1 VAST visszaküldéséhez, illetve 0 (vagy a beállítás kihagyása) átirányítási címkék visszaküldéséhez.

Példa:

VAST visszaküldése:
vpi=1

Átirányítások visszaküldése:
vpi=0

Nem kötelező

_{(A videó lejátszása némítva)}

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.

Példa:

Némított:
vpmute=1

Nem némított:
vpmute=0

Nem kötelező

afvsz

_{(Nem lineáris hirdetési méretek)}

Azon nem lineáris hirdetési méretek vesszővel elválasztott listája, amelyek megjeleníthetők a videóhirdetési helyen.

Ezeknek a következő támogatott méretek egyikének kell lenniük:

• 200x200
• 250x250
• 300x250
• 336x280
• 450x50
• 468x60
• 480x90
• 729x90

Az IMA SDK használata esetén a rendszer felülírja ezt a mezőt, és minden olyan támogatott mérettel kitölti, amely belefér a következőkbe: nonLinearAdSlotWidth és nonLinearAdSlotHeight.

Példa:

Minden méret támogatott:
afvsz=200x200,250x250,
300x250,336x280,
450x50,468x60,
480x90,728x90

A maximális szélesség 250:
afvsz=200x200,250x250

A maximális magasság 60:
afvsz=450x50,468x60

A maximális szélesség 100:
//üres; nincsenek támogatott értékek

A paraméter elhagyható, vagy üres is lehet, ha a nem lineáris méretek támogatottak.

pod

_{(Sorba rendezés száma)}

A videón belüli sorba rendezést jelzi. A következőket adja át: pod=1 az első sorba rendezés esetén, pod=2 a második sorba rendezés esetén és így tovább. Versenytársak kizárásához, gyakoriságkorlátozáshoz és kapcsolódó funkciókhoz használatos.

Példa:

pod=3

A versenytársak kizárása, a gyakoriságkorlátozás és az ezekhez kapcsolódó funkciók helyes működéséhez át kell adni.

ppos

_{(Pozíció a sorban)}

Egy sorba rendezésen belüli pozíciót jelöl. A kísérőhirdetés automatikus kitöltéséhez szükséges. A következőket adja át: &ppos=1 az első pozíció esetén, &ppos=2 a második pozíció esetén és így tovább. Versenytársak kizárásához, gyakoriságkorlátozáshoz és kapcsolódó funkciókhoz használatos.

Ez a paraméter csak normál sorba rendezésekhez használható.

Példa:

ppos=2

A versenytársak kizárása, a gyakoriságkorlátozás és az ezekhez kapcsolódó funkciók helyes működéséhez át kell adni.

vpos

_{(Tartalom előtti, közbeni vagy utáni hirdetés)}

Azt jelzi, hogy a hirdetési kérelmet tartalom előtti, közbeni vagy utáni hirdetésből küldték.

Példa:

vpos=preroll
vpos=midroll
vpos=postroll

Nem kötelező

mridx

_{(Tartalom közbeni hirdetés száma)}

Számalapú index, amely jelzi, hogy melyik tartalom közbeni hirdetésből (1., 2., 3. stb.) érkezett a kérés.

Példa:

mridx=2

Nem kötelező

lip

_{(A normál sorba rendezés utolsó pozíciója)}

A sorba rendezés utolsó pozíciójában szereplő kérés esetén kell hozzáadni.

Ez a paraméter csak normál sorba rendezésekhez használható.

Példa:

lip=true

Normál sorba rendezések esetén kötelező

min_ad_duration
max_ad_duration

_{(A hirdetés időtartama)}

Együttesen meghatározzák, hogy a hirdetés időtartamának milyen tartományba kell esnie (ezredmásodpercben).

Egyetlen hirdetés kérelmezésére szolgál.

Példa:

min_ad_duration=15000&max_ad_duration=30000

Nem kötelező

pmnd
pmxd

_{(A sorba rendezés időtartama)}

Együttesen meghatározzák, hogy a sorba rendezés időtartamának milyen tartományba kell esnie (ezredmásodpercben).

Több hirdetés kérésére szolgál (azaz sorba rendezések esetén használatos).

Ezek a paraméterek kifejezetten az optimalizált sorba rendezésekre vonatkoznak, amelyek bővített videócsomaggal állnak a megjelenítők rendelkezésére. VMAP esetén sem használhatók (ha ad_rule=1).

Példa:

pmnd=0&pmxd=60000

Optimalizált sorba rendezések esetén kötelező

pmad

_{(Sorba rendezés hirdetéseinek maximális száma)}

A sorba rendezésben szereplő hirdetések maximális száma.

Ez a paraméter kifejezetten az optimalizált sorba rendezésekre vonatkozik, amelyek bővített videócsomaggal állnak a megjelenítők rendelkezésére. VMAP esetén sem használhatók (ha ad_rule=1).

Példa:

pmad=4

Nem kötelező

excl_cat

_{(Kizárási kategória)}

Letilt minden olyan sort, amely tartalmazza a szóban forgó kizárási címkét, azaz ezek nem használhatók fel egy adott hirdetési kérelemnél; a cust_params címkével is működik.

Példa:

&custom_params=excl_cat
%3Dairline_excl_label%7C

Nem kötelező

ltd

_{(Korlátozott hirdetések)}

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

Példa:

ltd=1

Nem kötelező

scor

_{(A videóstreamek egyedi száma)}

Az egyes videóstreamekhez létrehozott egész szám. A számnak az adott streamen belül ugyanannak és oldalmegjelenítésenként egyedinek kell lennie. Versenytársak kizárásához, gyakoriságkorlátozáshoz és kapcsolódó funkciókhoz használatos, ha egy felhasználó több videót néz ugyanazon az oldalon.

Példa:

scor=17

A versenytársak kizárása, a gyakoriságkorlátozás és az ezekhez kapcsolódó funkciók helyes működéséhez át kell adni.

sid

_{(Munkamenet-azonosító)}

Olyan adatvédelmi szempontból biztonságos 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.

Példa:

123e4567-e89b-12d3-a456-426614174000

A versenytársak kizárása, a gyakoriságkorlátozás és az ezekhez kapcsolódó funkciók CTV/OTT platformokon való működéshez át kell adni, ha a PPID vagy más felhasználói azonosítók (rendszerint RDID a CTV/OTT platformokon) nem szerepelnek a kérésben, vagy ha a „Hirdetéskövetés korlátozása” (Limit Ad Tracking, LAT) funkció engedélyezve van az adott felhasználó számára (is_lat=1).

vad_type

_{(Lineáris vagy nem lineáris hirdetés)}

Jelzi, hogy lineáris vagy nemlineáris hirdetést kell visszaadni a kérésre.

Példa:

vad_type=linear
vad_type=nonlinear

Nem kötelező

wta

_{(Miért jelent meg ez a hirdetés?)}

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ámogott 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 támogatását az IAB VAST-szabványában rögzített módon.

Az Ad Exchange használata esetén a mező kitöltése kötelező. További információ a videó- vagy játékcímkékről.

A hangos hirdetésekre vonatkozó kérelmeknek wta=0 paramétert kell küldeniük a nyílt aukció számára, és/vagy abban az esetben, ha nincs kísérőhely. A wta paraméter kihagyható, vagy 1 értékre állítható, ha meg van adva kísérőhely, és minden célcsoport szerinti célzással rendelkező hirdetési kampány biztosít „Miért jelent meg ez a hirdetés?”-nyilatkozattal rendelkező kísérőkreatívot.

Példa:

Támogatott:
1

Nem támogatott:
0

Az Ad Exchange használata esetén pontosan be kell állítani.