Pieredzējušiem lietotājiem esam sagatavojuši sarakstu ar pašreiz atbalstītajiem meklēšanas stila parametriem. Programmā AdSense ģenerētajā kodā ir ietverti visi visbiežāk izmantoto parametru iestatījumi. Ir divi obligātie parametri: pubId
un query
. AdSense nodrošina parametru “pubId”, taču jums ir jārediģē kods un jānosūta parametra query
vērtība. Visi pārējie parametri nav obligāti un ir aprakstīti tālāk.
Parametru tipi
Ir divi parametru tipi:
- lapas līmeņa parametri, kas tiek lietoti visām lapā esošajām reklāmu vienībām;
- vienības līmeņa parametri, kas tiek lietoti atsevišķām reklāmu vienībām.
Tālāk ir parādīts kodu ģeneratora veidots paraugs ar diviem reklāmu blokiem. Lai konfigurētu šo kodu, jums ir jāiestata obligātais parametrs query
funkcijā pageOptions
(piemēram, “query”: myQuery
). Tas ir viss, kas nepieciešams reklāmu rādīšanai. Varat arī iestatīt neobligātos lapas līmeņa parametrus lapas līmeņa blokā un atsevišķus vienības līmeņa parametrus funkcijās adblock1
un adblock2
.
<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>
Lapas līmeņa parametru apraksts
Šie parametri katrā lapā jānorāda tikai vienu reizi. Tie ietekmē visas lapā izvietotās reklāmu vienības.
Obligāti
Parametrs | Apraksts un piemēri |
---|---|
adPage |
Nepieciešams, kad lietotājs pāriet uz nākamo rezultātu lapu vai iepriekšējo rezultātu lapu.
Parametrs |
pubId |
Obligāts Šis ir jūsu AdSense Client-ID. Jūsu “pubId” ir tā Client-ID daļa, kas norādīta aiz “partner-”. Piemēram, ja jūsu Client-ID ir “partner-test-property”, jūsu “pubId” ir “test-property”. Šis ir pielāgoto meklēšanas reklāmu standarta protokols. Piemērs 'pubId': 'test-property' |
query |
Obligāts Šis ir lietotāja ievadītais meklēšanas vaicājums. Vaicājuma parametra vērtībai jābūt nešifrētai. Piemēri
|
resultsPageBaseUrl |
Obligāts, ja lapā ir saistītas meklēšanas vaicājumi Norāda tās meklēšanas rezultātu lapas URL, kurā meklēšanas vaicājums ir saistītais meklēšanas vaicājums, uz kura noklikšķināja lietotājs. Parametram resultsPageBaseUrl var būt savi parametri, izņemot meklēšanas vaicājumu, kas tiks pievienots automātiski.
Piemērs
|
styleId |
Obligāts Norāda meklēšanas stila ID, kas tiks lietots reklāmai vai saistītajiem meklēšanas vaicājumiem lapā. Uzziniet vairāk par meklēšanas stilu izmantošanu. Ņemiet vērā: ja pieprasījumam ir iestatīts parametrs “styleId”, reklāmas vai saistītie meklēšanas vaicājumi tiks atveidoti, izmantojot attiecīgo stilu, savukārt mantotie stila parametri tiks ignorēti. Ja pieprasījumā nav norādīts parametrs “styleId”, tiks atveidots sistēmas noklusējuma stils. Piemērs
|
Neobligāti
Parametrs | Apraksts un piemēri |
---|---|
linkTarget |
Neobligāts Norāda, vai, noklikšķinot uz reklāmas, tiek atvērts tas pats vai jauns logs. Noklusējuma vērtība ir “_top”. Šo parametru var izmantot arī vienības līmenī.
Piemērs 'linkTarget' : '_blank' |
maxTermLength |
Neobligāts Norāda maksimālo saistītā meklēšanas vienuma rakstzīmju skaitu, ieskaitot atstarpes. Ja šis parametrs nav iestatīts, nav norādīts maksimālais skaits. Piemērs 'maxTermLength' : 50 |
referrerAdCreative |
Neobligāts Ja lietotājs atver jūsu satura lapu, kurā ir ietverta saistītā meklēšanas vaicājuma vienība satura lapām, noklikšķinot uz reklāmas vai saites citā tīmekļa vietnē, un jūs pārvaldāt šo reklāmu vai saiti, šim parametram ir precīzi jāatbilst attiecīgās saites vai reklāmas materiālu tekstam. Uz šī parametra lietošanu attiecas tālāk norādītās vadlīnijas.
Piemēri 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Neobligāts Norāda URL parametra nosaukumu meklēšanas vaicājumam meklēšanas rezultātu lapā. Ja nav norādīts, noklusējuma iestatījums ir “q”. Piemērs 'resultsPageQueryParam' : 'query' |
terms |
Neobligāts Izmantojot šo parametru, varat komatatdalīt sarakstu ar saviem saistītajiem meklēšanas vaicājumiem, lai tos atgrieztu ar saistīta meklēšanas vaicājuma pieprasījumu, lai gan Google var izmantot vai neizmantot šeit norādītos vaicājumus. Piemērs 'terms' : 'cars rental, flight ticket' |
Konfigurācijas iestatījumi
Parametrs | Apraksts un piemēri | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Neobligāts Norāda filtrēšanas kārtulas, kuras Google sistēmai jālieto reklāmām, kas atbilst meklēšanas vaicājumam. Tālāk ir norādīti adsafe derīgie iestatījumi un katras vērtības ietekme uz parādītajām reklāmām.
Piezīme. Parametra
adsafe noklusējuma vērtība ir “high”.Piemērs 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Neobligāts Parametrs adtest tiek izmantots, lai norādītu, ka reklāmu pieprasījums ir tests. Ja parametra adtest vērtība ir “on”, Google apstrādā pieprasījumu kā testu un neuzskaita reklāmu seansus, kā arī neizseko pārejas klikšķu rezultātus.
Ja parametra Piezīme. Izmantojiet šo parametru testēšanai, taču nelietojiet to produkcijas sistēmās, jo tad nesaņemsiet samaksu par rādītajām reklāmām.
Parametra “adtest” noklusējuma vērtība ir “off”. Piemērs 'adtest': 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Neobligāts Lai izsekotu dažādu lapu veiktspēju, varat iekļaut programmas “AdSense meklēšanai” kanālu. Izmantojiet unikālo kanāla ID, kas izveidots AdSense kontā. Uzziniet vairāk par reklāmu veiktspējas izsekošanu, izmantojot pielāgotus kanālus. Vairāku kanālu atdalīšanai izmantojiet simbolu “+”. Piemēri 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Neobligāts Šis parametrs nosaka pieprasīto reklāmu mērķauditorijas valodu. Noklusējuma vērtība ir “en”. Google atbalsta visus Google Ads API valodu kodus. Piezīme. Reklāmdevēji norāda savu reklāmu mērķauditorijas valodas. Ja pieprasījumā iekļausiet šo parametru, Google parādīs tikai reklāmas, kas paredzētas konkrētajai valodai vai visām valodām, taču negarantēs, ka reklāmas teksts būs norādītajā valodā.
Parasti ieteicams iestatīt parametru Piemēri 'hl': 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Neobligāts
Parametrs Parametra
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Neobligāts
Parametrs Parametra
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Neobligāts Norāda, vai lietotāji izdevējam ir snieguši atļauju kopīgot personas informāciju ar uzņēmumu Google personalizētas reklamēšanas nolūkos.
Piezīme. Parametra
personalizedAds noklusējuma vērtība ir “true”.Piemērs 'personalizedAds': false |
Vienības līmeņa parametru apraksti
Šie parametri ietekmē veidu, kā atsevišķās reklāmu vienības tiek parādītas lietotājam. Katru parametru var iestatīt atsevišķi katrai reklāmu vienībai.
Obligāti
Parametrs | Apraksts un piemēri |
---|---|
container |
Obligāts Tā tukšā reklāmu konteinera <div id='afscontainer1'></div> ID, kurā jārāda reklāma.
Piemērs
|
maxTop |
Obligāts
Izmantojiet šo parametru, lai norādītu, cik reklāmu var rādīt augšējā reklāmu vienībā. Piezīme. Šis parametrs tiek izmantots parametra
number vietā. Reklāmu vienībai jābūt pietiekami platai, lai reklāmu pirmā rindiņa netiktu aplauzta. Ja izmantosiet parametru maxTop jebkurā citā lapas izvietojumā, tas tiks uzskatīts par politikas pārkāpumu.Piemērs
|
width |
Obligāts Norāda reklāmu vienības vai saistītā meklēšanas vaicājums platumu pikseļos. Piemēri 'width' : '700px' 'width' : 700 |
Konfigurācijas iestatījumi
Parametrs | Apraksts un piemēri | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Neobligāts Norāda JavaScript funkciju, kas jāizsauc, kad ir ielādētas reklāmas vai saistītie meklēšanas vaicājumi vai kad netiek rādītas reklāmas vai saistītie meklēšanas vaicājumi. Parametram jāiestata jūsu ieviestā JavaScript atzvanīšanas funkcija, kas ļauj veikt darbību, kad reklāmas izsaukums ir pabeigts. Atzvanīšanas funkcijai ir nepieciešami tālāk norādītie parametri.
Piezīme. Lūdzu, pārbaudiet atzvanīšanas funkcijas darbību, lai nodrošinātu, ka tā neģenerē kļūdas, īpaši tādas, kas var traucēt lapas ielādi.
JavaScript atzvanīšanas piemērs: 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 } } }; |
||||||||
number |
Neobligāts Reklāmu skaits, kas jārāda šajā vienībā. Noklusējuma vērtība ir “2”. Piemērs
|
||||||||
relatedSearches |
Neobligāts To saistīto meklēšanas vaicājumu skaits, kas jārāda šajā vienībā. Šis parametrs atgriež vismaz trīs saistītus meklēšanas vaicājumus, ja vien nav iestatīta nulles vērtība. Ja nav norādīts, noklusējuma iestatījums ir 0. Piemērs 'relatedSearches' : 4 |