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

A VAST hirdetési címke URL-jét a lejátszó videó- és audiohirdetések lekérésére használja. Összeállíthatja manuálisan a VAST hirdetési címke URL-jét, vagy módosíthat meglévő URL-t az alábbi paraméterekkel, majd tesztelheti a VAST Suite Inspector segítségével. Az áttekintést és a tesztelést ezeknek a mintacímkéknek a használatával is végrehajthatja.

Általános URL-követelmények

  • Protokoll: A VAST hirdetési címkék a HTTP-t és a HTTPS-t is támogatják. A megjelenítéskövetési URL-ek figyelembe veszik az aktuális SSL-beállítást, és HTTP-t vagy HTTPS-t használnak. Az átkattintás és a kattintáskövetés HTTP-t használ, mivel átirányítás történik egy másik oldalról.
  • Domain: A mintaillesztő makróval vagy bármely más dinamikus módszerrel létrehozott dinamikus domainek használata nem engedélyezett, és hibát okoz.
  • Élő forgalom: Az élőben közvetített videókban használt hirdetési címkék URL-jeihez tartozó elérési útnak tartalmaznia kell a /live karakterláncot, hogy a címkék biztosan kezelni tudják a nagy forgalmat, ugyanis a közvetítés során mindenkinél ugyanakkor lesz hirdetésszünet.

Példa VAST hirdetési címkére

Egy paraméterekkel és hozzárendelt értékekkel rendelkező VAST hirdetési címke URL-je valahogy így néz ki:

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

 könyvjelzőUgrás adott paraméterre a listában

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

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

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

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

Paraméter Részletek
aconp

(Audiotartalmak folyamatos lejátszása)

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

Az audiotartalmak folyamatos lejátszása paraméter konstans értéket fogad el, és azt jelzi, hogy a lejátszó folyamatosan játssza-e le az audiotartalmakat.

Ha ismeretlen, akkor nem kell beállítani a paramétert.

Gyakorlati példa

Folyamatos lejátszás BEKAPCSOLVA:
aconp=2

Folyamatos lejátszás KIKAPCSOLVA:
aconp=1

ad_rule

(Hirdetési szabály)

A hirdetési szabály paraméter konstans értéket fogad el, és azt jelzi, hogy VAST-kreatív vagy hirdetési szabályra adott válasz legyen-e visszaküldve.

A hirdetési szabályok alapértelmezett beállítása az Ad Manager hálózati beállításaitól függ. Az alábbi példák segítségével felülbírálhatja bizonyos hirdetési címkék beállításait.

Gyakorlati példa

VAST-kreatívra vonatkozó kérelem
ad_rule=0

Hirdetési szabályokra vonatkozó kérelem (VMAP):
ad_rule=1

Követelmény

Kötelező Videóhirdetési szabályoknál szükséges

ad_type

(Hirdetés típusa)

Az ad type (hirdetéstípus) paraméterek konstans értéket fogadnak el, és azt jelzik, hogy milyen hirdetéstípusokat kell megjeleníteni a kérelemhez.

Ez a paraméter csak audiohirdetéseknél szükséges.

Amikor az ad_type értéke audio vagy audio_video, a vpmute paramétert a következőre kell állítani: 0.

Példák a használatra

Csak audiohirdetéseket engedélyez:
ad_type=audio

Átugorható és nem átugorható videóhirdetéseket is engedélyez:
ad_type=video

Az audio- és videóhirdetéseket is engedélyezi:
ad_type=audio_video
(Ez az érték mindkét formátum versengését engedélyezi, de csak az egyik jelenik meg.)

Az audio_video hirdetéstípus csak videókreatívok olyan audiotartalmakban való megjelenítéséhez használható, amelyek támogatják a videóhirdetések lejátszását, illetve audiokreatívok videóba ágyazott videólejátszókban való megjelenítéséhez olyan tartalmaknál, melyek „meghallgathatóak”. Például sportközvetítések, videóközvetítések, hírek stb. További információ a videótartalmakban megjelenő hanganyagról.

Csak az átugorható videóhirdetéseket engedélyezi:
ad_type=skippablevideo

Csak nem átugorható videóhirdetéseket engedélyez:
ad_type=standardvideo

Követelmény

Kötelező Audiohirdetéseknél szükséges

afvsz

(Nem lineáris hirdetési méretek)

A nem lineáris hirdetési méretek paraméter konstans értékeket fogad el azoknak a nem lineáris hirdetési méreteknek a vesszővel elválasztott listájaként, 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.

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

Gyakorlati 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

 

Követelmény

Kötelező Nem lineáris videóhirdetésekhez szükséges, ha nem használ IMA SDK-t

allcues

(Minden jelzőpont)

Ez a paraméter elfogad ezredmásodpercben megadott jelzőpontok alkotta, vesszővel tagolt listaként közölt változó értékeket. Az Ad Manager minden értékre egy hirdetésszünetet küld vissza.

A vid_d és az allcues paraméterek használatával tartalom közbeni hirdetések jeleníthetők meg tartalomfeldolgozás nélkül. A hirdetési szabályoknak szintén meg kell jeleníteniük a tartalom közbeni hirdetéseket.

Ha időalapú jelzőket használ a hirdetési szabályokban (például „Minden N-edik másodpercben” vagy „Meghatározott időpontokban”), akkor a hirdetési szabályokba foglalt jelzők lesznek használatban, és az allcues jelzői figyelmen kívül maradnak. A tartalom közbeni hirdetéshez szükséges az időtartam, ezért a vid_d paraméter átadásának még így is meg kell történnie.

Gyakorlati példa

Jelzőpontok 10 és 20 másodpercnél:
allcues=10000,20000

ciu_szs

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

A kísérőhirdetések méretei paraméter változó értéket fogad el, amely a kísérőhirdetés-méretek vesszővel elválasztott listája.

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

Gyakorlati példa

ciu_szs=728x90,300x250

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

cmsid

(Tartalomforrás azonosítója)

vid

(Videózonosító)

A tartalomforrás-azonosító és a videóazonosító paraméterek változó értékeket fogadnak el.

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

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

A vid olyan karakterlánc vagy szám, amely egy adott videót 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ó majd Tartalom lehetőségre, majd az adott videótartalomra.

Gyakorlati 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 használjon olyan makrókat, amelyek dinamikusan beszúrják a helyes tartalomforrást és videóazonosítót.

Például: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Követelmény

Kötelező Videótartalmak célzásánál szükséges

correlator

(Korrelátor)

A korrelátor paraméter változó értéket fogad el, amelyet közösen használnak az azonos oldalmegtekintésektől származó kérések. 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 SDK felülírja a saját é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, pozitív, egész szám értékre állítsa, amelyet nem használ más oldalmegtekintés.

Gyakorlati példa

correlator=4345645667

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

javasolt Automatizált bevételszerzéshez ajánlott

cust_params

(Egyéni kulcsérték-paraméterek)

Az egyéni paraméterek paraméter változó értékeket fogad el, amelyek kulcsértékpárok, és lehetővé teszik a célzás specifikus beállítását például demográfiai adatok szerint, egy adott oldal meghatározott helyére irányulóan, illetve adott oldalon vagy oldalakon.

Gyakorlati példa

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

description_url

(Leíró URL)

A leíró URL paraméter változó értéket fogad el, amely leírást ad az oldalon lejátszott videóról. Ez általában az az oldal, amelyen a videólejátszó is megtalálható, de lehet olyan oldal is, amelyen csak a videót bemutató szöveg van.

A description_url értékénél kódolt URL-t kell alkalmazni a weboldalak videólejátszóihoz és CTV/OTT-eszközökhöz, illetve nem kódolt URL-t a mobilalkalmazáson belüli videólejátszókhoz.

Ezt a paramétert az IMA SDK nem állítja be automatikusan. Manuálisan kell beállítani.

Gyakorlati 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övetelmény

Kötelező Weben, alkalmazásoknál és az Ad Exchange-nél szükséges

javasolt Automatizált bevételszerzéshez ajánlott

env

(Környezet)

A környezet paraméter konstans értéket fogad el, amely videóba ágyazott kérelmet 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 audiohirdetésekhez használható) vagy vp (kizárólag videóhirdetésekhez használható).

Gyakorlati példa

Videó- és/vagy audiohirdetés:
env=instream

Csak videóhirdetés:
env=vp

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

excl_cat

(Kizárási kategória)

A kizárási kategória paraméter változó értékeket fogad el, és megakadályozza, hogy használhatók legyenek az adott hirdetési kérelemnél azok a sorok, amelyek tartalmazzák a kérdéses kizárási címkét. Ez a paraméter használható a következővel: cust_params.

Gyakorlati példa

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

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

Az Ad Manager sémájának jelzése paraméter konstans értéket fogad el, és azt jelzi, hogy a felhasználó az Ad Manager-sémát használja.

Gyakorlati példa

gdfp_req=1

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

gdpr

(GDPR)

A GDPR paraméter állandó értékeket fogad el, és azok a megjelenítők használják, akik integrációt szeretnének végezni az IAB TCF 2.0-s verziójával. A közvetlen VAST-kérések nem olvassák be automatikusan az értékeket, de a hirdetési címkékhez való hozzáadáskor elfogadják őket.

Csak a 0 és az 1 érvényes értékek ennél a paraméternél, ahol a 0 azt jelenti, hogy a GDPR nincs, az 1 pedig azt jelenti, hogy a GDPR érvényben van. Ha a GDPR érvényben van, meg kell adnia egy érvényes TC-karakterláncot is a gdpr_consent paraméter használatával.

A paraméternek átadott értékekről a keretrendszer megvalósítására vonatkozó általános útmutatóban vagy az IAB TCF v2.0 specifikációjának TC-karakterláncában található további információ.

Gyakorlati példa

A GDPR érvényben van:
gdpr=1

A GDPR nincs érvényben:
gdpr=0

hl

(Nyelv)

A nyelv paraméter konstans értéket fogad el, és adott nyelvű hirdetések kérelmezésére, valamint a hirdetéskiválasztás, illetve a dinamikus elosztás alatt történő videóhirdetés-megjelenítés nyelvének meghatározására használható Ad Exchange- és AdSense-videók esetén.

A paraméterértéket 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 érték alapértelmezés szerint bármelyik nyelv lehet az Ad Exchange szolgáltatásban való nyelv szerinti hirdetéscélzás alapján.

Gyakorlati példa

hl=it

Követelmény

javasolt Automatizált bevételszerzéshez ajánlott

iabexcl

(IAB-kizárási URL)

Az iabexcl URL-paraméter a kategóriák vesszővel tagolt listáját fogadja el.

Gyakorlati példa

Az iabexcl=3,14,527  nem tartalmazza a „Haszonjárművek”, a „Terepjárók” és a „Rögbi” kategóriákat.

További információ az IAB tartalomtaxonómiájáról.

ipd

(Készletpartner domainje)

Az inventorypartnerdomain paraméter változó értékekeket fogad el, amelyeket az inventorypartnerdomain deklarációira kell beállítani a megjelenítő app-ads.txt (vagy ads.txt) fájljában.

Az inventorypartnerdomain paraméter egy IAB-specifikáció, amely segít a megjelenítőknek kijelölni egy készletmegosztási partner domainjét az ads.txt/app-ads.txt érvényesítése céljából.

Az IPD-deklaráció különösen fontos azokban a készletmegosztási használati esetekben, amikor az a hirdetési készlet, amelyből a kérelem származik, egy másik partner (a készletmegosztási partner) tulajdonában lehet.

További információ az ads.txt/app-ads.txt fájlról és a készletmegosztási partnerekről.

ipe

(Megjelenítést pingelő entitás)

A megjelenítést pingelő entitás paramétere olyan konstans értéket fogad el, amely a nem az ügyféltől, hanem a szerverről származó megjelenítési pingelések és konverziók jelölésére szolgál.

Gyakorlati példa

Szerveroldali beaconing (server-side beaconing, SSB):
ipe=ssb

iu

(Hirdetési egység)

A hirdetési egység paraméter változó értéket fogad el, és az aktuális hirdetési egységre kell állítani a következő formátumban:

/network_id/.../ad_unit

Gyakorlati példa

iu=/6062/videodemo

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

lip

(Utolsó pozíció a podban)

A sorba rendezés utolsó pozíciója paraméter konstans értéket fogad el, és a sorba rendezés utolsó pozíciójában szereplő kérelmet jelzi.

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

Gyakorlati példa

lip=true

ltd

(Korlátozott hirdetések)

A korlátozott hirdetések paraméter konstans értéket fogad el, és azt jelzi, hogy korlátozott módon jelenjenek-e meg a hirdetések, amikor a felhasználók nem járultak hozzá a cookie-k és más helyi azonosítók használatához.

Figyelmeztetés

Más URL-paraméterekkel ellentétben az ltd=1 érték beállítása módosítja az IMA SDK viselkedését, hogy azonosító nélküliként kezelje a kérelmet és letiltsa a tárolást.

Gyakorlati példa

ltd=1

min_ad_duration

(Hirdetés minimális időtartama)

max_ad_duration

(Hirdetés maximális időtartama)

A hirdetés időtartama paraméterek változó értékeket fogadnak el, amelyek együttesen meghatározzák, hogy a hirdetés időtartamának milyen tartományba kell esnie (ezredmásodpercben).

Ezzel a paraméterrel korlátozhatja az egyes hirdetések időtartamát egyetlen hirdetésre és optimalizált podkérelmekre vonatkozóan.

Gyakorlati példa

min_ad_duration=15000&max_ad_duration=30000

mridx

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

A tartalom közbeni hirdetés száma paraméter változó értéket fogad el, és a videón belül a tartalom közbeni hirdetés sorszámát jelzi (pl. 1. tartalom közbeni hirdetés, 2. tartalom közbeni hirdetés stb.)

Gyakorlati példa

mridx=2

msid

(Alkalmazásazonosító)

an

(Alkalmazásnév)

Az alkalmazás azonosítója és neve paraméterek változó értékeket fogadnak el, és mindkettőt 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 manuálisan kell megadni őket az SDK-n kívüli környezetekben, beleértve a közvetlen VAST-hívásokat is, illetve az Automatizált hozzáférési könyvtár (Programmatic Access Library, PAL) vagy a Megjelenítő által hitelesített készlet (Publisher Authenticated Inventory, PAI) használata esetén.

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 az alkalmazásazonosí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.

Gyakorlati példa

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

Az alkalmazásazonosítók alkalmazásboltonként eltérő elnevezéssel és formázással rendelkeznek. Tekintse meg az IAB alkalmazásazonosítókra vonatkozó irányelveit, vagy a gyakori egyedi azonosítók példáit.

Azoknál a platformoknál, ahol nem található alkalmazásbolt, az IAB a következő formátumú alkalmazásbolti azonosítók használatát javasolja a megjelenítőknek: com.publisher.deviceplatform

Követelmény

Kötelező Mindkét paraméter megadása kötelező az alkalmazások esetén.

javasolt Automatizált bevételszerzéshez ajánlott

nofb

(Tartalék letiltva)

A tartalék letiltva paraméter konstans értéket fogad el, és azt jelzi, hogy a hirdetési kérelemne küldje vissza a tartalék videóhirdetések lejátszási listáját.

Gyakorlati példa

Tartalékhirdetés letiltva:
nofb=1

npa

(Nem személyre szabott hirdetés)

A nem személyre szabott hirdetések paraméter konstans értéket fogad el, és azt jelzi, hogy a hirdetési kérelmet nem személyre szabottként kell kezelni.

Ha nem személyre szabottként szeretné megjelölni a kérelmet, 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.

Gyakorlati példa

Nem személyre szabott hirdetések:
npa=1

omid_p

(OMID-partner neve)

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

Gyakorlati példa

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

output

(A hirdetés kimeneti formátuma)

A hirdetés kimeneti formátuma paraméter konstans értéket fogad el, amelyet a hirdetés kimeneti formátumára kell álíltani.

Használja az output=vast értéket a hálózatán beállított VAST-verzióhoz. Adott hirdetési címkék vagy a webhely egyes részei esetében kérhet specifikus VAST- vagy VMAP-verziókat.

VAST esetén, ha a videólejátszó az IMA SDK-t használja, akkor a videóhirdetési kérelem kimeneti 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.

Gyakorlati példa

Hálózata alapértelmezett VAST-beállítása:
output=vast

VAST 4:
output=xml_vast4

Hálózata alapértelmezett VMAP-beállítása:
output=vmap

VMAP 1:
output=xml_vmap1

VMAP 1, VAST 4 visszaküldésével:
output=xml_vmap1_vast4

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

plcmt

(Elhelyezés)

Az elhelyezési paraméter olyan konstans értéket fogad el, amely annak jelzésére szolgál, hogy a videóba ágyazott készlet videóba ágyazottként vagy kísérőként van-e deklarálva az IAB-specifikációkban található útmutatás szerint.

A nem videóba ágyazott kérelmek esetében ezt a mezőt a rendszer automatikusan kitölti a vevők számára a deklarált készletformátum alapján, és felülbírálja a videóba ágyazott vagy kísérő tartalmakra vonatkozó összes deklarációt.

Gyakorlati példa

Videóba ágyazott kérelem:
plcmt=1

Kísérő tartalomra vonatkozó kérelem:
plcmt=2

Követelmény

Kötelező Webes és Automatizált bevételszerzés esetén szükséges

pmad

(Hirdetések maximális száma a podban)

A sorba rendezés hirdetéseinek maximális száma paraméter változó értéket fogad el, és a sorba rendezésben lévő hirdetések maximális számát jelzi.

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 nem használható (ha ad_rule=1).

Gyakorlati példa

pmad=4

pmnd

(Pod minimális időtartama)

pmxd

(Pod maximális időtartama)

A sorba rendezés időtartama paraméterek változó értékeket fogadnak el, amelyek együttesen meghatározzák, hogy a sorba rendezés időtartamának milyen tartományba kell esnie (ezredmásodpercben).

Ezek a paraméterek több hirdetés kérelmezésére használhatók. 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 nem használhatók (ha ad_rule=1).

Gyakorlati példa

pmnd=0&pmxd=60000

pod

(Pod száma)

A sorba rendezés száma paraméter változó értéket fogad el, és a videón belül a sorba rendezés sorszámát jelzi (pl. 1. sorba rendezés, 2. sorba rendezés stb.).

Gyakorlati példa

pod=3

Követelmény

Kötelező A versenytársak kizárásához, a gyakoriságkorlátozáshoz és a kapcsolódó funkciókhoz szükséges a megfelelő működés érdekében.

pp

(Kreatívprofil)

A kreatívprofil paraméter változó értéket fogad el, és azt szabályozza a videó- és audiokreatív-profil beállításai alapján, hogy mely kreatívok jogosultak a megjelenésre.

Gyakorlati példa

pp=creative_profile

Követelmény

javasolt Automatizált bevételszerzéshez ajánlott

ppt

(Publisher Privacy Treatment)

A Publisher Privacy Treatment paraméter konstans értéket fogad el, amely annak jelzésére szolgál, hogy a rendszer kikapcsolja-e a hirdetések személyre szabását a hirdetési kérelemnél.

További információ a Publisher Privacy Treatmentről.

Gyakorlati példa

A hirdetések személyre szabásának kikapcsolása:
ppt=1

ppid

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

A megjelenítő által biztosított azonosító (PPID) paraméter az azonosító változó értékét fogadja el, és gyakoriságkorlátozásra, közönségszegmentálásra és -célzásra, egymást követő hirdetések rotációjára, valamint további közönségalapú hirdetésmegjelenítési vezérlők esetében használható többféle eszközön.

Gyakorlati példa

ppid=12JD92JD8078S8J29SDOAKC0EF230337

ppos

(Pozíció a podban)

A pozíció a sorban paraméter változó értéket fogad el, és a sorba rendezésen belüli pozíciót jelöli (pl. 1. pozíció, 2. pozíció stb.).

Ez a paraméter csak a normál sorba rendezéseknél használható, és szükséges a kísérőhirdetések automatikus kitöltéséhez.

Gyakorlati példa

ppos=2

Követelmény

Kötelező A versenytársak kizárásához, a gyakoriságkorlátozáshoz és a kapcsolódó funkciókhoz szükséges a megfelelő működés érdekében.

ppsj

(Megjelenítő által biztosított jelek JSON-fájlja)

A megjelenítő által biztosított jelek JSON-paramétere az automatizált bevételszerzés javítása érdekében megjelenítő által biztosított közönség- és kontextuális adatokat tartalmazó, base64 kódolású JSON-objektumot fogad el.

További információ a megjelenítő által biztosított jelekről és a támogatott taxonómiákról.

Az érvényes JSON-kulcsértékpárok részleteit a
HTML5 IMA SDK mintájában tekintheti meg.

Gyakorlati példa

JSON-objektum:
{
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
  }]
}

Base64-kódolású érték:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s
idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj
pbIjEiLCIyODQiXX1dfQ

ptpl

(Hirdetésszünet sablonjának azonosítója)

ptpln

(Hirdetésszünet-sablon neve)

A hirdetésszünet-sablon azonosítója és neve változóértékeket fogad el, és jelzi, hogy melyik hirdetésszünet-sablont kell alkalmazni az optimalizált sorba rendezési kérelemre. A hirdetésszünet-sablonok lehetővé teszik annak beállítását, hogy mely hirdetési helyeket vagy egyéni hirdetési helyeket kell felvenni a hirdetésszünetbe, illetve hogy milyen sorrendben kell megjelenniük.

A hirdetésszünet-sablon kérelmezéséhez a két paraméter (név vagy azonosító) közül csak az egyik szükséges.

Gyakorlati példa

Itt találhat további részleteket a hirdetésszünet-sablonok beállításáról és kérelmezéséről.
 
pubf

(Nyilvános minimálárak az Ad Exchange-címkékben)

pvtf

(Privát minimálárak az Ad Exchange-címkékben)

A pubf a google_ad_public_floor megfelelője, a pvtf pedig a google_ad_private_floor megfelelője. Segítségükkel minimálárakat adhat hozzá az Ad Exchange-címkékhez.

Gyakorlati példa

pubf=123
pvtf=123

pvid

(Alkalmazáskészlet-azonosító)

pvid_s

(Alkalmazáskészlet hatóköre)

Ha a felhasználók leiratkoznak a személyre szabásról Android-eszközökön, akkor az alkalmazáskészlet-azonosítói értékekre van szükség a bevételszerzéshez.

A pvid paraméter elfogadja az androidos alkalmazáskészlet-azonosítóra állított változó értéket, a pvid_s paraméter pedig elfogadja az alkalmazáskészlet-azonosító hatókörét (scope_app vagy scope_developer) képviselő állandó értéket.

Míg az IMA/PAL SDK automatikusan adja át ezt a mezőt, a nem SDK-val történő megvalósítást használó megjelenítőknek meg kell hívniuk az alkalmazáskészlet SDK-ját, és manuálisan kell továbbítaniuk ezeket a paramétereket a hirdetési kérelem alapján.

Tekintse meg az alkalmazáskészlet-azonosító lekéréséről szóló Android-dokumentációt.

Gyakorlati példa

pvid=[AppSetID_value]
pvid_s=scope_app

Követelmény

Kötelező Alkalmazásokhoz szükséges

javasolt Automatizált bevételszerzéshez ajánlott

rdid
idtype
is_lat

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

A visszaállítható eszközazonosítók változó értéket fogadnak el.

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 az ügyféloldali hirdetési kérelmeknél). További információ az eszközazonosítókról.

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

Figyelmeztetés

Az IOS14 verziótól kezdve az Apple megszüntette a LAT-jelzést, ezért alapértelmezés szerint le van tiltva a leiratkozás. Ahol a megjelenítő megerősítette, ott a Google ehelyett a nem nulla értékű IDFA-ra hagyatkozik, jelezve, hogy a követés nem lett letiltva. Ekkor érvényes UserAgent jelzi, hogy az operációs rendszer megfelelő verziója szükséges.

Gyakorlati példa

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

Követelmény

Kötelező Alkalmazásokhoz szükséges

javasolt Automatizált bevételszerzéshez ajánlott

rdp

(Az adatfeldolgozás korlátozása)

Az adatfeldolgozás korlátozása paraméter konstans értéket fogad el, és azt jelzi, hogy a hirdetési kérelemnek korlátoznia kell 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.

Gyakorlati példa

rdp=1

scor

(Streamkorrelátor)

A streamkorrelátor paraméter változó értéket fogad el, amelynek az egyes videóstreamekhez generált egész számnak kell lennie. 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 adott felhasználó több videót néz ugyanazon az oldalon.

Gyakorlati példa

scor=17

Követelmény

Kötelező A versenytársak kizárásához, a gyakoriságkorlátozáshoz és a kapcsolódó funkciókhoz szükséges a megfelelő működés érdekében.

sdk_apis

(SDK API-keretrendszer)

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

Ez a paraméter az Automatizált Hozzáférési Könyvtárban (Programmatic Access Library, PAL) szereplő API-kat támogatja az IMA SDK-t nem használó megjelenítők esetében. Az IMA SDK felülírja az IMA SDK által támogatott értékekkel beállított értékeket.

Gyakorlati példa

sdk_apis=2,7,9

sdmax

(Átugorható hirdetés max. időtartama)

Az sdmax (átugorható hirdetés maximális időtartama) hirdetésikérelem-paraméter változó értéket fogad el, amely lehetővé teszi a megjelenítők számára, hogy megadják az átugorható hirdetések maximális hirdetési időtartamát.

Az időtartam ezredmásodpercben adható meg, amely azt a felső határértéket jelenti, amelyet az adott hirdetési kérelemnél az átugorható videó-/audiokreatívok időtartamánál engedélyezve lesz.

Az sdmax paramétert használja függetlenül az átugorható hirdetésekhez, vagy a meglévő max_ad_duration paraméterrel kombinálva különböző maximális időtartamokat adhat meg az átugorható és a nem átugorható hirdetésekhez.

Gyakorlati példa

A következő beállítások használatával:

  • max_ad_duration = 15 000 (15 másodperc)
  • sdmax = 45 000 (45 másodperc)

A következő kreatívok esetében:

  • A kreatív: nem átugorható; 30 mp
  • „B” kreatív: átugorható; 30 mp

Eredmény:

  • Az A kreatívot a rendszer kiszűri, mert nem átugorható, és időtartama meghaladja a (nem átugorható) maximumot.
  • A B kreatívot a rendszer nem szűri ki, mert bár időtartama meghaladja a max_ad_duration paramétert, átugorható, és időtartama nem haladja meg az átugorható maximumot.
sid

(Munkamenet-azonosító)

A munkamenet-azonosító paraméter változó értéket fogad el, és olyan, az adatok védelmére szolgáló hirdetési azonosító, amely csak gyakoriságkorlátozási célból használható.

A munkamenet-azonosító csatlakoztatott TV-kről érkező, videóba ágyazott hirdetési kérelmeknél, valamint mobilalkalmazás-eszközök videóba ágyazott készleteinek esetében támogatott. Ez a funkció webes környezetben jelenleg nem támogatott.

Az IAB IFA irányelvei szerint ezt a paramétert UUID formátumban kell kitölteni. További információ a visszaállítható eszközazonosítók átadásáról a felhasználók célzásához.

A sid=0 beállítás megadásával kikapcsolhatja a munkamenet-azonosító továbbítását.

Gyakorlati példa

123e4567-e89b-12d3-a456-426614174000

Követelmény

javasolt Automatizált bevételszerzéshez ajánlott

ssss

(Szerveroldali összefűzés forrása)

A szerveroldali összefűzés forrásparamétere konstans értéket fogad el, amelyet felismerhető, az Ön video-összefűzési szolgáltatója számára a Google által biztosított értékre kell beállítani.

A Google szerverek közötti integrációját használó video-összefűzési szolgáltatók a Google-tól kapják ezt az értéket, és az Ön részére is biztosíthatják. A paraméterhez beállítható értékkel kapcsolatos esetleges kérdéseivel forduljon a Google-fiókkezelőjéhez.

Gyakorlati példa

ssss=mystitcher

Követelmény

Kötelező Szerveroldali megvalósításoknál szükséges

sz

(Méret)

A méret paraméter változó értéket fogad el, amelyet a fő videóhirdetési hely méretére kell állítani.

Több méret megadása esetén az elválasztásukhoz használja a függőleges vonal (|) karaktert.

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

Gyakorlati példa

sz=400x300

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

Ez a paraméter nem kötelező, ha csak ad_type=audio kérésére kerül sor.

tfcd

(Megcímkézés gyermekeknek készültként)

A gyermekeknek készült paraméter konstans értéket fogad el, és a gyermekközpontú bánásmód címkéjével látja el a hirdetéskérelmet.

Gyakorlati példa

tfcd=1

trt

(Forgalomtípus)

A forgalomtípus paramétere konstans értéket fogad el, amely vagy vásárolt, vagy organikus forgalom kérelmezésére szolgál.

Ha a forgalomtípus paramétere hiányzik a kérelemből, az IMA SDK nem tölti ki alapértelmezett értékkel. Ilyen esetekben a szerver a 0 alapértelmezett értéket adja meg (nem meghatározott forgalom).

Gyakorlati példa

Vásárolt forgalomra vonatkozó kérelem:
trt=1

Organikus forgalomra vonatkozó kérelem:
trt=2

unviewed_position_start

(Késleltetett megjelenítések)

A késleltetett megjelenítések paraméter konstans értéket fogad el a videók késleltetett megjelenítéseinek jelzéséhez.

Gyakorlati példa

unviewed_position_start=1

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

url

(URL)

Az URL-paramétert megadó változót a teljes URL-re kell beállítani, amelyről a kérelem érkezik. Erre az értékre azért van szükség, hogy segítse a vevőket azonosítani és megérteni a kérelem forrásának kontextusát. Amennyiben lehetséges, érdemes ezt az értéket dinamikusan kitölteni a hirdetési kérelmen.

Weboldal esetében ez annak az oldalnak az URL-címe, amely megjeleníti a videólejátszót. Ha az IMA SDK-t használja, akkor az URL értékét automatikusan beállítja a rendszer. Ha a lejátszó állítja be ezt az értéket, az IMA SDK figyelembe veszi a beállított értéket.

Alkalmazásban (mobilon vagy CTV-n) azt az URL-címet kell beállítani az értékhez, amely a legpontosabban tükrözi a bevételszerzésre használt videó- vagy audiokészletet. Például ha a felhasználó olyan mobilalkalmazásban nézi a videót, amelynek számítógéppel hozzáférhető URL-címe is van.*

A paraméter értékét kódolni kell.

Gyakorlati példa

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

* Amennyiben alkalmazások esetében nem állítható be ez a paraméter változó URL-értékre, a következő minta szerinti beállítás javasolt:
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com

Követelmény

Kötelező Weben és alkalmazásoknál szükséges

javasolt Automatizált bevételszerzéshez ajánlott

vad_type

(Videóhirdetés típusa)

A videóhirdetés típusa paraméter konstans értéket fogad el, és azt jelzi, hogy lineáris vagy nem lineáris hirdetést küldjön-e vissza a rendszer.

Gyakorlati példa

Lineáris hirdetés visszaküldése:
vad_type=linear

Nem lineáris hirdetés visszaküldése:
vad_type=nonlinear

vid_d

(Videó időtartama)

Ez a paraméter elfogad a tartalom időtartamának értékét másodpercben meghatározó változó értéket.

A vid_d és az allcues paraméterek használatával tartalom közbeni hirdetések jeleníthetők meg tartalomfeldolgozás nélkül. A hirdetési szabályoknak szintén meg kell jeleníteniük a tartalom közbeni hirdetéseket.

Gyakorlati példa

A videótartalom időtartama 90 000 másodperc (25 óra):
vid_d=90000

vconp

(Videó folyamatos lejátszása)

Javasolt az MRC videóhirdetések mérésével kapcsolatos irányelvei alapján

A videó folyamatos lejátszása paraméter konstans értéket fogad el, és azt jelzi, hogy a lejátszó folyamatosan, a tévés közvetítésekhez hasonlóan játssza-e le a videókat.

Ha ismeretlen, akkor nem kell beállítani a paramétert.

Gyakorlati példa

Folyamatos lejátszás BEKAPCSOLVA:
vconp=2

Folyamatos lejátszás KIKAPCSOLVA:
vconp=1

vpa

(Videó automatikus lejátszása)

Javasolt az MRC videóhirdetések mérésével kapcsolatos irányelvei alapján

Az automatikus videólejátszás paramétere konstans értéket fogad el, és azt jelzi, hogy a hirdetés videótartalma 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.

Ha ismeretlen, akkor nem kell beállítani a paramétert.

Gyakorlati példa

Automatikus lejátszás:
vpa=auto

Kattintásra lejátszódó:
vpa=click

Követelmény

javasolt Automatizált bevételszerzéshez ajánlott

vpi

(Belső átirányítású videólejátszási lista)

A belső átirányítású videólejátszási lista paraméter konstans értéket fogad el, ami azt jelzi, hogy megjelenjen-e szövegközi VMAP (VAST visszaküldése VMAP-en belül).

Ez a paraméter 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.

Gyakorlati példa

VAST visszaküldése:
vpi=1

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

vpmute

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

Javasolt az MRC videóhirdetések mérésével kapcsolatos irányelvei alapján

A némított videó paraméter konstans értéket fogad el, és azt jelzi, hogy elkezdődjön-e a hirdetés lejátszása, miközben le van némítva a videólejátszó.

Gyakorlati példa

Némított:
vpmute=1

Nem némított:
vpmute=0

Követelmény

Kötelező Webes és Automatizált bevételszerzés esetén szükséges

vpos

(Videó pozíciója)

A videó pozíciója paraméter konstans értéket fogad el, és azt jelzi, hogy a hirdetési kérelem tartalom előtti, közbeni vagy utáni hirdetésre vonatkozik-e.

Gyakorlati példa

Tartalom előtti hirdetés:
vpos=preroll

Tartalom közbeni hirdetés:
vpos=midroll

Tartalom utáni hirdetés:
vpos=postroll

Követelmény

javasolt Automatizált bevételszerzéshez ajánlott

wta

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

A „Miért jelent meg ez a hirdetés?” paraméter konstans értéket fogad el, és azt jelzi, hogy a videólejátszó támogatja-e a „Miért jelent meg ez a hirdetés?” megjelenítését.

A „Miért jelent meg ez a hirdetés?” funkció 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 audiohirdetésekre vonatkozó kéréseknek wta=1 paramétert kell küldeniük, ha a VAST-válaszban megadott AdChoices-ikon megjelenik a kísérőhirdetésekben, vagy pedig más módon kerül a felhasználó elé.

Ahhoz, hogy megfeleljenek a Google-keresleti és a Google által biztosított EGT-s foglalási forgalom feltételeinek, a hirdetési kérelmeknek el kell küldeniük a wta=1 paramétert annak jelzéséül, hogy a VAST-válaszban megadott AdChoices-ikon megjelenik a videóhirdetésben, a kísérőhirdetésekben, vagy pedig más módon kerül a felhasználó elé – valamennyi hirdetési kreatív esetében.

Gyakorlati példa

Támogatott:
wta=1

Nem támogatott:
wta=0

Követelmény

Kötelező Az Ad Exchange-nél szükséges

Kötelező Kötelező az EGT-s webes és alkalmazásbeli forgalom esetén

javasolt Automatizált bevételszerzéshez ajánlott

Hasznosnak találta?

Hogyan fejleszthetnénk?
Keresés
Keresés törlése
A keresés bezárása
Google-alkalmazások
Főmenü
10565581276475954430
true
Keresés a Súgóoldalakon
true
true
true
true
true
148
false
false