A jelenleg támogatott keresésistílus-paraméterek alábbi listáját haladó felhasználóknak szánjuk. Az AdSense rendszerben előállított kód az összes gyakran használt paraméterbeállítást tartalmazza. Két kötelező paraméter van: a pubId
és a query
. Az AdSense megadja a pubId paramétert, Önnek azonban szerkesztenie kell a kódot, és értéket kell átadnia a query
paraméter számára. Minden további paraméter opcionális, és leírása az alábbiakban található.
Paramétertípusok
Kétféle paraméter létezik:
- Oldalszintű paraméterek, amelyek az oldal összes hirdetési egységére vonatkoznak
- Egységszintű paraméterek, amelyek az egyes hirdetési egységekre vonatkoznak.
Példaként itt látható a kódgenerátor két hirdetési blokkot tartalmazó kimenete. A kód konfigurálásához meg kell adnia a kötelező query
paramétert a pageOptions
hozzárendelésben (pl. “query”: myQuery
). Mindössze ennyi szükséges a hirdetések megjelenítésének megkezdéséhez. Beállíthat opcionális oldalszintű paramétereket az oldalszintű blokkban, valamint egyéni egységszintű paramétereket az adblock1
és az adblock2
hozzárendelésben.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Oldalszintű paraméterek
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Egységszintű paraméterek
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Az oldalszintű paraméterek leírása
Ezeket a paramétereket oldalanként csak egyszer kell megadni. Hatással vannak az oldalon lévő összes egységre.
Kötelező
Paraméter | Leírás és példák |
---|---|
adPage |
Kötelező, ha a felhasználó a következő vagy az előző találati oldalra navigál
Az |
pubId |
Kötelező Ez az Ön AdSense Client-ID-je. A pubId a Client-ID része, amely a „partner-” karakterlánc után következik. Ha például a Client-ID „partner-test-property”, akkor a pubId értéke „test-property” lesz. Ez a CSA szabványos protokollja. Példa: 'pubId' : 'test-property' |
query |
Kötelező Ez a felhasználó által megadott keresőkifejezés. A lekérdezési paraméter értékének kódolatlanul kell maradnia. Példák:
|
resultsPageBaseUrl |
Kötelező, ha kapcsolódó keresési egységek vannak az oldalon Annak a keresési találatoldalnak az URL-címét adja meg, amelyen a keresőkifejezés az a kapcsolódó keresőkifejezés, amelyre a felhasználó rákattintott. A resultsPageBaseUrl saját paramétereket tartalmazhat, kivéve a keresőkifejezést, amelyet a rendszer automatikusan fűz hozzá.
Példa:
|
styleId |
Kötelező Megadja az oldalon megjelenő hirdetési vagy kapcsolódó keresési egységekre alkalmazandó keresési stílus azonosítóját. További információ a keresési stílusok használatáról. Vegye figyelembe, hogy az adott kérelemhez, hirdetésekhez vagy kapcsolódó keresésekhez beállított styleId paramétert a stílussal együtt rendereli a rendszer, a régi stílusparamétereket pedig figyelmen kívül hagyja. Ha a styleId nincs megadva a kérelemben, a rendszer alapértelmezett stílusa jelenik meg. Példa
|
Nem kötelező
Paraméter | Leírás és példák |
---|---|
linkTarget |
Nem kötelező Azt határozza meg, hogy a hirdetésre leadott kattintás esetén az oldal ugyanabban az ablakban vagy egy új ablakban nyíljon-e meg. Az alapértelmezett érték a „_top”. Ez a paraméter az egység szintjén is használható.
Példa: 'linkTarget' : '_blank' |
maxTermLength |
Nem kötelező Meghatározza a kapcsolódó keresőkifejezés maximális karakterszámát (szóközökkel együtt). Ha nincs beállítva, nincs felső korlát. Példa: 'maxTermLength' : 50 |
referrerAdCreative |
Nem kötelező Ha egy felhasználó úgy jut el az Ön Kapcsolódó keresés a tartalomhoz-egységet megjelenítő tartalomoldalára, hogy egy olyan hirdetésre vagy linkre kattint, amely az Ön felügyelete alatt áll, akkor ennek a paraméternek az értékeként pontosan az érintett hirdetés vagy link szövegét kell megadni. A paraméter használatára az alábbi irányelvek vonatkoznak:
Példák: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Nem kötelező Meghatározza a keresési találatoldalon szereplő keresőkifejezés URL-paraméterének a nevét. Ha nincs megadva, az alapértelmezett értéke „q”. Példa: 'resultsPageQueryParam' : 'query' |
terms |
Nem kötelező Ez a paraméter lehetővé teszi, hogy vesszővel tagolt listaként megadja a saját kapcsolódó keresőkifejezéseit, amelyeket a rendszernek a kapcsolódó keresési kérelemmel együtt kell visszaadnia. Előfordulhat azonban, hogy a Google nem használja az itt megadott kifejezéseket. Példa: 'terms' : 'cars rental, flight ticket' |
Konfigurációs beállítások
Paraméter | Leírás és példák | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Nem kötelező Megadja azokat a szűrési szabályokat, amelyeket a Google-nak a keresőkifejezésnek megfelelő hirdetésekre alkalmaznia kell. Az alábbiakban az adsafe érvényes beállításai és az egyes értékek visszaadott hirdetésekre gyakorolt hatása látható:
Megjegyzés: Alapértelmezés szerint az
adsafe beállítása „high”.Példa: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Nem kötelező Az adtest paraméter annak jelzésére szolgál, hogy az adott hirdetési kérelem egy teszt. Ha az adtest paraméter értéke „on”, a Google a kérelmet tesztnek tekinti, és nem számítja hirdetésmegjelenítésként, illetve nem követi nyomon az átkattintási eredményeket.
Ha az Megjegyzés: A paramétert használhatja tesztelés során, azonban éles rendszerekben ne, különben nem kap fizetséget a megjelenített hirdetésekért.
Az adtest alapértelmezett értéke „off”. Példa: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Nem kötelező Megadhat egy AdSense Kereséshez-csatornát a különböző oldalak teljesítményének követése céljából. Használja az AdSense-fiókban előállított egyedi csatornaazonosítót. További információ a hirdetések teljesítményének egyéni csatornákkal történő követéséről. Ha több csatornát ad meg, válassza el őket „+” jellel. Példák: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Nem kötelező Ez a paraméter adja meg azt a nyelvet, amelyet a kérelmezett hirdetéseknek meg kell célozniuk. Az alapértelmezett érték az „en” (angol). A Google a Google Ads API összes nyelvkódját támogatja. Megjegyzés: A hirdetők megadják, hogy a hirdetéseik milyen nyelveket céloznak meg. Ha a kérelemben ezt a paramétert is megadja, a Google csak az adott nyelvre vagy az összes nyelvre célzott hirdetéseket adja vissza, de nem garantálja, hogy a hirdetés szövege a megadott nyelvű lesz.
Általában a Példák: 'hl' : 'hu' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Nem kötelező
Az Az
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Nem kötelező
Az Az
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Nem kötelező Megadja, hogy a felhasználók beleegyeztek-e abba, hogy a megjelenítő megossza személyes adataikat a Google-lal személyre szabott hirdetések megjelenítése céljából.
Megjegyzés: Alapértelmezés szerint a
personalizedAds beállítása „true”.Példa: 'personalizedAds': false |
Az egységszintű paraméterek leírása
Ezek a paraméterek azt befolyásolják, hogy az oldalon lévő egyes hirdetési egységek hogyan jelennek meg a felhasználóknál. Minden paramétert egyenként be lehet állítani az egyes hirdetési egységeknél.
Kötelező
Paraméter | Leírás és példák |
---|---|
container |
Kötelező Annak az üres hirdetéstárolónak ( <div id='afscontainer1'></div> ) az azonosítója, ahol a hirdetésnek meg kell jelennie.
Példa:
|
maxTop |
Kötelező
Ezzel a paraméterrel lehet megadni, hogy hány hirdetés jelenjen meg a felső hirdetési egységen. Megjegyzés: A rendszer ezt a paramétert használja a
number paraméter helyett. A hirdetési egységnek elég szélesnek kell lennie ahhoz, hogy a hirdetések első sora elférjen benne. A maxTop paraméternek az oldal bármely más elhelyezésénél történő használata az irányelv megsértésének minősül.Példa:
|
width |
Kötelező Meghatározza a hirdetési egység vagy a kapcsolódó keresési egység szélességét képpontban. Példák: 'width' : '700px' 'width' : 700 |
Konfigurációs beállítások
Paraméter | Leírás és példák | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Nem kötelező Azt a JavaScript-függvényt adja meg, amelyet a hirdetések vagy a kapcsolódó keresések betöltésekor, illetve akkor kell betölteni, amikor a rendszer nem jelenít meg hirdetéseket vagy kapcsolódó kereséseket. Olyan JavaScript-visszahívási függvényt kell megadni paraméterként, amelyet úgy implementált, hogy lehetővé tegye egy művelet végrehajtását a hirdetéshívás befejeződésekor. A callback függvény az alábbi paramétereket fogadja el:
Megjegyzés: Kérjük, ellenőrizze, hogy a callback függvény nem okoz-e hibákat, különösen olyanokat, amelyek zavarhatják az oldal betöltését.
Példa JavaScript-visszahívásra: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // Valószínűleg nem csinál semmit } catch (e) { alert ("Error in callback function"); // Teendő a hiba elegáns kezeléséhez } } else { // Amit mindig csinálunk, amikor a Google nem biztosít hirdetéslefedettséget } } }; |
||||||||
number |
Nem kötelező Az egységben megjelenítendő hirdetések száma. Az alapértelmezett érték 2. Példa:
|
||||||||
relatedSearches |
Nem kötelező Az ebben az egységben megjelenítendő kapcsolódó keresések száma. Ez a paraméter legalább három kapcsolódó keresést jelenít meg, hacsak nincs nullára állítva. Ha nincs megadva, az alapértelmezett értéke 0. Példa: 'relatedSearches' : 4 |