Parameter
Deskripsi Parameter Tingkat Halaman
Parameter ini hanya perlu ditentukan sekali per halaman. Pengaruh tersebut memengaruhi semua unit di halaman.
Wajib
Parameter | Deskripsi dan Contoh |
---|---|
adPage
|
Diperlukan saat pengguna membuka halaman hasil berikutnya atau halaman hasil sebelumnya. Parameter |
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 Anda adalah 'test-property'. Ini adalah protokol standar untuk CSA. Contoh: 'pubId' : 'test-property' |
query
|
Wajib, kecuali di halaman Konten Penelusuran Terkait. Ini adalah kueri penelusuran yang dimasukkan oleh pengguna. Nilai parameter kueri tidak boleh dienkode. Catatan: Menggunakan parameter ini di Penelusuran Terkait di halaman Konten akan menyebabkan hasil yang tidak diharapkan. Contoh: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl
|
Wajib diisi jika ada unit penelusuran terkait di halaman. Menentukan URL halaman hasil penelusuran tempat kueri penelusuran merupakan istilah penelusuran terkait yang diklik pengguna. resultsPageBaseUrl dapat menyertakan parameternya sendiri, kecuali kueri penelusuran yang akan ditambahkan secara otomatis. Contoh: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
styleId
|
Wajib Menentukan ID gaya penelusuran khusus yang akan diterapkan ke iklan atau unit penelusuran terkait di halaman. Pelajari lebih lanjut cara menggunakan gaya penelusuran kustom. Perhatikan bahwa jika styleId ditetapkan untuk sebuah permintaan, iklan atau penelusuran terkait akan dirender dengan gaya tersebut, 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 terbuka di jendela yang sama atau jendela baru. Defaultnya adalah '_top'. Parameter ini juga dapat digunakan di tingkat unit.
Contoh: 'linkTarget' : '_blank' |
maxTermLength
|
Opsional Menentukan jumlah karakter maksimum dari 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:
Catatan: Parameter ini wajib saat menggunakan parameter 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, setelan default-nya adalah 'q'. Contoh: 'resultsPageQueryParam' : 'query' |
terms
|
Opsional Parameter ini memungkinkan Anda memberikan daftar istilah penelusuran terkait Anda sendiri yang dipisahkan koma untuk ditampilkan bersama permintaan penelusuran terkait, meskipun Google mungkin atau mungkin tidak menggunakan istilah yang disediakan di sini.
Catatan: Saat menggunakan parameter ini, Contoh: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Opsional Menentukan daftar parameter URL untuk halaman konten dengan unit Penelusuran Terkait untuk Konten yang dapat diabaikan dengan aman tanpa memengaruhi konten inti atau pengalaman pengguna. Catatan: Produk Penelusuran Terkait di Konten mengandalkan sistem crawling konten Google untuk mengindeks halaman dan membuat istilah penelusuran yang relevan. URL halaman konten yang berisi parameter kueri seperti variabel pelacakan, ID pengguna, ID sesi, atau ID dinamis lainnya dapat mengganggu kemampuan crawler untuk menilai konten inti halaman dan dapat menyebabkan istilah penelusuran terkait yang tidak akurat atau tidak relevan. Parameter halaman ini menginstruksikan crawler Google untuk mengabaikan parameter yang tidak penting ini, memastikan pengindeksan konten yang tepat dan mengurangi beban crawling yang tidak perlu. Hal ini memungkinkan Google mengenali halaman sebagai telah di-crawl dan mulai menampilkan istilah yang disarankan (baik Google maupun partner, jika memenuhi syarat). Panduan berikut berlaku untuk penggunaan parameter ini:
Contoh:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Memberikan parameter URL yang dapat diabaikan berikut: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'Akan memperlakukan URL halaman konten sebagai: http://example.com/content?page_id=123 |
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:
Secara default, adsafe ditetapkan ke tinggi. Contoh: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Opsional Parameter adtest digunakan untuk menunjukkan bahwa permintaan untuk iklan adalah sebuah pengujian. Jika parameter adtest memiliki nilai on, Google akan memperlakukan permintaan tersebut sebagai pengujian dan tidak menghitung tayangan iklan atau melacak hasil klik-tayang. Jika parameter adtest memiliki nilai on, Anda tidak menghasilkan pendapatan apa pun. Gunakan parameter ini saat melakukan pengujian, tetapi jangan gunakan parameter ini dalam sistem produksi, atau Anda tidak akan dibayar untuk iklan yang Anda tampilkan. Nilai adtest default nonaktif. Contoh: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
Opsional Anda dapat menyertakan saluran AdSense untuk Penelusuran untuk melacak performa berbagai halaman. Gunakan ID channel unik yang dibuat di akun AdSense atau oleh Manajer Akun Teknis Anda. Pelajari channel lebih lanjut di sini. Beberapa saluran harus dipisahkan dengan simbol '+'. Contoh: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
Opsional Parameter ini mengidentifikasi bahasa yang harus ditarget oleh iklan yang diminta atau penelusuran terkait. Nilai defaultnya adalah en. Google mendukung semua kode bahasa AdWords API. Catatan: Pengiklan menentukan bahasa yang ditargetkan iklannya. Jika Anda menyertakan parameter ini dalam permintaan Anda, Google hanya menampilkan iklan yang ditargetkan untuk bahasa tersebut atau untuk semua bahasa, tetapi tidak menjamin bahwa teks iklan akan menggunakan bahasa yang ditentukan. Biasanya, Anda harus menetapkan parameter hl ke bahasa utama halaman asal parameter ini dikirim. Contoh: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
Opsional Parameter Nilai
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Opsional Parameter Nilai
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
Opsional Parameter ini memungkinkan Anda memberikan boolean yang memberi tahu Google bahwa Anda ingin mengizinkan iklan yang menggunakan penyimpanan lokal & cookie khusus traffic tidak valid pada traffic yang diberi izin dan tanpa izin.
Secara default, IVT ditetapkan ke true (benar). Contoh: 'ivt': false |
Deskripsi Parameter Tingkat Unit
Parameter berikut memengaruhi cara unit iklan individual 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 penampung iklan yang kosong <div> tempat iklan akan muncul.
Contoh: 'container' : 'afscontainer1' |
maxTop
|
Wajib jika unit iklan berada di atas hasil penelusuran. Gunakan parameter ini untuk menentukan jumlah iklan yang akan ditampilkan di unit iklan atas. 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 |
width
|
Wajib Menentukan lebar iklan atau unit penelusuran terkait dalam piksel. Contoh: 'width' : '700px' 'width' : 700 |
Setelan Konfigurasi
Parameter | Deskripsi dan Contoh | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
Opsional Menentukan fungsi JavaScript yang akan dipanggil saat iklan atau penelusuran terkait telah dimuat atau saat tidak ada iklan atau penelusuran terkait yang ditayangkan. Parameter ini harus ditetapkan ke fungsi callback JavaScript yang Anda terapkan yang memungkinkan tindakan dilakukan saat panggilan iklan selesai. Fungsi callback mengambil parameter berikut:
Catatan: Uji fungsi callback Anda untuk memastikan bahwa fungsi ini tidak menghasilkan 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 } } }; |
||||||||
number
|
Opsional Jumlah iklan yang akan ditampilkan di unit ini. Nilai defaultnya adalah 2. Contoh: 'number' : 4 |
||||||||
relatedSearches
|
Opsional Jumlah penelusuran terkait yang akan muncul di unit ini. Jika tidak ditentukan, defaultnya adalah 0. Contoh: 'relatedSearches' : 4 |