Para sa mga advanced na user ibinigay namin ang listahang ito ng mga kasalukuyang sinusuportahang parameter ng istilo ng paghahanap. Ang code na binuo mo sa AdSense ay naglalaman ng lahat ng pinakakaraniwang ginagamit na mga setting ng parameter. May dalawang kinakailangang parameter: pubId at query. Ibinibigay ng AdSense ang pubId pero kailangan mong i-edit ang code at mag-pass ng value para sa parameter na query. Ang lahat ng iba pang parameter ay opsyonal at inilalarawan sa ibaba.
Mga uri ng parameter
May dalawang uri ng mga parameter:
- Mga parameter sa antas ng page na nalalapat sa lahat ng unit ng ad sa page.
- Mga parameter sa antas ng unit na nalalapat sa mga indibidwal na unit ng ad.
Narito ang ilang halimbawang output mula sa mga tagabuo ng code na may dalawang ad block. Para i-configure ang code na ito, dapat mong itakda ang kinakailangang parameter na query sa function na pageOptions (hal., “query”: myQuery). Ito ang lahat ng kinakailangan para magsimulang magpakita ng mga ad. Puwede ka ring magtakda ng mga opsyonal na mga parameter sa antas ng page sa block sa antas ng page at mga parameter sa antas ng indibidwal na unit ng ad sa mga function na adblock1 at 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>
Mga paglalarawan sa parameter sa antas ng page
Isang beses lang kailangang tukuyin ang mga parameter na ito sa bawat page. Naaapektuhan ng mga ito ang lahat ng unit sa page.
Kinakailangan
| Parameter | Paglalarawan at mga halimbawa |
|---|---|
adPage |
Kinakailangan kapag nag-navigate ang user sa susunod na page ng mga resulta o nakaraang page ng mga resulta
Tinutukoy ng parameter na |
pubId |
Kinakailangan Ito ang AdSense client-ID mo. Ang pubId mo ay ang bahagi ng iyong client-ID pagkatapos ng 'partner-.' Halimbawa, kung ang client-ID mo ay 'partner-test-property,' ang pubId mo ay 'test-property.' Ito ang karaniwang protocol para sa CSA. Halimbawa: 'pubId' : 'test-property' |
query |
Kinakailangan Ito ang query sa paghahanap na inilagay ng user. Hindi dapat naka-encode ang value ng parameter ng query. Mga Halimbawa:
|
resultsPageBaseUrl |
Kinakailangan kapag may mga unit ng kaugnay na paghahanap sa page Tinutukoy ang URL ng page ng mga resulta ng paghahanap kung saan ang query sa paghahanap ay ang termino para sa kaugnay na paghahanap na na-click ng user. Puwedeng kasama sa resultsPageBaseUrl ang sarili nitong mga parameter, maliban sa query sa paghahanap na awtomatikong idaragdag.
Halimbawa:
|
styleId |
Kinakailangan Tinutukoy ang ID ng istilo ng paghahanap na ilalapat sa mga unit ng ad o kaugnay na paghahanap sa page. Matuto pa tungkol sa paggamit ng mga istilo ng paghahanap. Tandaan na gamit ang styleId na itinakda para sa isang kahilingan, ire-render ang mga ad o kaugnay na paghahanap gamit ang istilong iyon, at babalewalain ang mga legacy na parameter sa pag-iistilo. Kung hindi tinukoy ang styleId sa kahilingan, ire-render ang default na istilo ng system. Halimbawa
|
Opsyonal
| Parameter | Paglalarawan at mga halimbawa |
|---|---|
linkTarget |
Opsyonal Tinutukoy kung bubukas ang pag-click sa ad sa parehong window o sa isang bagong window. Ang default ay '_top.' Magagamit din ang parameter na ito sa antas ng unit.
Halimbawa: 'linkTarget' : '_blank' |
maxTermLength |
Opsyonal Tinutukoy ang maximum na bilang ng mga character ng termino para sa kaugnay na paghahanap kasama ang mga space. Walang maximum kung hindi itinakda. Halimbawa: 'maxTermLength' : 50 |
referrerAdCreative |
Opsyonal Kung dumating ang isang user sa page ng iyong content na naglalaman ng Kaugnay na Paghahanap para sa unit ng Content sa pamamagitan ng pag-click sa isang ad o link sa ibang website, at nasa kontrol mo ang ad o link na iyon, dapat itakda ang parameter na ito sa creative na text ng ad o link na iyon nang verbatim. Nalalapat ang mga sumusunod na alituntunin sa paggamit ng parameter ng ito:
Mga Halimbawa: 'referrerAdCreative': 'maghanap ng mga ad na nauugnay sa dental implants''referrerAdCreative': 'Ang Mga Unang Senyales ng Psoriatic Arthritis' |
resultsPageQueryParam |
Opsyonal Tinutukoy ang pangalan ng parameter ng URL para sa query sa paghahanap sa page ng mga resulta ng paghahanap. Nagde-default sa ‘q’ kung hindi tinukoy. Halimbawa: 'resultsPageQueryParam' : 'query' |
terms |
Opsyonal Nagbibigay-daan sa iyo ang parameter na ito na magbigay ng listahang pinaghihiwalay ng kuwit ng sarili mong mga termino ng kaugnay na paghahanap na ibabalik ng kahilingan sa kaugnay na paghahanap, bagama't puwedeng gamitin o hindi ng Google ang mga terminong ibinigay rito. Halimbawa: 'terms' : 'cars rental, flight ticket' |
Mga setting ng configuration
| Parameter | Paglalarawan at mga halimbawa | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Opsyonal Tinutukoy ang mga panuntunan sa pag-filter na dapat ilapat ng Google sa mga ad na tumutugma sa query sa paghahanap. Ang mga sumusunod ay mga valid na setting para sa adsafe at ang epekto ng bawat value sa mga ibinalik na ad:
Tandaan: Bilang default, nakatakda sa 'high' ang
adsafe.Halimbawa: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Opsyonal Ginagamit ang parameter na adtestpara isaad na ang kahilingan para sa mga ad ay isang pansubok. Kapag may value na 'on' ang parameter na adtest ituturing ng Google ang kahilingan bilang isang pansubok at hindi nito bibilangin ang mga ad impression o susubaybayan ang mga resulta ng clickthrough.
Kapag may value na 'on' ang parameter na Tandaan: Gamitin ang parameter na ito kapag nanunubok, ngunit huwag itong gamitin sa mga system ng produksyon dahil kung gagamitin mo ito hindi ka mababayaran para sa mga ad na ipinapakita mo.
Ang default na value ng adtest ay 'off.' Halimbawa: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Opsyonal Puwede kang magsama ng channel sa AdSense for Search para subaybayan ang performance ng iba't ibang page. Gamitin ang natatanging channel ID na ginawa mo sa iyong AdSense account. Matuto pa tungkol sa pagsubaybay sa performance ng ad gamit ang mga custom na channel. Puwedeng paghiwalayin ang maraming channel ng simbolong '+.' Mga Halimbawa: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Opsyonal Tinutukoy ng parameter na ito ang wikang dapat i-target ng mga hiniling na ad. Ang default na value ay 'en.' Sinusuportahan ng Google ang lahat ng code ng wika ng Google Ads API. Tandaan: Tinutukoy ng mga advertiser ang mga wika na tina-target ng kanilang mga ad. Kung isasama mo ang parameter na ito sa iyong kahilingan, ibinabalik lang ng Google ang mga ad na na-target para sa wikang iyon o na-target para sa lahat ng wika ngunit hindi nito ginagarantiyahan na ang ad text ay nasa tinukoy na wika.
Karaniwan, dapat mong itakda ang parameter na Mga Halimbawa: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Opsyonal
Itinatakda ng parameter na Ang default na value ng
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Opsyonal
Itinatakda ng parameter na Ang default na value ng
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Opsyonal Tinutukoy kung nagbigay ng pahintulot ang mga user para payagan ang publisher na magbahagi ng personal na impormasyon sa Google para sa layunin ng naka-personalize na pag-advertise.
Tandaan: Bilang default, nakatakda sa 'true' ang
personalizedAds.Halimbawa: 'personalizedAds': false |
Mga paglalarawan ng parameter sa antas ng unit
Naaapektuhan ng mga parameter na ito ang paraan kung paano inihaharap sa user ang mga indibidwal na unit ng ad sa isang page. Ang bawat parameter ay maaaring itakda ng isa-isa para sa bawat unit ng ad.
Kinakailangan
| Parameter | Paglalarawan at mga halimbawa |
|---|---|
container |
Kinakailangan Ang id ng walang lamang container ng ad na <div id='afscontainer1'></div> kung saan dapat lumabas ang ad.
Halimbawa: |
maxTop |
Kinakailangan
Gamitin ang parameter na ito para tukuyin ang bilang ng mga ad na ipapakita sa itaas na unit ng ad. Tandaan: Ginagamit ang parameter na ito kapalit ng parameter na
number. Sapat dapat ang lapad ng unit ng ad na ito para hindi maira-wrap ang unang linya ng mga ad. Ang paggamit sa parameter na maxTop sa anupamang placement sa page ay isang paglabag sa patakaran.Halimbawa: |
width |
Kinakailangan Tinutukoy ang lapad ng unit ng ad o unit ng kaugnay na paghahanap sa pixels. Mga Halimbawa: 'width' : '700px''width' : 700 |
Mga setting ng configuration
| Parameter | Paglalarawan at mga halimbawa | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Opsyonal Tumutukoy ng function ng JavaScript na iko-call kapag nag-load ang mga ad o kaugnay na paghahanap o kapag walang inihatid na ad o kaugnay na paghahanap. Dapat itakda ang parameter sa isang function na callback ng JavaScript na ipinapatupad mo na magbibigay-daan sa pagsasagawa ng isang pagkilos kapag nakumpleto ang ad call. Kukunin ng function na callback ang mga sumusuond na parameter:
Tandaan: Pakisubukan ang iyong function na callback para matiyak na hindi ito bumubuo ng anumang error, lalo na ng mga error na puwedeng makasagabal sa pag-load ng page mo.
Halimbawa ng callback ng JavaScript: 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 |
Opsyonal Ang bilang ng mga ad na dapat lumabas sa unit na ito. Ang default na value ay '2.' Halimbawa: |
||||||||
relatedSearches |
Opsyonal Ang bilang ng mga kaugnay na paghahanap na dapat lumabas sa unit na ito. Nagbabalik ang parameter na ito ng minimum na tatlong kaugnay na paghahanap, maliban na lang kung nakatakda ito sa zero. Nagde-default sa 0 kung hindi tinukoy. Halimbawa: 'relatedSearches' : 4 |
