Ad Exchange videócímke-paraméterek IMA3-hoz

Az alábbi táblázat bemutatja, hogy az Ad Exchange videóba ágyazott címkéi hogyan állíthatók be a megjelenítők számára. Ha létrehozott egy hirdetési címkét egy videóhoz, és belefoglalta a szükséges paramétereket (pl. description_url), akkor a javasolt vagy választható paraméterek bármelyikét hozzáfűzheti a kívánt hirdetésválasz eléréséhez.

 

	URL-paraméter
Kötelező	ad_type
	client
	description_url
Ajánlott	slotname
	videoad_start_delay
	hl
	max_ad_duration
	min_ad_duration
	sdmax
	vid_t
	vid_d
	vid_kw
	vpa
	vpmute
Opcionális	host
	h_ch
	overlay

 

Kezdje az alap URL-lel

Az alap URL az az URL, amelyhez hozzáadja az összes többi lekérdezési paramétert. E paraméterek leírása, lehetséges értékei és példái alább olvashatók.

Alap URL: http://googleads.g.doubleclick.net/pagead/ads?

Kötelező paraméterek

ad_type

---

(Karakterlánc) A kívánt hirdetés típusát adja meg. Több értéket is összekapcsolhat aláhúzásjel használatával.

Értékek

• video
    Az összes videóhirdetés (egyenértékű a standardvideo_skippablevideo paraméterrel).
• skippablevideo
    Csak átugorható videóhirdetések (az átugorható hirdetések fogadásához kiegészítő megjelenítői engedélyekre lehet szükség).
• standardvideo
    Csak nem átugorható videóhirdetések.
• image
    Megengedi olyan képes hirdetések használatát, amelyek elférnek a megadott méretű, nem lineáris hirdetéshelyen.
• text
    Megengedi a szöveges hirdetések használatát.

Példák

• &ad_type=video_text_image (minden formátumot engedélyez)
• &ad_type=video_text (megenged bármilyen videóformátumot és szöveges hirdetést)
• &ad_type=standardvideo_image (csak a szokásos, nem átugorható videóhirdetéseket és képes hirdetéseket engedi meg)

client

---

(Karakterlánc) A megjelenítő internetes tulajdonazonosítója.

Példa

&client=ca-video-afvtest

description_url

---

(Karakterlánc) A videót leíró HTML-oldal teljes URL-címe. Annak az oldalnak az URL-je, amely a kérést beküldő lejátszót tartalmazza. Kötelező, ha az Ad Exchange szolgáltatással végzi a dinamikus elosztást.

A description_url értékét URL-kódolni kell a weboldalakon lévő videólejátszók és CTV-/OTT-eszközök számára, de nem kell kódolni a mobilalkalmazásokon belüli videólejátszók számára.

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

Példa

http%3A%2F%2Fwww.simplevideoad.com%2Fgolf.html

 

Példa teljes URL-re

A következő példa egy olyan URL-t mutat be, amely tartalmazza a minimálisan szükséges paramétereket: http://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fwww.simplevideoad.com%2Fgolf.html%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2

Videóhirdetéseket kérelmez a ca-video-afvtest megjelenítő számára a következő leírási URL-lel: https://myurl.com/page?key=value&key2=value2

Javasolt és választható paraméterek

videoad_start_delay

---

(Egész szám) A videón belül az az idő ezredmásodpercben, amelynél a hirdetés megjelenik. Alapértelmezés szerint egy tartalom közbeni értéket, az 1-et veszi fel.

Értékek

• -1
    A videót záró videóhirdetést határoz meg, amely a tartalom végén jelenik meg.
• 0
    Tartalom előtti hirdetést határoz meg, amely a tartalom lejátszása előtt jelenik meg.
• Bármilyen pozitív egész szám
    tartalom közbeni hirdetést határoz meg, amely a tartalom lejátszásának kezdete után a megadott ezredmásodpercnyi idő elteltével jelenik meg.

Példák

• videoad_start_delay=-1 (tartalom utáni)
• videoad_start_delay=15000 (a hirdetés a tartalom kezdete után 15 másodperccel jelenik meg)

slotname

---

(Karakterlánc) Az AdSense/Ad Exchange hirdetéshely-azonosítóját jelenti. Ezt az értéket a megjelenítő frontend felülete generálja, és a hirdetéshelyet (hirdetési egységet) és a beállításait azonosítja. Hirdetési kérelmenként legfeljebb egy hirdetéshely adható át.

Példa

slotname=1

host

---

(Karakterlánc) A háromirányú bevételmegosztáshoz használt gazdagép-azonosító.

Példa

host=ca-host-test (bevétel megosztása ezzel a gazdagéppel)

h_ch

---

(Szám) Szintazonosító, amellyel a megjelenítő és a gazdagép közötti bevételmegosztás határozható meg.

Példa

ht_id=2 (2. szintű gazdagép)

hl

---

(Karakterlánc) Nyelvi kód, amellyel az adott nyelven kérelmezhetők hirdetések. Ez lehet bármilyen ISO 639-1 (kétbetűs), vagy ISO 639-2 (hárombetűs) kód. Tekintse meg az érvényes kódok teljes listáját.

Példák

• hl=en (angol)
• hl=es (spanyol)

max_ad_duration

---

(Egész szám) Meghatározza a visszaadandó videók maximális hosszát ezredmásodpercben. Alapértelmezett értéke 100 másodperc, ha nincs beállítva.

Példa

max_ad_duration=30000 (a nem átugorható hirdetések maximális időtartama 30 másodperc)

min_ad_duration

---

(Egész szám) Meghatározza a visszaadandó videók minimális hosszát ezredmásodpercben. Alapértelmezett értéke 0 másodperc, ha nincs beállítva.

Példák

• min_ad_duration=15000 (a nem átugorható hirdetés időtartamának legalább 15 másodpercnek kell lennie)
• min_ad_duration=0 (az időtartamot csak a max_ad_duration paraméter értéke korlátozza)

sdmax

---

(Egész szám) Meghatározza az átugorható hirdetések maximális videohosszát ezredmásodpercben. Alapértelmezett értéke a korlátlan, ha nincs beállítva.

Példa

sdmax=120000 (a visszaadott átugorható hirdetés időtartama nem haladhatja meg a 2 percet)

overlay

---

(Egész szám) A kért fedvényméretet a nem lineáris, alsó harmadnyi méretű fedvényekre korlátozza.
Alapértelmezés szerint nincs korlátozás beállítva.

Példák

• overlay=1 (csak alsó harmadnyi méretű fedvények adhatók vissza, teljes méretű fedvények kérése nem történik)

• overlay=0 (alapértelmezett érték, nem állít be korlátozást a fedvények méretére; a fedvényméretek megjelenítése az AdsRequest.nonLinearAdSlotWidth és az AdsRequest.nonLinearAdSlotHeight szerint történik.)

vid_t

---

(Karakterlánc) A videótartalom címe.

Példa

vid_t=Video%20Cime (csak a „Videó Címe" című videótartalmak)

vid_d

---

(Egész szám) A videótartalom időtartama másodpercben.

Példa

vid_d=1800 (csak 1800 másodperc hosszúságú videók)

vid_kw

---

(Karakterlánc) A videótartalmak kulcsszavainak vesszővel elválasztott listája. Például műfajok, kulcsértékek vagy más metaadatok.

Példa

vid_kw=drama,series,finale (csak a megadott kulcsszavaknak megfelelő videótartalmak)

vpa

---

(Egész szám) Meghatározza, hogy a videóhirdetések lejátszása automatikusan elinduljon-e.

Értékek

• 0  Kattintásra lejátszott videót jelez.
• 1  Automatikusan lejátszódó videót jelez.

Példák

• vpa=0 (kattintásra lejátszott)
• vpa=1 (automatikus lejátszás)

vpmute

---

(Egész szám) Meghatározza, hogy a videóhirdetések lejátszása némított állapotban kezdődjön-e.

Értékek

• 0  Bekapcsolt hangot jelez (alapértelmezett).
• 1  Némítást jelez.

Példák

• vpmute=0 (hang bekapcsolva)
• vpmute=1 (némított)