Az automatizált megoldásoknál kötelező és javasolt paraméterek

A címkealapú videómegoldás megvalósítása Ad Exchange-keresletre IMA SDK használata nélkül bétaverziós ajánlat, és előfordulhat, hogy nem áll rendelkezésre az Ön hálózatán. További információért forduljon fiókkezelőjéhez.

A következőkben a VAST hirdetési címke URL-paramétereinek egy része látható. Ezek a paraméterek az automatizált, címkealapú videomegoldásokra vonatkoznak, amikor nincs integrálva az IMA SDK.

Tekintse meg a web esetén kötelező és ajánlott paraméterek, valamint az alkalmazások esetén kötelező paraméterek listáját.

Ugrás adott paraméterre a listában

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Paraméter	Részletek
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 Automatizált bevételszerzéshez ajánlott
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 Weben, alkalmazásoknál és az Ad Exchange-nél szükséges Automatizált bevételszerzéshez ajánlott
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 Mindkét paraméter megadása kötelező az alkalmazások esetén. Automatizált bevételszerzéshez ajánlott
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 Webes és Automatizált bevételszerzés esetén szükséges
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 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. 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. Gyakorlati példa Tekintse át a visszaállítható eszközazonosítókat bemutató részletes példákat. Követelmény Alkalmazásokhoz szükséges Automatizált bevételszerzéshez ajánlott
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 Automatizált bevételszerzéshez ajánlott
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 Weben és alkalmazásoknál szükséges Automatizált bevételszerzéshez ajánlott
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 Automatizált bevételszerzéshez ajánlott
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 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 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 Az Ad Exchange-nél szükséges Kötelező az EGT-s webes és alkalmazásbeli forgalom esetén Automatizált bevételszerzéshez ajánlott