Pažengusiems naudotojams pateikiame šį šiuo metu palaikomų paieškos skelbimų stiliaus parametrų sąrašą. Kodas, kurį sugeneruojate sistemoje „AdSense“, apima visus dažniausiai naudojamų parametrų nustatymus. Yra du būtini parametrai: pubId
ir query
. „AdSense“ pateikia „pubId“, bet turite redaguoti kodą ir priskirti parametro query
vertę. Visi kiti parametrai pasirenkami ir aprašyti toliau.
Parametrų tipai
Yra dviejų tipų parametrai.
- Puslapio lygio parametrai, kurie taikomi visiems skelbimų rinkiniams puslapyje.
- Rinkinio lygio parametrai, kurie taikomi individualiems skelbimų rinkiniams.
Pateikiama pavyzdinė kodų generatoriaus išvestis su dviem skelbimų blokais. Kad sukonfigūruotumėte šį kodą, funkcijos pageOptions
schemoje turite nustatyti reikiamą parametrą query
(pvz., “query”: myQuery
). Tai viskas, ką reikia atlikti, norint pradėti rodyti skelbimus. Galite nustatyti pasirenkamus puslapio lygio parametrus puslapio lygio bloke ir atskirus rinkinio lygio parametrus funkcijų adblock1
ir adblock2
schemose.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Puslapio lygio parametrai
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Rinkinio lygio parametrai
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Puslapio lygio parametrų aprašai
Šiuos parametrus reikia nurodyti tik vieną kartą puslapyje. Jie turi įtakos visiems rinkiniams puslapyje.
Būtinas
Parametras | Aprašas ir pavyzdžiai |
---|---|
adPage |
Būtinas, kai naudotojas pereina į kitą arba į ankstesnį rezultatų puslapį.
Parametras |
pubId |
Būtinas Tai yra jūsų „AdSense“ „Client-ID“. „pubId“ yra „Client-ID“ dalis, pateikiama po „partner-“. Pvz., jei „Client-ID“ yra „partner-test-property“, „pubId“ bus „test-property“. Tai yra įprastas TPS protokolas. Pavyzdys: 'pubId' : 'test-property' |
query |
Būtinas Tai yra naudotojo įvesta paieškos užklausa. Užklausos parametro vertė turi būti neužkoduota. Pavyzdžiai:
|
resultsPageBaseUrl |
Būtinas, kai puslapyje yra susijusios paieškos rinkinių Nurodo paieškos rezultatų puslapio, kuriame paieškos užklausa yra naudotojo spustelėtas susijusios paieškos terminas, URL. Į resultsPageBaseUr galima įtraukti nuosavus parametrus, išskyrus paieškos užklausą, kuri pridedama automatiškai.
Pavyzdys:
|
styleId |
Būtinas Nurodo paieškos skelbimų stiliaus, kuris turi būti taikomas skelbimui ar susijusios paieškos rinkiniams puslapyje, ID. Sužinokite daugiau apie paieškos skelbimų stiliaus naudojimą. Atminkite, kad užklausoje nustačius parametrą „styleId“, skelbimai ar susijusios paieškos pateikiami taikant stilių, o pasenusių stiliaus parametrų nepaisoma. Jei parametras „styleId“ užklausoje nenurodytas, taikomas numatytasis sistemos stilius. Pavyzdys
|
Nebūtinas
Parametras | Aprašas ir pavyzdžiai |
---|---|
linkTarget |
Nebūtinas Nurodo, ar paspaudus skelbimą nuoroda atidaroma tame pačiame ar naujame lange. Numatytoji vertė yra „_top“. Šį parametrą taip pat galima naudoti rinkinio lygiu.
Pavyzdys: 'linkTarget' : '_blank' |
maxTermLength |
Nebūtinas Nurodo didžiausią susijusios paieškos termino simbolių, įskaitant tarpus, skaičių. Jei nenustatytas, maksimali vertė netaikoma. Pavyzdys: 'maxTermLength' : 50 |
referrerAdCreative |
Nebūtinas Jei naudotojas į jūsų turinio puslapį, kuriame yra susijusios turinio paieškos rinkinys, patenka spustelėjęs skelbimą ar nuorodą kitoje svetainėje, o tą skelbimą ar nuorodą valdote jūs, kaip šio parametro vertė turėtų būti nustatytas to skelbimo failo ar nuorodos tekstas (pažodžiui). Naudojant šį parametrą taikomos toliau nurodytos gairės.
Pavyzdžiai: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Nebūtinas Nurodo paieškos rezultatų puslapio paieškos užklausos URL parametro pavadinimą. Jei nenurodyta, numatytoji vertė yra „q“. Pavyzdys: 'resultsPageQueryParam' : 'query' |
terms |
Nebūtinas Naudodami šį parametrą galite pateikti kableliais atskirtų savo susijusios paieškos terminų sąrašą, kuris bus gautas su susijusios paieškos užklausa, tačiau „Google“ šiuos terminus nebūtinai naudos. Pavyzdys: 'terms' : 'cars rental, flight ticket' |
Konfigūracijos nustatymai
Parametras | Aprašas ir pavyzdžiai | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Nebūtinas Nurodo filtravimo taisykles, kurias „Google“ turėtų taikyti skelbimams, atitinkantiems paieškos užklausą. Toliau pateikiami tinkami adsafe nustatymai ir nurodomas kiekvienos vertės poveikis pateiktiems skelbimams.
Pastaba: numatytoji parametro
adsafe vertė yra „'high'“.Pavyzdys: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Nebūtinas Parametras adtest naudojamas norint nurodyti, kad skelbimų užklausa yra bandomoji. Kai parametro adtest vertė yra „on“, „Google“ laiko užklausą bandymu ir neskaičiuoja skelbimų parodymų bei nestebi perėjimo paspaudimų rezultatų.
Kai parametro Pastabos:
Numatytoji „adtest“ vertė yra „off“. Pavyzdys: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Nebūtinas Galite įtraukti „AdSense“ paieškai kanalą, kad galėtumėte stebėti skirtingų puslapių našumą. Naudokite unikalų kanalo ID, kurį sukūrėte „AdSense“ paskyroje. Sužinokite daugiau apie skelbimų našumo stebėjimą naudojant tinkintus kanalus. Kelis kanalus reikia atskirti „+“ simboliu. Pavyzdžiai: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Nebūtinas Šis parametras nurodo kalbą, pagal kurią turėtų būti taikomi skelbimai, dėl kurių pateikiama užklausa. Numatytoji vertė yra „en“. „Google“ palaiko visus „Google Ads“ API kalbų kodus. Pastaba: reklamuotojai nurodo kalbas, pagal kurias taikomi jų skelbimai. Jei įtrauksite šį parametrą į užklausą, „Google“ pateiks tik skelbimus, kurie taikomi pagal šią kalbą arba pagal visas kalbas, bet negarantuojama, kad skelbimo tekstas bus pateiktas nurodyta kalba.
Įprastai parametrą Pavyzdžiai: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Nebūtinas
Parametras Numatytoji
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Nebūtinas
Parametras Numatytoji
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Nebūtinas Nurodo, ar naudotojai sutiko leisti leidėjui bendrinti asmens informaciją su „Google“ suasmeninto reklamavimo tikslais.
Pastaba: numatytoji parametro
personalizedAds vertė yra „true“Pavyzdys: 'personalizedAds': false |
Rinkinio lygio parametrų aprašai
Šie parametrai daro įtaką tam, kaip individualių skelbimų rinkiniai puslapyje rodomi naudotojui. Kiekvieną parametrą galima nustatyti atskirai kiekvienam skelbimų rinkiniui.
Būtinas
Parametras | Aprašas ir pavyzdžiai |
---|---|
container |
Būtinas Tuščio skelbimo sudėtinio failo <div id='afscontainer1'></div> , kur turėtų būti rodomas skelbimas, ID.
Pavyzdys:
|
Konfigūracijos nustatymai
Parametras | Aprašas ir pavyzdžiai | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Nebūtinas Nurodo „JavaScript“ funkciją, kurią reikia iškviesti, kai įkeliami skelbimai ar susijusios paieškos arba kai skelbimų ar susijusių paieškų nepateikiama. Parametre turėtų būti nustatyta įdiegta „JavaScript“ atskambinimo funkcija, kurią naudojant galima atlikti veiksmą, kai baigiamas kreipinys dėl skelbimo. Atskambinimo funkcijai reikia nurodyti toliau pateiktus parametrus.
Pastaba: patikrindami atskambinimo funkciją įsitikinkite, kad ji negeneruoja klaidų, ypač galinčių trikdyti puslapio įkėlimą.
„JavaScript“ atskambinimo pavyzdys. var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // greičiausiai nieko nereikia daryti } catch (e) { alert ("Error in callback function"); // sklandžiai apdorokite klaidą } } else { // tai, ką visada darote, kai „Google“ nepateikia skelbimų } } }; |
||||||||
maxTop |
Nebūtinas
Naudokite šį parametrą, kad nurodytumėte skelbimų, kurie bus rodomi viršutiniame skelbimų rinkinyje, skaičių. Pastaba: šis parametras naudojamas vietoj parametro
number . Šis skelbimų rinkinys turi būti pakankamai platus, kad pirma skelbimų eilutė nebūtų nukelta. Naudodami parametrą maxTop bet kokioje kitoje puslapio paskirties vietoje pažeisite politiką.Pavyzdys:
|
||||||||
number |
Nebūtinas Skelbimų, kurie turėtų būti rodomi šiame rinkinyje, skaičius. Numatytoji vertė yra 2. Pavyzdys:
|
||||||||
relatedSearches |
Nebūtinas Susijusių paieškų, kurios turėtų būti rodomos šiame rinkinyje, skaičius. Šis parametras pateikia mažiausiai tris susijusias paieškas, nebent bus nustatytas nulis. Jei nenurodyta, numatytoji vertė yra 0. Pavyzdys: 'relatedSearches' : 4 |
||||||||
width |
Būtinas Nurodo skelbimų rinkinio arba susijusios paieškos rinkinio plotį taškais. Pavyzdžiai: 'width' : '700px' 'width' : 700 |