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.
Az URL-ekre vonatkozó általános 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és 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
Ugrás adott paraméterre a listában
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éldaFolyamatos lejátszás BEKAPCSOLVA: Folyamatos lejátszás KIKAPCSOLVA: |
|
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éldaVAST-kreatívra vonatkozó kérelem Hirdetési szabályokra vonatkozó kérelem (VMAP): KövetelményVideó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álatraCsak audiohirdetéseket engedélyez: Átugorható és nem átugorható videóhirdetéseket is engedélyez: Az audio- és videóhirdetéseket is engedélyezi: 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: Csak nem átugorható videóhirdetéseket engedélyez: KövetelményAudiohirdetéseknél szükséges |
|
addtl_consent
(Kiegészítő hozzájárulás) |
A Kiegészítő hozzájárulási paramétere változó értékeket fogad el, és olyan megjelenítők használják, akik integrációt szeretnének kialakítani az IAB TCF 2.0-s verziójával, és olyan szolgáltatót használnak, amely még nincs regisztrálva az IAB Europe globális szolgáltatói listáján, de szerepel a Google hirdetéstechnológiai szolgáltatóinak listáján. 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. A paraméternek átadott értékekről a Kiegészítő hozzájárulási mód technikai specifikációjában talál további információt. Gyakorlati példa
|
|
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:
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éldaMinden méret támogatott: A maximális szélesség 250: A maximális magasság 60: A maximális szélesség 100:
KövetelményNem 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 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 Gyakorlati példaJelzőpontok 10 és 20 másodpercnél: |
|
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 ( Gyakorlati példa
Méretek többméretes hirdetési hellyel: |
|
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 A Gyakorlati példa
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: KövetelményVideó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
KövetelményWeben és alkalmazásoknál szükséges 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éldaTekintsen 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. Az oldal tartalmát 1–3 bekezdésben ismertesse. Például fűzze össze a A Ezt a paramétert az IMA SDK nem állítja be automatikusan. Manuálisan kell beállítani. Gyakorlati példaKódolt URL: Nem kódolt URL: KövetelményWeben, alkalmazásoknál és az Ad Exchange-nél szükséges Automatizált bevételszerzéshez ajánlott |
|
dth
(Eszköztípussal kapcsolatos tipp) |
Az eszköztípussal kapcsolatos tipp paraméter konstans értéket fogad el, ami segít csökkenteni az eszköz hibás besorolását, különösen csatlakoztatott TV-k és set-top box környezetek esetén. Az eszközök helytelen besorolása a megjelenítő vagy a csatlakoztatott TV OEM-jének nem szándékos hibáira vezethető vissza. Ezt a paramétert más jelekkel együtt kell használni annak érdekében, hogy a Google automatikusan megjelölje azokat az eseteket, amikor a csatlakoztatott TV-készlet átsorolható. Példák a használatraKérések a következőtől:
KövetelményAutomatizált bevételszerzéshez ajánlott csatlakoztatott tévén. Ez a paraméter a PAL és a PAI (nem SDK) megvalósítások esetén ajánlott. Az IMA SDK és a DAI SDK esetében nincs rá szükség. |
|
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: Gyakorlati példaVideó- és/vagy audiohirdetés: Csak videóhirdetés: KövetelményWeben é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: Gyakorlati példa
|
|
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
KövetelményWeben é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éldaA GDPR érvényben van: A GDPR nincs érvényben: |
|
gdpr_consent
(GDPR-beleegyezés) |
A GDPR beleegyezési paraméter változó é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. 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
|
|
givn paln
(Videó egyszer használatos véletlenszáma) |
For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value. The nonce is URL safe—you don't need to URL-encode it.
Note: If you previously provided a nonce using the legacy Usage exampleYou can read more about the value passed to this parameter in the getting started guides for PAL. |
|
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
KövetelményAutomatizá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éldaAz 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 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 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éldaSzerveroldali beaconing (server-side beaconing, 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:
Gyakorlati példa
KövetelményWeben é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
|
|
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.
Gyakorlati példa
|
|
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
|
|
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
|
|
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 Gyakorlati példa
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: KövetelményMindkét paraméter megadása kötelező az alkalmazások esetén. 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éldaTartalékhirdetés letiltva: |
|
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 Gyakorlati példaNem személyre szabott hirdetések: |
|
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 Gyakorlati példaPAL használata esetén: Ha nem használ PAL-t: |
|
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 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: A hálózatnál aktivált alapértelmezett VMAP-verzió (pl. VMAP 1) elküldéséhez használja az Gyakorlati példaHálózata alapértelmezett VAST-beállítása: VAST 4: Hálózata alapértelmezett VMAP-beállítása: VMAP 1: VMAP 1, VAST 4 visszaküldésével: KövetelményWeben é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éldaVideóba ágyazott kérelem: Kísérő tartalomra vonatkozó kérelem: KövetelményWebes é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 Gyakorlati példa
|
|
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 Gyakorlati példa
|
|
pod
(Sorba rendezés 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
KövetelményA 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
KövetelményAutomatizá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éldaA hirdetések személyre szabásának kikapcsolása: |
|
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
|
|
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
KövetelményA 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 Gyakorlati példaJSON-objektum: Base64-kódolású érték: |
|
ptpl
(Hirdetésszünet sablonjának azonosítója) ptpln
(Hirdetésszünet sablonjának 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. Gyakorlati példaItt 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 Gyakorlati példa
|
|
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 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
KövetelményAlkalmazásokhoz szükséges Automatizált bevételszerzéshez ajánlott |
|
rdid
(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: Szinte az összes automatizált videóhirdetés megköveteli ezeknek az értékeknek a meglétét.
Gyakorlati példaTekintse át a visszaállítható eszközazonosítókat bemutató részletes példákat. KövetelményAlkalmazásokhoz szükséges 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 Gyakorlati példa
|
|
schain
(Ellátási lánc) |
A szállítói lánc paraméter változó értéket fogad el, amelynek szerializált SupplyChain objektumnak kell lennie. Ha ez a paraméter szerepel, a Google a vevőknek való elküldés előtt csomópontot fűz hozzá minden kapott Az SupplyChain-információk címkén keresztül (OpenRTB helyett) történő kommunikációjáról a teljes IAB-dokumentációban tájékozódhat. Aschain megfelelő elemzésére vonatkozó követelmények
Az IAB dokumentációja alapján az alábbiak határozzák meg a
Szerializálási sorrendA
A
Megjegyzés: Az
ext tartalma piactérspecifikus. A Google Ad Manager nem elemzi ezt a tulajdont.Példák a SupplyChain objektum szerializálásáraAz alábbiakban két példát láthat a fenti Szerializálás vesszővel az üres opcionális mezőknél
Szerializálás vessző nélkül az üres, nem kötelező mezők esetén
További információ a SupplyChain objektumról.
Példák a használatra
Ha az
KövetelményKötelező azon megjelenítők számára, akik a Google Ad Managernek küldött kérelem előtt fizetési közvetítőket használnak. Ide tartoznak a külső hirdetésmegjelenítői technológiát használó megjelenítők is. |
|
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
KövetelményA 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
|
|
sdmax
(Átugorható hirdetés max. időtartama) |
Az 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 Gyakorlati példaA következő beállítások használatával:
A következő kreatívok esetében:
Eredmény:
|
|
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 Gyakorlati példa
KövetelményAutomatizá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
KövetelménySzerveroldali 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 ( A méret után ne használja a „ Gyakorlati példa
KövetelményWeben és alkalmazásoknál szükséges Ez a paraméter nem kötelező, ha csak |
|
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
|
|
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 Gyakorlati példaVásárolt forgalomra vonatkozó kérelem: Organikus forgalomra vonatkozó kérelem: |
|
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
KövetelményWeben é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
* 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: KövetelményWeben és alkalmazásoknál szükséges 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éldaLineáris hirdetés visszaküldése: Nem lineáris hirdetés visszaküldése: |
|
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 Gyakorlati példaA videótartalom időtartama 90 000 másodperc (25 óra): |
|
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éldaFolyamatos lejátszás BEKAPCSOLVA: Folyamatos lejátszás KIKAPCSOLVA: |
|
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: Ha ismeretlen, akkor nem kell beállítani a paramétert. Gyakorlati példaAutomatikus lejátszás: Kattintásra lejátszódó: KövetelményAutomatizá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éldaVAST visszaküldése: Átirányítások visszaküldése: |
|
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éldaNémított: Nem némított: KövetelményWebes é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éldaTartalom előtti hirdetés: Tartalom közbeni hirdetés: Tartalom utáni hirdetés: KövetelményAutomatizá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 hirdetésjelvények megjelenítését. Ha nem küld A hirdetésjelvényezés funkció 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 A megjelenítőknek az Az audiohirdetésekre vonatkozó kérések Az EGT-ből származó forgalom esetén az A hirdetéseknek meg kell felelniük az Európai Gazdasági Térségben (EGT) megjelenő hirdetésekre vonatkozó szabályozási követelményeknek. Ezek közé tartozik az illegális tartalmak bejelentésére szolgáló mechanizmus biztosítása a felhasználók számára. A megjelenítőknek a megfelelő űrlapon kell értesíteniük a Google-t az illegális tartalmakra vonatkozó bejelentésekről. Gyakorlati példaTámogatott:
Nem támogatott: KövetelményAz 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 |