Parameter
Deskripsi Parameter Tingkat Halaman
Parameter ini hanya perlu ditentukan sekali per halaman. Memengaruhi semua unit di halaman.
Wajib
| Parameter | Deskripsi dan Contoh |
|---|---|
adPage
|
Wajib diisi 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 Penelusuran Terkait di halaman Konten. Ini adalah kueri penelusuran yang dimasukkan oleh pengguna. Nilai parameter kueri tidak boleh dienkode. Catatan: Penggunaan parameter ini di halaman Penelusuran Terkait di 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 yang kueri penelusurannya adalah 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' |
relatedSearchTargeting
|
Wajib diisi jika ada unit penelusuran terkait di halaman. Parameter ini wajib jika unit penelusuran terkait diminta. Atribut ini mengontrol jenis pengalaman Penelusuran Terkait yang ditampilkan, bergantung pada konteks halaman:
Catatan:Parameter halaman terkaitSearchTargeting otomatis ditetapkan ke 'query' secara default. Namun, penting untuk diperhatikan bahwa nilai default ini dirancang khusus untuk halaman hasil penelusuran saja (Penelusuran Terkait di Penelusuran). Jika menggunakan penelusuran terkait pada jenis halaman lainnya (misalnya artikel, postingan blog), Anda harus menetapkan parameter tersebut 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 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 visual 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 maksimum karakter istilah penelusuran terkait termasuk spasi. Tidak ada batas 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 kendali Anda, parameter ini harus ditetapkan ke teks materi iklan untuk iklan tersebut atau link kata demi kata. Panduan berikut berlaku untuk penggunaan parameter ini:
Catatan: Parameter ini wajib ada 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 defaultnya 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: 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 dari crawling (misalnya, oleh robots.txt) oleh crawler AdSense, kami tidak akan menampilkan saran istilah Penelusuran Terkait yang Anda berikan kepada Google. Penelusuran Terkait pada produk 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 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, sehingga memastikan pengindeksan konten yang tepat dan mengurangi beban crawling yang tidak perlu. Dengan demikian, Google dapat lebih mengenali 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=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 setiap nilai terhadap iklan yang ditampilkan:
Secara default, adsafe ditetapkan ke tinggi. Contoh: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Opsional Parameter adtest digunakan untuk menunjukkan bahwa permintaan untuk iklan merupakan sebuah pengujian. Jika parameter adtest memiliki nilai on, Google 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. Permintaan iklan dengan parameter adtest 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 menggunakannya 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 Anda atau oleh Manajer Akun Teknis Anda. Pelajari lebih lanjut channel 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 yang diminta atau penelusuran terkait. 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 tempat 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 yang diberi izin dan tidak diberi izin cookie.
Secara default, IVT ditetapkan ke true. 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 kosong <div> tempat iklan akan muncul.
Contoh: 'container' : 'afscontainer1' |
maxTop
|
Wajib diisi saat 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 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 memastikannya 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 muncul di unit ini. Nilai defaultnya adalah 2. Contoh: 'number' : 4 |
||||||||
relatedSearches
|
Opsional Jumlah penelusuran terkait yang akan muncul di unit ini. Jika tidak ditentukan, setelan defaultnya adalah 0. Contoh: 'relatedSearches' : 4 |