Perihalan parameter Iklan Carian Tersuai

Untuk pengguna lanjutan, kami telah menyediakan senarai parameter gaya carian yang disokong pada masa ini. Kod yang anda jana di AdSense mengandungi semua tetapan parameter yang paling biasa digunakan. Terdapat dua parameter yang diperlukan: pubId dan query. AdSense menyediakan pubId tetapi anda hendaklah mengedit kod dan menghantar nilai untuk parameter query. Semua parameter lain ialah pilihan dan diterangkan di bawah.

Jenis parameter

Terdapat dua jenis parameter:

• Parameter peringkat halaman yang digunakan pada semua unit iklan di halaman
• Parameter peringkat unit yang digunakan pada unit iklan individu.

Berikut ialah beberapa contoh output daripada penjana kod dengan dua blok iklan. Untuk mengkonfigurasikan kod ini, anda hendaklah menetapkan parameter query diperlukan dalam peta pageOptions (mis. “query”: myQuery). Perkara ini sahaja yang diperlukan untuk mula memaparkan iklan. Anda juga boleh menetapkan parameter peringkat halaman pilihan dalam blok peringkat halaman dan parameter peringkat unit individu dalam peta adblock1 dan adblock2.

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // Parameter peringkat halaman
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // Parameter peringkat unit
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

Perihalan parameter peringkat halaman

Parameter ini hanya perlu ditentukan sekali di setiap halaman. Parameter tersebut mempengaruhi semua unit di halaman.

Diperlukan

Parameter	Perihalan dan contoh
adPage	Diperlukan apabila pengguna menavigasi ke halaman hasil seterusnya atau halaman hasil sebelumnya Parameter adPage menentukan halaman hasil yang iklan dipaparkan. Parameter ini digunakan apabila pengguna menavigasi melewati halaman pertama hasil carian. Sebagai contoh, jika lima iklan diminta, dan parameter adPage ditetapkan kepada '2', iklan yang dikembalikan akan menjadi halaman kedua dengan lima iklan.
pubId	Diperlukan Ini ialah ID pelanggan AdSense anda. pubId anda adalah sebahagian daripada ID pelanggan anda yang datang selepas 'partner-'. Contohnya, jika ID pelanggan anda ialah 'partner-test-property', pubId anda ialah 'test-property'. Ini ialah protokol standard untuk CSA. Contoh: 'pubId' : 'test-property'
query	Diperlukan Ini ialah pertanyaan carian yang dimasukkan oleh pengguna. Nilai parameter pertanyaan tidak boleh dinyahkodkan. Contoh: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // dengan myQuery ialah pemboleh ubah JavaScript yang mengandungi pertanyaan carian
resultsPageBaseUrl	Diperlukan apabila terdapat unit carian berkaitan di halaman Menentukan URL halaman hasil carian yang pertanyaan carian ialah istilah carian berkaitan yang telah diklik pengguna. resultsPageBaseUrl mungkin termasuk parameter tersendiri, kecuali pertanyaan carian yang akan ditambahkan secara automatik. Contoh: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
styleId	Diperlukan Menentukan ID gaya carian untuk digunakan pada iklan atau unit carian berkaitan di halaman. Ketahui lebih lanjut tentang menggunakan gaya carian. Harap maklum bahawa dengan styleId ditetapkan untuk permintaan, iklan atau carian berkaitan akan dipaparkan bersama gaya dan parameter penggayaan lama akan diabaikan. Jika styleId tidak ditentukan dalam permintaan, gaya ciri lalai sistem akan dipaparkan. Contoh 'styleId': '1234567890'

Pilihan

Parameter	Perihalan dan contoh
linkTarget	Pilihan Menentukan sama ada tindakan mengklik pada iklan dibuka dalam tetingkap yang sama atau tetingkap baharu. Nilai lalai ialah '_top'. Parameter ini juga boleh digunakan pada peringkat unit. '_top' Dibuka dalam tetingkap yang sama. '_blank' Dibuka dalam tetingkap yang sama. Contoh: 'linkTarget' : '_blank'
maxTermLength	Pilihan Menentukan bilangan maksimum aksara bagi istilah carian berkaitan yang termasuk ruang. Tiada nilai maksimum jika tidak ditetapkan. Contoh: 'maxTermLength' : 50
referrerAdCreative	Pilihan Jika pengguna tiba di halaman kandungan anda yang mengandungi Carian Berkaitan untuk unit Kandungan dengan mengklik iklan atau pautan di laman web lain dan iklan atau pautan tersebut dalam kawalan anda, maka parameter ini perlu ditetapkan kepada teks kreatif bagi iklan atau pautan secara sepadan. Garis panduan berikut berkuat kuasa pada penggunaan parameter ini: Parameter tersebut hanya boleh diberikan pada Carian Berkaitan untuk permintaan Kandungan dan akan diabaikan pada semua permintaan lain. Parameter ini hanya boleh digunakan pada trafik yang anda sumberkan dengan sengaja daripada laman web lain dan tidak boleh digunakan pada trafik organik. Perkara ini mungkin termasuk baris tajuk dan/atau perihalan kreatif iklan atau pautan. Parameter ini tidak sensitif huruf. Parameter ini menerima pengekodan UTF-8 yang sah; aksara / diakritik unikod adalah disokong. Google mungkin menggunakan atau mengabaikan parameter yang anda serahkan. Apabila digunakan, parameter ini mungkin mempengaruhi pilihan dan penarafan istilah. Contoh: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam	Pilihan Menentukan nama parameter URL untuk pertanyaan carian di halaman hasil carian. Menjadi lalai kepada ‘q’ jika tidak ditentukan. Contoh: 'resultsPageQueryParam' : 'query'
terms	Pilihan Parameter ini membolehkan anda menyediakan senarai dipisahkan koma istilah carian berkaitan anda sendiri untuk dikembalikan bersama pertanyaan carian berkaitan, namun Google mungkin atau mungkin tidak menggunakan istilah yang diberikan di sini. Contoh: 'terms' : 'cars rental, flight ticket'

Tetapan konfigurasi

Parameter	Perihalan dan contoh
adsafe	Pilihan Menentukan peraturan penapisan yang Google harus gunakan pada iklan yang sepadan dengan pertanyaan carian. Berikut ialah tetapan yang sah untuk adsafe dan kesan setiap nilai pada iklan yang dikembalikan: 'high' Mengembalikan iklan selamat untuk keluarga. Tidak mengembalikan iklan yang tidak selamat untuk keluarga atau kandungan seks dewasa. 'medium' Mengembalikan iklan selamat untuk keluarga dan tidak selamat untuk keluarga. Tidak mengembalikan iklan kandungan seks dewasa. 'low' Mengembalikan semua jenis iklan. Nota: Secara lalai adsafe ditetapkan kepada 'high'. Contoh: 'adsafe': 'medium'
adtest	Pilihan Parameter adtest digunakan untuk menunjukkan bahawa permintaan untuk iklan ialah ujian. Apabila parameter adtest mempunyai nilai 'on', Google mengendalikan permintaan tersebut sebagai ujian dan tidak mengira tera iklan atau menjejak hasil klikan. Apabila parameter adtest mempunyai nilai 'on', anda tidak menjana apa-apa hasil. Nota: Gunakan parameter ini semasa ujian, tetapi jangan gunakan dalam sistem pengeluaran, jika tidak, anda tidak akan dibayar untuk iklan yang anda paparkan. Nilai adtest lalai ialah 'off'. Contoh: 'adtest' : 'on'
channel	Pilihan Anda boleh menyertakan saluran AdSense for Search untuk menjejak prestasi halaman yang berlainan. Gunakan ID saluran unik yang anda buat dalam akaun AdSense anda. Ketahui lebih lanjut tentang menjejak prestasi iklan menggunakan saluran tersuai. Berbilang saluran hendaklah dipisahkan dengan simbol '+'.   Contoh: 'channel' : 'testA' 'channel' : 'testA+testB'
hl	Pilihan Parameter ini mengenal pasti bahasa yang hendaklah disasarkan oleh iklan yang diminta. Nilai lalai ialah 'en'. Google menyokong semua kod bahasa Google Ads API. Nota: Pengiklan menentukan bahasa yang disasarkan oleh iklan mereka. Jika anda menyertakan parameter ini dalam permintaan anda, Google hanya mengembalikan iklan yang disasarkan untuk bahasa tersebut atau disasarkan bagi semua bahasa tetapi tidak menjamin teks iklan akan menggunakan bahasa tertentu. Biasanya, anda hendaklah menetapkan parameter hl kepada bahasa utama halaman yang parameter ini dihantar. Contoh: 'hl' : 'es'
ie	Pilihan Parameter ie menetapkan skim pengekodan aksara yang perlu digunakan untuk mentafsir rentetan pertanyaan. Nilai ie lalai ialah 'utf-8'. Nilai Nama standard Bahasa disokong yang berkaitan latin1 ISO-8859-1 Eropah Barat (Catalan, Denmark, Belanda, Inggeris, Finland, Perancis, Jerman, Indonesia, Itali, Norway, Portugis, Sepanyol, Sweden) latin2 ISO-8859-2 Eropah Timur (Croatia, Czech, Hungary, Poland, Romania, Serbia, Slovak, Slovenia) latin3 ISO-8859-3   latin4 ISO-8859-4 Baltik (Estonia, Latvia, Lithuania) cyril ISO-8859-5 Bulgaria, Rusia arab ISO-8859-6   greek ISO-8859-7 Greek ibrani ISO-8859-8 Ibrani latin5 ISO-8859-9   latin6 ISO-8859-10 Iceland euc-jp EUC-JP Jepun euc-kr EUC-KR Korea sjis Shift_JIS Jepun big5 Big5 Bahasa Cina Tradisional gb GB2312 Bahasa Cina Mudah utf-8 UTF-8 Semua
oe	Pilihan Parameter oe menetapkan skim pengekodan aksara yang perlu digunakan oleh Google untuk mengekodkan teks iklan tersebut. Walaupun berbentuk pilihan, amalan yang baik adalah untuk menghantar nilai bagi parameter ini. Nilai lalai oe ialah 'utf-8'. Nilai Nama standard Bahasa Disokong yang Berkaitan latin1 ISO-8859-1 Eropah Barat (Catalan, Denmark, Belanda, Inggeris, Finland, Perancis, Jerman, Indonesia, Itali, Norway, Portugis, Sepanyol, Sweden) latin2 ISO-8859-2 Eropah Timur (Croatia, Czech, Hungary, Poland, Romania, Serbia, Slovak, Slovenia) latin3 ISO-8859-3   latin4 ISO-8859-4 Baltik (Estonia, Latvia, Lithuania) cyril ISO-8859-5 Bulgaria, Rusia arab ISO-8859-6   greek ISO-8859-7 Greek ibrani ISO-8859-8 Ibrani latin5 ISO-8859-9   latin6 ISO-8859-10 Iceland euc-jp EUC-JP Jepun euc-kr EUC-KR Korea sjis Shift_JIS Jepun gb GB2312 Bahasa Cina Mudah utf-8 UTF-8 Semua
personalizedAds	Pilihan Menentukan sama ada pengguna telah bersetuju untuk membenarkan penerbit berkongsi maklumat peribadi dengan Google untuk tujuan pengiklanan diperibadikan. true Mengembalikan iklan disasarkan pertanyaan dan sesetengah iklan boleh disasarkan dengan kuki Google pengguna. Sekiranya pengguna berada di Kesatuan Eropah, pengguna hendaklah terlebih dahulu membenarkan membenarkan tapak anda berkongsi maklumat peribadi dengan Google untuk tujuan pengiklanan diperibadikan. false Hanya mengembalikan iklan disasarkan pertanyaan. Ini tidak akan mengembalikan apa-apa iklan yang disasarkan dengan kuki Google pengguna. Jika pengguna telah menolak persetujuan untuk membolehkan laman anda berkongsi maklumat peribadi dengan Google untuk tujuan pengiklanan diperibadikan, anda hendaklah menetapkan nilai ini kepada palsu. Nota: Secara lalai personalizedAds ditetapkan kepada 'true'. Contoh: 'personalizedAds': false

Perihalan parameter peringkat unit

Parameter ini mempengaruhi cara unit iklan individu di halaman dipaparkan kepada pengguna. Setiap parameter boleh ditetapkan secara individu untuk setiap unit iklan.

Diperlukan

Parameter	Perihalan dan contoh
container	Diperlukan Id bekas iklan kosong <div id='afscontainer1'></div> yang merupakan tempat iklan akan dipaparkan. Contoh: 'container' : 'afscontainer1'
maxTop	Diperlukan Gunakan parameter ini untuk menentukan bilangan iklan yang akan dipaparkan pada unit iklan teratas. Nota: Parameter ini digunakan sebagai pengganti parameter number. Unit iklan ini hendaklah cukup lebar sehingga baris pertama iklan tidak dibalut. Penggunaan parameter maxTop pada mana-mana peletakan lain di halaman adalah pelanggaran dasar. Contoh: 'maxTop' : 4
width	Diperlukan Menentukan lebar unit iklan atau unit carian berkaitan dalam piksel. Contoh: 'width' : '700px' 'width' : 700

Tetapan konfigurasi

Parameter	Perihalan dan contoh
adLoadedCallback	Pilihan Menentukan fungsi JavaScript untuk dipanggil apabila iklan atau carian berkaitan telah dimuatkan atau apabila tiada iklan atau carian berkaitan dipaparkan. Parameter perlu ditetapkan kepada fungsi panggil balik JavaScript yang anda laksanakan yang membolehkan tindakan dilakukan apabila panggilan iklan selesai. Fungsi panggil balik menggunakan parameter berikut: containerName Nama bekas untuk iklan atau unit carian berkaitan. adsLoaded Tetapkan kepada benar apabila terdapat sekurang-kurangnya satu iklan atau istilah carian berkaitan untuk dipaparkan dan palsu apabila tiada iklan atau carian berkaitan dikembalikan. isExperimentVariant Tetapkan kepada benar jika percubaan penggayaan tersuai berjalan dan varian percubaan dipilih untuk memaparkan iklan. callbackOptions Objek JSON yang mengandungi medan berikut: termPositions: Untuk blok carian berkaitan, mengandungi map<string,int> istilah yang disediakan penerbit kepada kedudukan indeks sifat istilah ini dalam respons. Jika istilah diberikan tetapi tidak dikembalikan, istilah tersebut tidak akan dipaparkan dalam peta. Nota: Sila uji fungsi panggil balik anda untuk memastikan fungsi tersebut tidak menjana sebarang ralat, khususnya ralat yang mungkin mengganggu pemuatan halaman anda. Contoh panggil balik 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	Pilihan Bilangan iklan yang sepatutnya dipaparkan dalam unit ini. Nilai lalai ialah '2'. Contoh: 'number' : 4
relatedSearches	Pilihan Bilangan carian berkaitan yang seharusnya dipaparkan dalam unit ini. Parameter ini mengembalikan minimum tiga carian berkaitan, melainkan ditetapkan kepada sifar. Menjadi lalai kepada 0 jika tidak ditentukan. Contoh: 'relatedSearches' : 4