Pre pokročilých používateľov sme pripravili tento zoznam aktuálne podporovaných parametrov štýlu vyhľadávania. Kód, ktorý vygenerujete v službe AdSense, obsahuje všetky najbežnejšie používané nastavenia parametrov. Existujú dva povinné parametre: pubId
a query
. Parameter pubId poskytuje AdSense. Kód však musíte upraviť a odovzdať hodnotu parametra query
. Všetky ostatné parametre sú voliteľné a sú vysvetlené nižšie.
Typy parametrov
Existujú dva typy parametrov:
- parametre na úrovni stránky, ktoré sa vzťahujú na všetky reklamné jednotky na stránke;
- parametre na úrovni jednotky, ktoré sa vzťahujú na jednotlivé reklamné jednotky.
Tu je príklad výstupu z generátora kódu s dvoma reklamnými blokmi. Ak chcete konfigurovať tento kód, musíte nastaviť povinný parameter query
v mape pageOptions
(napr. “query”: myQuery
). To je jediný krok, ktorý musíte urobiť, ak chcete začať zobrazovať reklamy. Okrem toho v bloku na úrovni stránky môžete nastaviť nepovinné parametre na úrovni stránky a v mapách adblock1
a adblock2
môžete nastaviť parametre na úrovni jednotlivých jednotiek.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Parametre na úrovni stránky
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parametre na úrovni jednotky
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Opis parametrov na úrovni stránky
Tieto parametre stačí špecifikovať na každej stránke len raz. Majú vplyv na všetky jednotky na stránke.
Povinné
Parameter | Opis a príklady |
---|---|
adPage |
Vyžaduje sa, keď používateľ prejde na nasledujúcu alebo predchádzajúcu stránku s výsledkami
Parameter |
pubId |
Povinné Toto je váš identifikátor Client‑ID v službe AdSense. Identifikátor pubId je časť identifikátora Client‑ID, ktorý nasleduje za reťazcom „partner-“. Ak je váš identifikátor Client‑ID napríklad „partner-test-property“, identifikátor pubId je „test-property“. Ide o štandardný protokol pre reklamy vo vlastnom vyhľadávaní. Príklad: 'pubId' : 'test-property' |
query |
Povinné Toto je vyhľadávací dopyt zadaný používateľom. Hodnota parametra dopytu by nemala byť kódovaná. Príklady:
|
resultsPageBaseUrl |
Povinné, ak sa na stránke nachádzajú jednotky súvisiaceho vyhľadávania Určuje webovú adresu stránky s výsledkami vyhľadávania, na ktorej je vyhľadávací dopyt súvisiaci s vyhľadávacím dopytom, na ktorý používateľ klikol. Parameter resultsPageBaseUrl môže zahŕňať vlastné parametre okrem vyhľadávacieho dopytu, ktorý bude pripojený automaticky.
Príklad:
|
styleId |
Povinné Určuje identifikátor štýlu vyhľadávania, ktorý sa použije pre reklamu alebo súvisiace jednotky vyhľadávania na stránke. Prečítajte si viac o používaní štýlov vyhľadávania. Upozorňujeme, že ak je pre žiadosť nastavený parameter styleId, reklamy a súvisiace vyhľadávania sa vykreslia pomocou nastaveného štýlu a staré parametre štýlu sa budú ignorovať. Ak v žiadosti nie je uvedený parameter styleId, pri vykresľovaní sa použije štýl predvolený systémom. Príklad
|
Nepovinné
Parameter | Opis a príklady |
---|---|
linkTarget |
Nepovinné Určuje, či sa po kliknutí na reklamu odkaz otvorí v rovnakom alebo novom okne. Predvolená hodnota je _top. Tento parameter môžete použiť aj na úrovni jednotky.
Príklad: 'linkTarget' : '_blank' |
maxTermLength |
Nepovinné Určuje maximálny počet znakov súvisiaceho vyhľadávacieho dopytu vrátane medzier. Ak parameter nie je nastavený, počet znakov nie je obmedzený. Príklad: 'maxTermLength' : 50 |
referrerAdCreative |
Nepovinné Ak používateľ prejde na vašu stránku s obsahom, na ktorej sa nachádza jednotka súvisiaceho vyhľadávania pre obsah kliknutím na reklamu alebo odkaz na inom webe, a túto reklamu alebo odkaz ovládate, tento parameter by mal byť nastavený na text kreatívy danej reklamy alebo odkazu. Na používanie tohto parametra sa vzťahujú nasledujúce pokyny:
Príklady: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Nepovinné Určuje názov parametra webovej adresy pre vyhľadávací dopyt na stránke s výsledkami vyhľadávania. Ak parameter nie je zadaný, použije sa predvolená hodnota q. Príklad: 'resultsPageQueryParam' : 'query' |
terms |
Nepovinné Tento parameter vám umožňuje poskytnúť zoznam vlastných súvisiacich vyhľadávacích dopytov oddelených čiarkou, ktoré sa vrátia ako odpoveď na žiadosť o súvisiace vyhľadávanie, hoci Google ich môže, ale nemusí použiť. Príklad: 'terms' : 'cars rental, flight ticket' |
Nastavenia konfigurácie
Parameter | Opis a príklady | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Nepovinné Špecifikuje pravidlá filtrovania, ktoré by mal Google uplatňovať na reklamy, ktoré vyhovujú vyhľadávaciemu dopytu. Uvádzame platné nastavenia parametra adsafe a vplyv jednotlivých hodnôt na vrátené reklamy:
Poznámka: Parameter
adsafe je predvolene nastavený na hodnotu high.Príklad: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Nepovinné Parameter adtest indikuje, že žiadosť o reklamy predstavuje test. Keď má parameter adtest hodnotu on, Google spracúva žiadosť ako test a nepočíta zobrazenia reklamy ani nesleduje výsledky prekliknutí.
Keď má parameter Poznámka: Tento parameter slúži na testovanie. Nepoužívajte ho však v produkčných systémoch. Za reklamy, ktoré zobrazujete, inak nedostanete zaplatené.
Predvolená hodnota parametra adtest je off. Príklad: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Nepovinné Môžete zahrnúť kanál AdSense pre vyhľadávanie a sledovať tak výkonnosť rôznych stránok. Použite jedinečný identifikátor kanála, ktorý ste si vytvorili v účte AdSense. Prečítajte si viac o sledovaní výkonnosti reklám pomocou vlastných informačných kanálov. Ak používate viaceré kanály, mali by byť oddelené symbolom +. Príklady: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Nepovinné Tento parameter určuje jazyk, na ktorý by mali požadované reklamy zacieľovať. Predvolená hodnota je en. Google podporuje všetky kódy jazykov rozhrania Google Ads API. Poznámka: Inzerenti určujú jazyky, na ktoré sú ich reklamy zacielené. Ak do svojej žiadosti zahrniete tento parameter, Google vráti len reklamy, ktoré sú zacielené na daný jazyk alebo ktoré sú zacielené na všetky jazyky, no nezaručuje, že reklamný text bude v špecifikovanom jazyku.
Parameter Príklady: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Nepovinné
Parameter Predvolená hodnota parametra
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Nepovinné
Parameter Predvolená hodnota parametra
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Nepovinné Špecifikuje, či používatelia súhlasili s tým, že vlastník môže s Googlom zdieľať osobné údaje na účely prispôsobenej reklamy.
Poznámka: Parameter
personalizedAds je predvolene nastavený na true.Príklad: 'personalizedAds': false |
Opis parametrov na úrovni jednotky
Tieto parametre ovplyvňujú spôsob, akým sa jednotlivé reklamné jednotky na stránke zobrazujú používateľovi. Jednotlivé parametre možno nastaviť pre každú reklamnú jednotku osobitne.
Povinné
Parameter | Opis a príklady |
---|---|
container |
Povinné Identifikátor prázdneho reklamného kontajnera <div id='afscontainer1'></div> , v ktorom by sa mala zobraziť reklama.
Príklad:
|
maxTop |
Povinné
Pomocou tohto parametra špecifikujte počet reklám, ktoré sa majú zobraziť v hornej reklamnej jednotke. Poznámka: Tento parameter sa používa namiesto parametra
number . Táto reklamná jednotka by mala byť dostatočne široká, aby sa prvý riadok reklám nezalamoval. Použitie parametra maxTop v akomkoľvek inom umiestnení na stránke je porušením pravidiel.Príklad:
|
width |
Povinné Špecifikuje šírku reklamnej jednotky alebo jednotky súvisiaceho vyhľadávania v pixeloch. Príklady: 'width' : '700px' 'width' : 700 |
Nastavenia konfigurácie
Parameter | Opis a príklady | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Nepovinné Špecifikuje funkciu jazyka JavaScript, ktorá sa zavolá po načítaní reklám alebo súvisiacich vyhľadávaní, prípadne ak sa nezobrazia žiadne reklamy alebo súvisiace vyhľadávania. Parameter by mal byť nastavený na implementovanú funkciu spätného volania v jazyku JavaScript, ktorá umožňuje vykonať akciu po dokončení žiadosti o reklamu. Funkcia spätného volania má tieto parametre:
Poznámka: Otestujte funkciu spätného volania a uistite sa, že negeneruje žiadne chyby, najmä tie, ktoré by mohli narušiť načítanie stránky.
Príklad spätného volania v jazyku JavaScript: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // Pravdepodobne nemusíte robiť nič } catch (e) { alert ("Error in callback function"); // Spravte niečo, aby ste vyriešili chybu } } else { // Spravte to, čo vždy, keď nemáte reklamy pokryté Googlom } } }; |
||||||||
number |
Nepovinné Počet reklám, ktoré by sa mali zobraziť v tejto jednotke. Predvolená hodnota je 2. Príklad:
|
||||||||
relatedSearches |
Nepovinné Počet súvisiacich vyhľadávaní, ktoré by sa mali zobraziť v tejto jednotke. Tento parameter vráti minimálne tri súvisiace vyhľadávania, pokiaľ nie je nastavený na nulu. Ak nenastavíte žiadnu hodnotu, predvolene sa použije 0. Príklad: 'relatedSearches' : 4 |