Parameter
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 |
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, kecuali di Penelusuran Terkait di halaman Konten. Ini adalah kueri penelusuran yang dimasukkan oleh pengguna. Nilai parameter kueri harus dibatalkan encoding-nya. Catatan: Menggunakan parameter ini di Penelusuran Terkait di halaman Konten akan menyebabkan hasil yang tidak terduga. Contoh: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl
|
Wajib jika ada unit penelusuran terkait di halaman. Menentukan URL halaman hasil penelusuran tempat kueri penelusuran adalah istilah penelusuran terkait yang diklik pengguna. resultsPageBaseUrl dapat menyertakan parameternya sendiri, kecuali kueri penelusuran yang akan otomatis ditambahkan. Contoh: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
Wajib jika ada unit penelusuran terkait di halaman. Parameter ini wajib diisi saat unit penelusuran terkait diminta. Ini mengontrol jenis pengalaman Penelusuran Terkait yang ditampilkan, bergantung pada konteks halaman:
Catatan:Parameter halaman relatedSearchTargeting secara otomatis disetel ke 'query' secara default. Namun, penting untuk diperhatikan bahwa nilai default ini secara khusus dirancang untuk halaman hasil penelusuran saja (Penelusuran Terkait di Penelusuran). Jika menggunakan penelusuran terkait di jenis halaman lain (misalnya, artikel, postingan blog), Anda harus menetapkan parameter secara eksplisit ke 'content'. Catatan: Panduan berikut berlaku untuk penggunaan parameter ini:
Contoh: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
Wajib Menentukan ID gaya penelusuran kustom yang akan diterapkan ke unit penelusuran terkait atau iklan di halaman. Pelajari lebih lanjut cara menggunakan gaya penelusuran kustom. Perhatikan bahwa jika styleId ditentukan untuk permintaan, iklan atau penelusuran terkait akan dirender dengan gaya tertentu, 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.
Contoh: 'linkTarget' : '_blank' |
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, 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.
Catatan: Saat menggunakan parameter ini, Contoh: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Opsional Menentukan daftar parameter URL untuk halaman konten dengan unit Related Search for Content yang dapat diabaikan dengan aman tanpa memengaruhi konten inti atau pengalaman pengguna. Catatan: Sebelum istilah penelusuran terkait dapat muncul di situs Anda, Google perlu meng-crawl halaman Anda untuk memastikan istilah tersebut relevan secara kontekstual. Jika halaman belum di-crawl atau diblokir agar tidak di-crawl (misalnya, oleh robots.txt) oleh crawler AdSense, kami tidak akan menampilkan saran istilah Penelusuran Terkait yang Anda berikan kepada Google. Produk Penelusuran Terkait di Konten mengandalkan sistem crawling konten Google untuk mengindeks halaman dan menghasilkan 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 mengevaluasi konten utama di 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, sehingga memastikan pengindeksan konten yang tepat dan mengurangi beban crawl yang tidak perlu. Hal ini memungkinkan Google mengenali halaman dengan lebih baik sebagai halaman yang 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=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' 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 disetel ke tinggi. Contoh: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Opsional Parameter adtest digunakan untuk menunjukkan bahwa permintaan iklan merupakan 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. Permintaan iklan dengan parameter adtest yang ditetapkan ke on yang berasal dari domain yang belum disetujui di tab Situs akan menampilkan iklan yang memiliki overlay "iklan percobaan" dan tidak dapat diklik. Gunakan parameter ini saat melakukan pengujian, tetapi jangan gunakan parameter ini di sistem produksi, atau Anda tidak akan dibayar untuk iklan yang Anda tampilkan. Nilai default adtest adalah nonaktif. Contoh: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
Opsional Anda dapat menyertakan saluran AdSense untuk Penelusuran untuk melacak performa berbagai halaman. Gunakan ID saluran unik yang dibuat di akun AdSense Anda atau oleh Account Manager 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 ditargetkan oleh iklan atau penelusuran terkait yang diminta. Nilai defaultnya adalah en. Google mendukung semua kode bahasa AdWords API. Catatan: Pengiklan menentukan bahasa yang akan ditargetkan oleh iklan mereka. Jika Anda menyertakan parameter ini dalam permintaan Anda, 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 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 di traffic dengan izin cookie dan tanpa izin cookie.
Secara default, IVT ditetapkan ke true. Contoh: 'ivt': false |
Deskripsi Parameter Tingkat Unit
Parameter ini 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 penampung iklan kosong <div> tempat iklan akan ditampilkan.
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 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 |
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 harus ditetapkan ke fungsi callback JavaScript yang Anda terapkan sehingga memungkinkan tindakan dilakukan saat panggilan iklan selesai. Fungsi callback mengambil parameter berikut:
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 } } }; |
||||||||
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. Jika tidak ditentukan, setelan defaultnya adalah 0. Contoh: 'relatedSearches' : 4 |