Paieškos skelbimų parametrų aprašai

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="afscontainer1"></div>
<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ūtini

Parametras	Aprašas ir pavyzdžiai
adPage	Būtinas, kai naudotojas pereina į kitą arba į ankstesnį rezultatų puslapį. Parametras adPage nurodo rezultatų puslapį, kuriame pateikiami skelbimai. Šis parametras naudojamas, kai naudotojai naršo toliau iš pirmo paieškos rezultatų puslapio. Pavyzdžiui, jei pateikiama penkių skelbimų užklausa ir nustatyta parametro adPage vertė 2, gauti penki skelbimai bus rodomi antrame rezultatų puslapyje.
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: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // čia „myQuery“ yra „JavaScript“ kintamasis, kuriame yra paieškos užklausa
referrerAdCreative	Būtinas (jei srautas įgyjamas) Jei naudotojas į jūsų turinio puslapį, kuriame yra susijusios turinio paieškos rinkinys, patenka iš šaltinio, kurį valdote jūs (įskaitant bet kokį trečiosios šalies tinklą, paslaugą ar filialą, su kuriuo bendradarbiaujate), kaip šio parametro vertė turi būti nustatytas to šaltinio skelbimo failo tekstas (pažodžiui). Naudojant šį parametrą taikomos toliau nurodytos gairės. Parametras turi būti pateikiamas tik susijusios turinio paieškos užklausoje. Visose kitose užklausose šio parametro bus nepaisoma. Parametrą reikia naudoti tik tikslingai iš kitų svetainių gaunamame sraute ir nenaudoti natūraliame sraute. Jame turi būti antraštės eilutė, aprašymas, transkribuotas garso įrašo tekstas ir (arba) bet koks kitas tekstas ar garso įrašas, kuris bet kokiu būdu pateikiamas šaltinio skelbimo faile. Bet kokių šaltinio skelbimo faile pateiktų verčių praleidimas (arba papildomų verčių įtraukimas) laikomas šių rašytinių instrukcijų pažeidimu. Jame neskiriamos didžiosios ir mažosios raidės. Leidžiama tinkama UTF-8 koduotė. Palaikomi unikodo simboliai ir diakritiniai ženklai. „Google“ gali naudoti jūsų pateiktą parametrą arba jo nepaisyti. Kai parametras naudojamas, gali būti paveiktas terminų pasirinkimas ir reitingavimas. Pastaba: šis parametras yra būtinas, kai naudojamas parametras terms. Pavyzdžiai: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
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: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
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 'styleId': '1234567890'

Nebūtini

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. '_top': atidaroma tame pačiame lange. '_blank': atidaroma naujame lange. 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
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. 'high' – pateikiami šeimai tinkami skelbimai. Nepateikiami netinkami šeimai ar suaugusiesiems skirto seksualinio turinio skelbimai. 'medium' – pateikiami šeimai tinkami ir netinkami skelbimai. Nepateikiami suaugusiesiems skirto seksualinio turinio skelbimai. 'low' – pateikiami visų tipų skelbimai. 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 adtest vertė yra „on“, negaunate jokių pajamų. Pastabos: Naudokite šį parametrą testuodami, bet nenaudokite jo gamybinės versijos sistemose, nes jums nebus mokama už pateikiamus skelbimus. Skelbimų užklausos, kurių parametro adtest vertė yra „įjungta“, gaunamos iš svetainės, kuri nebuvo patvirtinta Svetainių puslapyje, grąžins skelbimus su perdanga „bandomasis skelbimas“, kurių negalima spustelėti. 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ą hl turėtumėte nustatyti pagrindinei puslapio, iš kurio šis parametras siunčiamas, kalbai. Pavyzdžiai: 'hl' : 'es'
ie	Nebūtinas Parametras ie nustato ženklų koduotės schemą, kurią reikėtų naudoti užklausos eilutei interpretuoti. Numatytoji ie vertė yra „utf-8“. Vertė Įprastas pavadinimas Susijusios palaikomos kalbos latin1 ISO-8859-1 Vakarų Europos (katalonų, danų, olandų, anglų, suomių, prancūzų, vokiečių, indoneziečių, italų, norvegų, portugalų, ispanų, švedų) latin2 ISO-8859-2 Rytų Europos (kroatų, čekų, vengrų, lenkų, rumunų, serbų, slovakų, slovėnų) latin3 ISO-8859-3   latin4 ISO-8859-4 Baltų (estų, latvių, lietuvių) cyrillic ISO-8859-5 Bulgarų, rusų arabų ISO-8859-6   graikų ISO-8859-7 Graikų hebrajų ISO-8859-8 Hebrajų latin5 ISO-8859-9   latin6 ISO-8859-10 Islandų euc-jp EUC-JP Japonų euc-kr EUC-KR Korėjiečių sjis Shift_JIS Japonų big5 Big5 Tradicinė kinų gb GB2312 Supaprastinta kinų k. utf-8 UTF-8 Visos
oe	Nebūtini Parametras oe nustato ženklų koduotės schemą, kurią „Google“ turėtų naudoti skelbimų tekstui koduoti. Nors tai techniškai nėra būtina, vertėtų priskirti vertę šiam parametrui. Numatytoji oe vertė yra „utf-8“. Vertė Įprastas pavadinimas Susijusios palaikomos kalbos latin1 ISO-8859-1 Vakarų Europos (katalonų, danų, olandų, anglų, suomių, prancūzų, vokiečių, indoneziečių, italų, norvegų, portugalų, ispanų, švedų) latin2 ISO-8859-2 Rytų Europos (kroatų, čekų, vengrų, lenkų, rumunų, serbų, slovakų, slovėnų) latin3 ISO-8859-3   latin4 ISO-8859-4 Baltų (estų, latvių, lietuvių) cyrillic ISO-8859-5 Bulgarų, rusų arabų ISO-8859-6   graikų ISO-8859-7 Graikų hebrajų ISO-8859-8 Hebrajų latin5 ISO-8859-9   latin6 ISO-8859-10 Islandų euc-jp EUC-JP Japonų euc-kr EUC-KR Korėjiečių sjis Shift_JIS Japonų gb GB2312 Supaprastinta kinų k. utf-8 UTF-8 Visos
personalizedAds	Nebenaudojama Pastaba: „AdSense“ paieškoje nutrauktas skelbimų suasmeninimo teikimas. Jei reikia daugiau informacijos, peržiūrėkite straipsnį „AdSense“ paieškoje ir kituose paieškos skelbimų produktuose naudojami nauji pateikimo domenai ir nutrauktas skelbimų suasmeninimo teikimas“.

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ūtini

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: 'container' : 'afscontainer1'

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. containerName Skelbimo ar susijusios paieškos rinkinio sudėtinio failo pavadinimas. adsLoaded Nustatoma vertė „true“, kai pateikiamas bent vienas skelbimas ar susijusios paieškos terminas, arba „false“, kai skelbimų ar susijusių paieškų negaunama. isExperimentVariant Nustatoma vertė „true“, jei vykdomas tinkinto stiliaus eksperimentas ir skelbimams pateikti pasirenkamas eksperimento variantas. callbackOptions JSON objektas, kuriame yra toliau nurodyti laukai. termPositions: kai naudojamas susijusios paieškos blokas, objekte yra leidėjo pateiktų terminų elementas map<string, int>, nurodantis šių terminų pozicijas (skaičiuojant nuo nulio) atsakyme. Jei terminas pateikiamas, bet negaunamas, jis elemente „map“ nerodomas. 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ūtini 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: "maxTop": 4
number	Nebūtinas Skelbimų, kurie turėtų būti rodomi šiame rinkinyje, skaičius. Numatytoji vertė yra 2. Pavyzdys: 'number' : 4
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