Tähän artikkeliin on koottu keskeiset tiedot parametreista, jotka ovat tuettuja hakumainostyyleissä. AdSensessa luotava koodi sisältää kaikki useimmin käytetyt parametriasetukset. Pakolliset parametrit ovat pubId ja query. Saat pubId:n AdSenselta, mutta sinun on muokattava koodia ja syötettävä arvo query-parametrille. Kaikki muut parametrit ovat valinnaisia, ja ne on kuvattu alla.
Parametrityypit
Parametreja on kahdenlaisia:
- sivutason parametrit, jotka koskevat sivun kaikkia mainosyksiköitä
- yksikkötason parametrit, jotka koskevat yksittäisiä mainosyksiköitä.
Jäljempänä on koodigeneraattorin luoma esimerkki, joka sisältää kaksi mainoskoodinpätkää. Tämän koodin määrittämiseksi sinun on lisättävä vaadittava query-parametri pageOptions-funktioon (esim. “query”: myQuery). Tässä kaikki, mitä tarvitaan, jotta mainokset voivat alkaa näkyä. Voit myös halutessasi lisätä mainoskoodiin valinnaisia parametreja sivutasolle tai yksittäisiä parametreja adblock1- ja adblock2-funktioihin yksikkötasolle.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Sivutason parametrien kuvaukset
Nämä parametrit tarvitsee määrittää vain kerran kullakin sivulla. Ne vaikuttavat sivun kaikkiin mainosyksiköihin.
Pakollinen
| Parametri | Kuvaus ja esimerkkejä |
|---|---|
adPage |
Pakollinen, jos käyttäjä siirtyy seuraavalle tai edelliselle hakutulossivulle.
|
pubId |
Pakollinen Tämä on AdSense-asiakastunnuksesi. PubId on asiakastunnuksesi osa, joka tulee merkkijonon "partner-" jälkeen. Jos asiakastunnuksesi on esimerkiksi "partner-test-property", pubId on "test-property". Tämä on Custom Search ‑mainosten vakioprotokolla. Esimerkki: 'pubId' : 'test-property' |
query |
Pakollinen Tämä on käyttäjän käyttämä hakulauseke. Kyselyparametrin ("query") arvo on purettava. Esimerkkejä:
|
referrerAdCreative |
Pakollinen (jos liikennettä hankitaan) Jos käyttäjä tulee samantyyppisen hakuyksikön sisältävälle sisältösivullesi hallinnassasi olevasta lähteestä (mukaan lukien kolmannen osapuolen verkosto, palvelu tai kumppani), tämän parametrin arvoksi on asetettava kyseisen lähteen mainosaineistoteksti. Seuraavat ohjeet koskevat tämän parametrin käyttöä:
Huom. Tämä parametri on pakollinen, kun
terms-parametri on käytössä.Esimerkkejä: 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageBaseUrl |
Pakollinen, jos sivulla on samantyyppisiä hakuyksiköitä Määrittää sen hakutulossivun URL-osoitteen, jolla oleva hakulauseke on samantyyppinen kuin hakutermi, jota käyttäjä on klikannut. resultsPageBaseUr saattaa sisältää omia parametreja. Hakulauseke liitetään kuitenkin automaattisesti.
Esimerkki:
|
styleId |
Pakollinen Määrittää sen hakumainostyylin tunnuksen, jota käytetään sivun mainosyksiköissä tai samantyyppisissä hakuyksiköissä. Lue lisää hakumainostyylien käyttämisestä. Huomaa, että jos pyynnölle valitaan styleId-parametri, mainokset tai samantyyppiset haut renderöidään käyttämällä kyseistä tyyliä ja vanhat tyyliparametrit jätetään huomiotta. Jos pyynnölle ei valita styleId-parametria, renderöinnissä käytetään järjestelmän oletustyyliä. Esimerkki
|
Valinnainen
| Parametri | Kuvaus ja esimerkkejä |
|---|---|
linkTarget |
Valinnainen Määrittää, avautuuko mainos samaan vai uuteen ikkunaan, kun mainosta klikataan. Oletusarvo on "_top". Tätä parametria voidaan käyttää myös yksikkötasolla.
Esimerkki: 'linkTarget' : '_blank' |
maxTermLength |
Valinnainen Määrittää samankaltaisen hakutermin merkkien enimmäismäärän, mukaan lukien välilyönnit. Jos parametria ei valita, enimmäismäärää ei ole. Esimerkki: 'maxTermLength' : 50 |
resultsPageQueryParam |
Valinnainen Määrittää hakulausekkeen URL-parametrin nimen hakutulossivulla. Oletusarvo on "q". Esimerkki: 'resultsPageQueryParam' : 'query' |
terms |
Valinnainen Tämän parametrin avulla voit toimittaa pilkuilla erotellun listan omista samantyyppisistä hakutermeistä, jotka samantyyppinen hakupyyntö lähettää. Google voi käyttää tai olla käyttämättä listan hakutermejä. Esimerkki: 'terms' : 'cars rental, flight ticket' |
Määritysasetukset
| Parametri | Kuvaus ja esimerkkejä | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Valinnainen Määrittää suodatussäännöt, joita Googlen tulee käyttää hakulauseketta vastaavissa mainoksissa. Seuraavassa esitetään adsafe-parametrin hyväksytyt asetukset ja kerrotaan, miten kukin arvo vaikuttaa palautettuihin mainoksiin:
Huom.
adsafe-parametrin oletusarvo on "high".Esimerkki: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Valinnainenadtest-parametrilla osoitetaan, että mainospyyntö on testi. Jos adtest-parametrin arvo on "on", Google pitää pyyntöä testinä eikä laske mainosimpressioita tai seuraa klikkaustuloksia.
Jos Hyvä huomata:
Adtest-parametrin oletusarvo on "off". Esimerkki: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Valinnainen Voit lisätä AdSense for Search ‑kanavan, jos haluat seurata eri sivujen tuloksia. Käytä yksilöllistä kanavatunnusta, jonka olet luonut AdSense-tililläsi. Lue lisää mainostulosten seuraamisesta omien kanavien avulla. Kanavat on erotettava toisistaan plusmerkillä (+). Esimerkkejä: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Valinnainen Tämä parametri määrittää kielen, jota käytetään pyydettyjen mainosten kohdistuksessa. Oletusarvo on "en". Google tukee kaikkia Google Ads APIn kielikoodeja. Huom. Mainostajat määrittävät kielen, johon heidän mainoksensa kohdistetaan. Jos sisällytät pyyntöösi tämän parametrin, Google palauttaa ainoastaan mainoksia, jotka on kohdistettu kyseiseen kieleen tai kaikkiin kieliin. Tämä ei kuitenkaan takaa, että mainosteksti olisi kirjoitettu määritetyllä kielellä.
Tyypillisesti Esimerkkejä: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Valinnainen
Tämä Oletusarvoisesti
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Valinnainen
Tämä
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Käytöstä poistettu
Huom. Mainosten personointi on nyt poistettu käytöstä AdSense for Searchissa. Lue lisää: AdSense for search ja muut Hakumainostuotteet, jotka alkavat käyttää uusia verkkotunnuksia mainosten näyttämiseen ja joissa mainosten personointi poistuu käytöstä.
|
Yksikkötason parametrien kuvaukset
Nämä parametrit vaikuttavat siihen, miten sivun yksittäiset mainosyksiköt näkyvät käyttäjälle. Kukin parametri voidaan määrittää erikseen kullekin mainosyksikölle.
Pakollinen
| Parametri | Kuvaus ja esimerkkejä |
|---|---|
container |
Pakollinen Sen tyhjän mainossäilön tunnus <div id='afscontainer1'></div>, jossa haluat mainoksen näkyvän.
Esimerkki: |
Määritysasetukset
| Parametri | Kuvaus ja esimerkkejä | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Valinnainen Määrittää JavaScript-funktion, jota kutsutaan silloin, kun mainokset tai samantyyppiset haut ovat latautuneet tai kun mainoksia tai samantyyppisiä hakuja ei julkaista. Parametrin arvoksi on määritettävä käyttöönottamasi JavaScript-takaisinkutsufunktio, jotta toiminto suoritetaan, kun mainoskutsu on valmis. Takaisinkutsufunktiolla on seuraavat parametrit:
Huom. Testaa vastakutsufunktio ja varmista, että se ei aiheuta virheitä, varsinkaan sellaisia, jotka saattavat vaikuttaa sivun latautumiseen.
Esimerkki JavaScript-vastakutsusta: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // most likely do nothing } catch (e) { alert ("Error in callback function"); // Do something to handle error gracefully } } else { // as you always do when there is no ad coverage from Google } } }; |
||||||||
maxTop |
Valinnainen
Tämän parametrin avulla voit määrittää, kuinka monta mainosta sivun yläosan mainosyksikössä näkyy. Huom. Tätä parametria käytetään
number-parametrin sijasta. Tämän mainosyksikön on oltava tarpeeksi leveä, jotta mainosten ensimmäistä riviä ei tiivistetä. maxTop-parametrin käyttäminen sivun muissa sijoitteluissa katsotaan käytäntörikkomukseksi.Esimerkki: |
||||||||
number |
Valinnainen Tässä mainosyksikössä näkyvien mainosten määrä. Oletusarvo on 2. Esimerkki: |
||||||||
relatedSearches |
Valinnainen Mainosyksikössä näkyvien samantyyppisten hakujen määrä. Parametri palauttaa vähintään kolme samantyyppistä hakua, ellei arvoksi ole asetettu 0. Oletusarvo on 0. Esimerkki: 'relatedSearches' : 4 |
||||||||
width |
Pakollinen Määrittää mainosyksikön tai samantyyppisen hakuyksikön leveyden pikseleinä. Esimerkkejä: 'width' : '700px''width' : 700 |