Deskripsi parameter iklan Penelusuran

Untuk pengguna tingkat lanjut, kami telah menyediakan daftar parameter gaya penelusuran yang saat ini didukung. Kode yang Anda buat di AdSense berisi semua setelan parameter yang paling sering digunakan. Ada dua parameter yang diperlukan: pubId dan query. AdSense menyediakan pubId, tetapi Anda harus mengedit kode dan meneruskan nilai untuk parameter query. Semua parameter lainnya bersifat opsional dan dijelaskan di bawah ini.

Jenis parameter

Ada dua jenis parameter:

• Parameter tingkat halaman yang berlaku untuk semua unit iklan pada halaman
• Parameter tingkat unit yang berlaku untuk unit iklan tunggal.

Berikut beberapa contoh output dari pembuat kode dengan dua blok iklan. Untuk mengonfigurasi kode ini, Anda harus menetapkan parameter query yang diperlukan dalam fungsi pageOptions (misalnya, “query”: myQuery). Hanya inilah yang diperlukan untuk mulai menampilkan iklan. Anda juga dapat menetapkan parameter tingkat halaman opsional di blok tingkat halaman serta parameter tingkat unit iklan tunggal pada fungsi adblock1 dan adblock2.

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

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

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

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

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

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

</script>

Deskripsi parameter tingkat halaman

Parameter ini hanya perlu ditentukan satu kali per halaman. Seluruh parameter tersebut memengaruhi semua unit pada halaman.

Wajib

Parameter	Deskripsi dan contoh
adPage	Wajib jika pengguna membuka halaman hasil penelusuran berikutnya atau halaman hasil penelusuran sebelumnya Parameter adPage menentukan halaman hasil penelusuran tempat iklan ditampilkan. Parameter ini digunakan saat pengguna membuka halaman berikutnya setelah halaman pertama hasil penelusuran. Misalnya, jika lima iklan diminta, dan parameter adPage ditetapkan ke '2', iklan yang ditampilkan akan muncul di halaman kedua hasil penelusuran.
pubId	Wajib Ini adalah client-ID AdSense Anda. pubId Anda adalah bagian dari client-ID yang muncul setelah 'partner-'. Misalnya, jika client-ID Anda adalah 'partner-test-property', pubId-nya adalah 'test-property'. Ini adalah protokol standar untuk CSA. Contoh: 'pubId' : 'test-property'
query	Wajib Ini adalah kueri penelusuran yang dimasukkan oleh pengguna. Nilai parameter kueri harus dibatalkan encoding-nya. Contoh: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // dengan myQuery adalah variabel JavaScript yang berisi kueri penelusuran
resultsPageBaseUrl	Wajib jika ada unit penelusuran terkait di halaman Menentukan URL halaman hasil penelusuran di mana kueri penelusuran adalah istilah penelusuran terkait yang diklik pengguna. resultsPageBaseUr dapat menyertakan parameternya sendiri, kecuali kueri penelusuran yang akan otomatis ditambahkan. Contoh: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
styleId	Wajib Menentukan ID gaya penelusuran yang akan diterapkan ke unit penelusuran terkait atau iklan di halaman. Pelajari lebih lanjut cara menggunakan gaya penelusuran. Perhatikan bahwa jika styleId ditentukan untuk permintaan, iklan atau penelusuran terkait akan dirender dengan gaya, dan parameter gaya lama akan diabaikan. Jika styleId tidak ditentukan dalam permintaan, gaya default sistem akan dirender. Contoh 'styleId': '1234567890'

Opsional

Parameter	Deskripsi dan contoh
linkTarget	Opsional Menentukan apakah klik pada iklan akan membuka hasil di jendela yang sama atau jendela baru. Defaultnya adalah '_top'. Parameter ini juga dapat digunakan di tingkat unit. '_top' Membuka hasil di jendela yang sama. '_blank' Membuka hasil di jendela baru. Contoh: 'linkTarget' : '_blank'
maxTermLength	Opsional Menentukan jumlah maksimum karakter istilah penelusuran terkait termasuk spasi. Tidak ada jumlah maksimum jika tidak ditetapkan. Contoh: 'maxTermLength' : 50
referrerAdCreative	Opsional Jika pengguna membuka halaman konten Anda yang berisi unit Penelusuran Terkait untuk Konten dengan mengklik iklan atau link di situs lain, dan iklan atau link tersebut berada di bawah kontrol Anda, parameter ini harus ditetapkan ke teks materi iklan dari iklan atau link tersebut kata demi kata. Panduan berikut berlaku untuk penggunaan parameter ini: Parameter hanya boleh diberikan ke permintaan Penelusuran Terkait untuk Konten, dan akan diabaikan untuk semua permintaan lainnya. Hanya boleh digunakan pada traffic yang sengaja Anda ambil dari situs lain, dan tidak pernah digunakan pada traffic organik. Dapat berisi baris judul dan/atau deskripsi materi iklan link atau iklan. Tidak peka huruf besar/kecil. Kode ini menerima encoding UTF-8 yang valid; diakritik/karakter unicode didukung. Google dapat menggunakan atau mengabaikan parameter yang Anda kirimkan. Jika digunakan, parameter tersebut dapat memengaruhi pilihan dan peringkat istilah. Contoh: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam	Opsional Menentukan nama parameter URL untuk kueri penelusuran di halaman hasil penelusuran. Jika tidak ditentukan, nilai defaultnya adalah 'q'. Contoh: 'resultsPageQueryParam' : 'query'
terms	Opsional Parameter ini memungkinkan Anda memberikan daftar istilah penelusuran terkait Anda sendiri yang dibatasi dengan tanda koma untuk ditampilkan bersama permintaan penelusuran terkait, meskipun Google mungkin atau mungkin tidak menggunakan istilah yang disediakan di sini. Contoh: 'terms' : 'cars rental, flight ticket'

Setelan konfigurasi

Parameter	Deskripsi dan contoh
adsafe	Opsional Menentukan aturan pemfilteran yang harus diterapkan Google pada iklan yang cocok dengan kueri penelusuran. Berikut adalah setelan valid untuk adsafe dan dampak dari setiap nilai pada iklan yang ditampilkan: 'high' Menampilkan iklan yang cocok bagi keluarga. Tidak menampilkan iklan yang tidak cocok bagi keluarga atau yang berisi konten seksual dewasa. 'medium' Menampilkan iklan yang cocok dan yang tidak cocok bagi keluarga. Tidak menampilkan iklan konten seksual dewasa. 'low' Menampilkan semua jenis iklan. Catatan: Secara default, adsafe ditetapkan ke 'high'. Contoh: 'adsafe': 'medium'
adtest	Opsional Parameter adtest digunakan untuk menunjukkan bahwa permintaan untuk iklan merupakan sebuah pengujian. Jika parameter adtest memiliki nilai 'on', Google akan memperlakukan permintaan tersebut sebagai pengujian dan tidak akan menghitung tayangan iklan atau melacak hasil klik-tayang. Jika parameter adtest memiliki nilai 'on', Anda tidak akan menghasilkan pendapatan apa pun. Catatan: Gunakan parameter ini saat melakukan pengujian, tetapi jangan gunakan parameter ini di sistem produksi, atau Anda tidak akan dibayar untuk iklan yang Anda tampilkan. Permintaan iklan dengan adtest 'on' yang berasal dari situs yang belum disetujui di halaman Situs, akan menampilkan iklan yang memiliki overlay "iklan percobaan" dan tidak dapat diklik. Nilai default adtest adalah 'off'. Contoh: 'adtest' : 'on'
channel	Opsional Anda dapat menyertakan saluran AdSense untuk Penelusuran untuk melacak performa berbagai halaman. Gunakan ID saluran unik yang Anda buat di akun AdSense. Pelajari lebih lanjut cara melacak performa iklan dengan saluran khusus. Beberapa saluran harus dipisahkan dengan simbol '+'.   Contoh: 'channel' : 'testA' 'channel' : 'testA+testB'
hl	Opsional Parameter ini mengidentifikasi bahasa yang harus ditargetkan oleh iklan yang diminta. Nilai default parameter ini adalah 'en'. Google mendukung semua kode bahasa Google Ads API. Catatan: Pengiklan menentukan bahasa yang akan ditargetkan oleh iklan mereka. Jika Anda menyertakan parameter ini dalam permintaan, Google hanya menampilkan iklan yang ditargetkan untuk bahasa tersebut atau untuk semua bahasa, tetapi hal ini tidak menjamin bahwa teks iklan akan menggunakan bahasa yang ditetapkan. Biasanya, Anda harus menetapkan parameter hl ke bahasa utama halaman asal parameter ini dikirim. Contoh: 'hl' : 'es'
ie	Opsional Parameter ie menetapkan skema encoding karakter yang harus digunakan untuk menafsirkan string kueri. Nilai default ie adalah 'utf-8'. Nilai Nama standar Bahasa terkait yang didukung latin1 ISO-8859-1 Eropa Barat (Katala, Denmark, Belanda, Inggris, Finlandia, Prancis, Jerman, Indonesia, Italia, Norwegia, Portugis, Spanyol, Swedia) latin2 ISO-8859-2 Eropa Timur (Kroasia, Ceko, Hungaria, Polandia, Rumania, Serbia, Slovakia, Slovenia) latin3 ISO-8859-3   latin4 ISO-8859-4 Baltik (Estonia, Latvia, Lituania) cyrillic ISO-8859-5 Bulgaria, Rusia arabic ISO-8859-6   greek ISO-8859-7 Yunani hebrew ISO-8859-8 Ibrani latin5 ISO-8859-9   latin6 ISO-8859-10 Islandia euc-jp EUC-JP Jepang euc-kr EUC-KR Korea sjis Shift_JIS Jepang big5 Big5 China Aks. Tradisional gb GB2312 China Aksara Sederhana utf-8 UTF-8 Semua
oe	Opsional Parameter oe menetapkan skema encoding karakter yang harus digunakan Google untuk mengenkode teks iklan. Meskipun secara teknis bersifat opsional, sebaiknya teruskan nilai untuk parameter ini. Nilai default parameter oe adalah 'utf-8'. Nilai Nama standar Bahasa Terkait yang Didukung latin1 ISO-8859-1 Eropa Barat (Katala, Denmark, Belanda, Inggris, Finlandia, Prancis, Jerman, Indonesia, Italia, Norwegia, Portugis, Spanyol, Swedia) latin2 ISO-8859-2 Eropa Timur (Kroasia, Ceko, Hungaria, Polandia, Rumania, Serbia, Slovakia, Slovenia) latin3 ISO-8859-3   latin4 ISO-8859-4 Baltik (Estonia, Latvia, Lituania) cyrillic ISO-8859-5 Bulgaria, Rusia arabic ISO-8859-6   greek ISO-8859-7 Yunani hebrew ISO-8859-8 Ibrani latin5 ISO-8859-9   latin6 ISO-8859-10 Islandia euc-jp EUC-JP Jepang euc-kr EUC-KR Korea sjis Shift_JIS Jepang gb GB2312 China Aksara Sederhana utf-8 UTF-8 Semua
personalizedAds	Opsional Menentukan apakah pengguna telah memberikan izin kepada penayang untuk berbagi informasi pribadi dengan Google untuk tujuan iklan yang dipersonalisasi. true Menampilkan iklan yang ditargetkan kueri dan beberapa iklan yang mungkin ditargetkan dengan cookie Google pengguna. Pengguna yang berada di Uni Eropa harus terlebih dahulu memberikan izin kepada situs Anda untuk berbagi informasi pribadi dengan Google untuk tujuan iklan yang dipersonalisasi. false Menampilkan hanya iklan yang ditargetkan kueri. Parameter ini tidak akan menampilkan iklan yang ditargetkan dengan cookie Google pengguna. Jika pengguna menolak memberikan izin bagi situs Anda untuk berbagi informasi pribadi dengan Google untuk tujuan iklan yang dipersonalisasi, Anda harus menetapkan nilai ini ke false. Catatan: Secara default, personalizedAds ditetapkan ke 'true'. Contoh: 'personalizedAds': false

Deskripsi parameter tingkat unit

Parameter berikut memengaruhi cara unit iklan tunggal di halaman ditampilkan kepada pengguna. Setiap parameter dapat ditetapkan satu per satu untuk masing-masing unit iklan.

Wajib

Parameter	Deskripsi dan contoh
container	Wajib ID dari penampung iklan yang kosong <div id='afscontainer1'></div> tempat iklan akan ditampilkan. Contoh: 'container' : 'afscontainer1'

Setelan konfigurasi

Parameter	Deskripsi dan contoh
adLoadedCallback	Opsional Menentukan fungsi JavaScript yang akan dipanggil saat iklan/penelusuran terkait telah dimuat atau saat tidak ada iklan/penelusuran terkait yang ditayangkan. Parameter harus ditetapkan ke fungsi callback JavaScript yang Anda terapkan sehingga memungkinkan tindakan dilakukan saat panggilan iklan selesai. Fungsi callback mengambil parameter berikut: containerName Nama penampung iklan atau unit penelusuran terkait. adsLoaded Tetapkan ke true jika setidaknya ada satu iklan atau istilah penelusuran terkait yang akan ditampilkan dan false jika tidak ada iklan atau penelusuran terkait yang akan ditampilkan. isExperimentVariant Tetapkan ke true jika Anda menjalankan eksperimen gaya kustom dan memilih varian dari eksperimen tersebut untuk merender iklan. callbackOptions Objek JSON yang berisi kolom berikut: termPositions: Untuk blok penelusuran terkait, berisi map<string,int> dari istilah yang diberikan penayang untuk posisi yang tidak diindeks bagi istilah tersebut dalam respons penelusuran. Jika istilah diberikan, tetapi tidak ditampilkan, istilah tersebut tidak akan muncul di fungsi. Catatan: Uji fungsi callback Anda untuk memastikan bahwa fungsi ini tidak menimbulkan error, terutama yang dapat mengganggu pemuatan halaman Anda. Contoh callback 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     }   } };
maxTop	Opsional Gunakan parameter ini untuk menentukan jumlah iklan yang akan ditampilkan di unit iklan teratas. Catatan: Parameter ini digunakan sebagai pengganti parameter number. Unit iklan ini harus cukup lebar agar baris pertama iklan tidak melebihi batas. Menggunakan parameter maxTop pada penempatan lain di halaman tersebut merupakan pelanggaran kebijakan. Contoh: 'maxTop' : 4
number	Opsional Jumlah iklan yang akan ditampilkan di unit ini. Nilai defaultnya adalah '2'. Contoh: 'number' : 4
relatedSearches	Opsional Jumlah penelusuran terkait yang akan ditampilkan di unit ini. Parameter ini menampilkan minimal tiga penelusuran terkait, kecuali jika ditetapkan ke nol. Jika tidak ditentukan, setelan defaultnya adalah 0. Contoh: 'relatedSearches' : 4
width	Opsional Menentukan lebar unit iklan atau unit penelusuran terkait dalam piksel. Contoh: 'width' : '700px' 'width' : 700