Kreatívkód betöltése címke nélküli kérelemmel

A hirdetéscímkék helyett címke nélküli kérelmeket is használhat az Ad Managerben forgalmazott nyers kreatívkód kérésére. Általában akkor használják a címke nélküli kérelmeket, amikor egyéni elemzésre és megjelenítésre van szükség, például set-top boxok esetén, vagy olyan egyéb környezetekben, ahol nem áll rendelkezésre Google-címkézés vagy SDK-támogatás.

A címke nélküli kérelmek hívásakor az Ad Manager csak a nyers kreatívkódot küldi vissza, pontosan úgy, ahogyan a forgalmazásra sor kerül, a hirdetés elindítása és megjelenítése nélkül. Ha nem található hirdetés, akkor a rendszer üres válasszal rendelkező 200/OK állapotot küld vissza.

Az alkalmazásnak, a lejátszónak vagy a webhelynek végre kell hajtania a kódot a hirdetés megjelenítéséhez, és aktiválnia kell a megjelenítéskövetést.

Nem támogatott a címke nélküli kérelmek használata e-mailben történő hirdetésmegjelenítés céljából. Tekintse át az összes nem támogatott funkciót.

Címke nélküli kérelem manuális létrehozása

A címke nélküli kérelem létrehozásához vegye az alap URL-t, és fűzze hozzá az összes kötelező paramétert és a használni kívánt nem kötelező paramétereket. Ezek a paraméterek olyan elemeket határoznak meg, mint a hirdetési egység, a kreatívméret, a kulcsértékek és a kérelemmel kapcsolatos egyéb információk.

A címke nélküli kérelmeket biztonságosan, SSL (https://) használatával kell végrehajtani.

Kezdje az alap URL-címmel

Használja ezt az alap URL-címet:  https://securepubads.g.doubleclick.net/gampad/adx?

Adja meg a hirdetési kérelem paramétereit

Kötelező paraméterek

Paraméter	Leírás
iu	A Google Ad Manager hirdetési egység kódja a Google Ad Manager-hálózat kódjával együtt. Több szint megadásakor használja a törtvonal (/) karaktert elválasztóként. Példa iu=/123/homepage iu=/456/sports/baseball Ha a Több ügyfél kezelése (MCM) szolgáltatást használja a címke nélküli kérelmekkel, használja a parent,child struktúrát a hálózati kódhoz. Példa (MCM) iu=/123,456/homepage
sz	A kreatív mérete. Több méret megadásakor használja a függőleges vonal (|) karaktert elválasztóként. Példa sz=320x50 egyetlen méret esetén sz=320x50|300x50 több méret esetén Azt javasoljuk, hogy a címke nélküli kérelmekben kódolja a függőleges vonal (|) karaktereket a %7c karakterlánccal. Példa Az &sz=216x36|300x50|320x50 karakterláncból a következő lesz: &sz=216x36%7c300x50%7c320x50.
url	A kezdeti hirdetési kérelmet tároló domain URL-je. Csak az MCM-kérelmek esetében szükséges. Példa url=www.example.com
c	Korrelátor (vagy cache-busting) érték. Ennek véletlenszerű számnak kell lennie (betűk nem használhatók), amelyet a megjelenítő generál annak biztosítása érdekében, hogy az oldal minden betöltésekor új hívás történjen a hirdetésszerver felé, elkerülve ezáltal a megjelenítésszámolási eltéréseket. Példa c=8362527364
tile	A címke pozíciója a weboldalon. Az értéknek egyedi egész számnak kell lennie. Az egyszerű megvalósításhoz azt javasoljuk, az érték változzon egyesével felfelé. Ez csak akkor szükséges, ha több hirdetési címke használja ugyanazt a hirdetésiegység-kódot (iu=) és korrelátorértéket (c=) ugyanazon az oldalon. Példa https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

Opcionális paraméterek

Paraméter	Leírás
d_imp	Késleltetett megjelenítés kapcsolója. Ha be van állítva, akkor a rendszer letiltja a kérés végrehajtásakor történő megjelenítésszámlálást, és vagy a visszaküldött kreatívban lévő megtekintett megjelenítés makrót, vagy a d_imp_hdr paraméterből származó információt használja a megjelenítések rögzítésére. Példa d_imp=1 d_imp=0 (Ez az alapértelmezett érték a Google Ad Manager megjelenítésszámlálása esetében.)
d_imp_hdr	Késleltetett megjelenítés fejlécadatának kapcsolója. Ha be van állítva, akkor a megjelenítésszámoláshoz használandó megtekintési URL-t a rendszer visszaküldi a HTTP-fejlécben. Ez a fejlécadat alapértelmezés szerint nincs meghatározva. A megjelenítőnek ilyenkor manuálisan kell pingelnie a megtekintési URL-t a megjelenítés számolásához. További információ a megjelenítésszámolásról és a címke nélküli kérelmekről. A Google-Delayed-Impression fejléc tartalmazza a Google Ad Manager megjelenítési URL-t. A Google-3rdParty-Delayed-Impression fejléc tartalmazza a harmadik fél megjelenítési URL-jét, ha szerepel a kreatívban. Példa d_imp_hdr=1 d_imp_hdr=0 (Kifejezetten letiltja a késleltetett megjelenítés fejlécadatát.)
t	Helyszintű kulcsértékpárok. Minden kulcs és érték egyenlőségjellel van elválasztva (= karakter); a kulcsértékpárok és jellel (&) vannak elválasztva. Minden kulcs és érték URL-kódolása egyénileg kell, hogy történjen, és ezután következhet a teljes karakterlánc URL-kódolása. A kulcsértékek csoportján belül mindegyik kulcsnak egyedinek kell lennie; ha ugyanazt a kulcsot többször adja meg, a rendszer csak az egyik társított értéket veszi figyelembe. Példa A t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith paraméter a „genre” (műfaj) kulcsot hozzárendeli az „action” (akció) értékhez, a „movie” (film) kulcsot pedig a „Mr & Mrs Smith” értékhez. Figyelje meg, hogy a kulcsérték-hozzárendelésekben lévő „&” jel egyszeresen van kódolva (%26), míg ha értéken belül fordul elő, akkor kétszeresen kódolt (%2526). Az excl_cat speciális kulccsal zárhat ki versenytársakat. Példa t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines A következő karakterek nem engedélyezettek sem kulcsokban, sem értékekben: " ' ! + # * ~ ; ^ ( ) < > [ ] = . A szóközök engedélyezettek az értékekben (%20 vagy + karakterként feloldva), de a kulcsokban nem. Példa Az „a” kulcs beállítása a „b+c” értékre a t=a%3Db%252Bc megoldással nem működik.
m	Mime-típus értéke a HTTP-fejlécben. Példa m=text/wml
mob	Mobilhirdetési kérés kódja. Példa mob=js (Ez az egyetlen elfogadott érték.)
ppid	A megjelenítő által biztosított azonosító (PPID) paraméter lehetővé teszi, hogy egy olyan azonosítót küldjön a Google Ad Manager szolgáltatásnak, amelyet a gyakoriságkorlátozás, a közönségszegmentálás, a célcsoport szerinti célzás, a szekvenciális hirdetésrotáció, valamint más közönségalapú hirdetésmegjelenítési vezérlők esetében használhat többféle eszközön. Példa ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Mobileszközök képernyőszélessége, amely felülbírálja a hirdetésszerver által végzett automatikus észlelést. Példa u_w=1024
u_h	A mobileszköz kijelzőjének magassága, amely felülbírálja a hirdetésszerver által automatikusan érzékelt értéket. Példa u_h=768
submodel	A mobileszköz hardverinformációja, amely felülbírálja a hirdetésszerver által végzett automatikus észlelést. Példa submodel=iPhone4%2C1 (A modellváltozat értékében lévő vessző kódolva van.) Modellváltozat-értékek: iPhone (első generációs): iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iphone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iphone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM és LTE): iPhone5,1 iPhone 5 (CDMA és LTE): iPhone5,2 iPhone 5c (GSM és CDMA): iPhone5,3 iPhone 5c (GSM és CDMA): iPhone5,4 iPhone 5s (GSM és CDMA): iPhone6,1 iPhone 5s (GSM és CDMA): iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2 1. generációs iPod: iPod1,1 2. generációs iPod: iPod2,1 3. generációs iPod: iPod3,1 4. generációs iPod: iPod4,1 5. generációs iPod: iPod5,1 1. generációs iPad (Wi-Fi): iPad1,1 1. generációs iPad (AT&T): iPad1,2 2. generációs iPad (Wi-Fi): iPad2,1 2. generációs iPad (AT&T): iPad2,2 2. generációs iPad (Verizon): iPad2,3 2. generációs iPad (Wi-Fi): iPad2,4 3. generációs iPad (Wi-Fi): iPad3,1 3. generációs iPad (Verizon): iPad3,2 3. generációs iPad (AT&T): iPad3,3 4. generációs iPad (Wi-Fi): iPad3,4 4. generációs iPad (AT&T): iPad3,5 4. generációs iPad (Verizon): iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T-US; GSM és LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA és LTE 1,3,5,13,25): iPad2,7 iPad Mini Retina (Wi-Fi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Visszaállítható eszközazonosítókat (resettable device ID, RDID) használhat a gyakoriságkorlátozáshoz és a célcsoport szerinti célzáshoz. További információ arról, hogyan állítható be RDID a címke nélküli kérelmekhez.

Megjelenítéskövetés aktiválása

Az Ad Manager követheti a letöltött megjelenítéseket (más néven „késleltetett” megjelenítéseket) a címke nélküli kérelmeknél. Az alábbi lehetőségek közül bármelyiket használhatja, de ne mindet egyszerre. Ha mégis együtt használja őket, akkor a rendszer duplán (vagy triplán) számolhatja a megjelenítéseket.

Az első lehetőséget javasoljuk, de ehhez hozzáféréssel kell rendelkeznie a HTTP-válaszfejlécekhez, és képesnek kell lennie a fejlécalapú protokoll megvalósítására.

1. módszer: A HTTP-válaszfejléc olvasása a megjelenítésszámlálás végrehajtásához

Adja hozzá a d_imp=1 és d_imp_hdr=1 paramétereket a címke nélküli kérelmekhez, így a Google Ad Manager nem rögzít megjelenítést vagy letöltött megjelenítést, amíg Ön manuálisan végre nem hajtja a megjelenítési pingelést a Google-Delayed-Impression HTTP-fejlécű URL-lel. Megjelenítési ping kiváltásakor a Google Ad Manager a „hirdetésszerver megjelenítését” és a „hirdetésszerver letöltött megjelenítését” rögzíti.

A megjelenítések duplán számolásának elkerülése érdekében ne használja a megtekintett megjelenítés makrót a címke nélküli kérelmek által visszaküldött kreatívokban.

2. módszer: A megtekintett megjelenítés makró használata

Ha nem fér hozzá a HTTP-válaszfejlécekhez, akkor adja hozzá a megtekintett megjelenítések makrót a címke nélküli kérelem által visszaküldött összes kreatívhoz. Ez a makró arra az URL-re bővül, amelyet a kreatívnak kell elküldeni a megjelenésekor.

Címke nélküli kérelem használata a kreatívkód lekéréséhez

Internetes tartalom

A címke nélküli kérelmeket általában olyan környezetben használják, ahol nem áll rendelkezésre Google-címkézés vagy SDK-támogatás. Ha a címke nélküli kérelmet az interneten használja, akkor <iframe> keretbe kell betöltenie, hogy végrehajthassa a visszaküldött nyers kódot.

A Google SDK-val nem rendelkező egyéni környezetek

Ha Google-címkézés vagy SDK nélküli környezetben (például nem a Google-tól származó set-top boxon) szeretne lekérni nyers kreatívkódot, tartsa be a következő irányelveket:

• Állítson be érvényes felhasználói ügynököt a kérelem User-Agent fejlécében, hogy a célzás biztosan megfelelően működjön.
• Győződjön meg arról, hogy a környezet tudja kezelni a multimédiás működést (beleértve a JavaScriptet és a kreatív kibontását).
• Kezdeményezzen HTTPS-kérést a Google Ad Manager felé.
• Vizsgálja meg a válasz állapotát a „HTTP 200/OK” választ keresve, amely azt jelzi, hogy megfelelő volt a kérés formátuma.

A címke nélküli kérelmek nem támogatják a következő funkciókat:

• Aktív megtekintés;
• Ad Exchange;
• a követésre használt cookie-k vagy mobilalkalmazás-azonosítók;
• kreatívburkolók;
• dinamikus elosztás az AdSense, Ad Exchange és AdMob szolgáltatások használatával;
• natív készlet;
• Preferált ügyletek;
• Creative Preview.

Azok a címke nélküli kérelmek, amelyek a gampad/ad elemet használják a HTML-képcímkéknél (<img>), nem támogatják a JavaScript-követőkódot, és nem támogatottak a letöltött megjelenítések számlálásánál.

Az ilyen hirdetésekre vonatkozó jelentés készítéséhez használja „A kódmegjelenítések teljes száma” mutatót az Ad Manager-jelentésekben.