Referensi

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 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, 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:
  • 'content' Gunakan opsi ini untuk Penelusuran Terkait di halaman Konten (misalnya, artikel, postingan blog).
  • 'query' Gunakan opsi ini secara eksklusif untuk Penelusuran Terkait di halaman hasil Penelusuran.

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:

  • Fitur penelusuran terkait tertentu dapat diaktifkan atau dinonaktifkan, bergantung pada nilai parameter halaman ini.
  • Menyalahgambarkan jenis halaman atau mengandalkan setelan 'kueri' default untuk parameter relatedSearchTargeting di halaman hasil non-penelusuran dianggap sebagai pelanggaran terhadap petunjuk tertulis ini.
  • Google dapat memverifikasi akurasi nilai ini secara berkala, terlepas dari apakah nilai tersebut ditetapkan secara manual atau menggunakan default.

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.
  • '_top' Membuka hasil di jendela yang sama.
  • '_blank' Dibuka di jendela baru.

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:

  • 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 boleh digunakan pada traffic organik.
  • Judul harus menyertakan baris judul, deskripsi, dan/atau kata-kata lain dalam materi iklan link atau iklan.
  • Menghapus nilai dari materi iklan atau link (atau menyertakan nilai tambahan) dianggap sebagai pelanggaran terhadap petunjuk tertulis ini.
  • 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.

Catatan: Parameter ini wajib saat menggunakan parameter terms.

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, referrerAdCreative juga diperlukan dan relatedSearchTargeting diperlukan serta harus ditetapkan ke 'content'.

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:

  • Parameter hanya boleh diberikan ke permintaan Penelusuran Terkait untuk Konten, dan akan diabaikan untuk semua permintaan lainnya.
  • Nilai parameter ini harus berupa daftar parameter URL yang dipisahkan koma yang dapat muncul saat pengguna membuka halaman konten.
  • Hal ini bersifat peka huruf besar atau kecil.
  • Jika parameter URL dari daftar ini dihapus dari URL halaman konten, tidak akan ada dampak signifikan pada konten, tampilan, atau pengalaman pengguna halaman.
  • Menyertakan parameter URL yang secara signifikan memengaruhi konten, tampilan, atau pengalaman pengguna halaman dianggap sebagai pelanggaran terhadap petunjuk tertulis ini.
  • Google dapat memverifikasi efek mengabaikan parameter URL yang diberikan secara berkala.

Contoh:
Pengguna mengunjungi halaman konten dan URL-nya adalah:

http://example.com/content?utm_medium=social&page_id=123&click_id=456
Memberikan 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:
  • 'high' Menampilkan iklan yang cocok bagi keluarga. Tidak menampilkan iklan yang tidak aman bagi keluarga atau yang berisi konten seksual dewasa.
  • 'medium' Menampilkan iklan yang cocok bagi keluarga dan yang tidak cocok bagi keluarga. Tidak menampilkan iklan konten seksual dewasa.
  • 'low' Menampilkan semua jenis iklan.

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 ie menetapkan skema encoding karakter yang harus digunakan untuk menafsirkan string kueri.

Nilai ie default 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
arab ISO-8859-6  
Yunani ISO-8859-7 Yunani
ibrani ISO-8859-8 Ibrani
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islan
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 oe default 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
arab ISO-8859-6  
Yunani ISO-8859-7 Yunani
ibrani ISO-8859-8 Ibrani
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islan
euc-jp EUC-JP Jepang
euc-kr EUC-KR Korea
sjis Shift_JIS Jepang
gb GB2312 China Aksara Sederhana
utf-8 UTF-8 Semua
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.
  • true Jika parameter ini tidak ada atau Anda menetapkannya ke "true", kami akan menetapkan cookie khusus traffic tidak valid dan menggunakan penyimpanan lokal hanya pada traffic yang memiliki izin cookie.
  • false Jika Anda menetapkan parameter ini ke "false", kami akan menetapkan cookie khusus traffic tidak valid dan menggunakan penyimpanan lokal 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:

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 peta.

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