Referensi

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 adPage menentukan tempat iklan halaman hasil ditampilkan. Parameter ini digunakan saat pengguna membuka halaman pertama hasil penelusuran. Misalnya, jika lima iklan diminta, dan parameter adPage ditetapkan ke 2, iklan yang ditampilkan akan menjadi halaman kedua dari lima iklan.

pubId Wajib
Ini adalah ID klien AdSense Anda. pubId Anda adalah bagian dari client-ID yang muncul setelah 'partner-'. Misalnya, jika client-ID Anda adalah 'partner-test-property', pubId 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 tidak dienkode.

Catatan: Menggunakan parameter ini pada 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 istilah penelusuran terkait yang telah diklik pengguna. ResultsPageBaseUrl dapat menyertakan URL sendiri parameter, kecuali kueri penelusuran yang akan otomatis ditambahkan.

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. Ini mengontrol jenis Pengalaman Penelusuran Terkait ditampilkan, bergantung pada konteks halamannya:
  • 'content' Gunakan opsi ini untuk Penelusuran Terkait di halaman Konten (misalnya, artikel, postingan blog tertentu).
  • 'query' Gunakan opsi ini secara eksklusif untuk Penelusuran Terkait di Halaman hasil penelusuran.

Catatan:Parameter halaman terkaitSearchTargeting akan otomatis ditetapkan ke 'kueri' secara {i>default<i}. Namun, penting untuk dicatat bahwa nilai {i>default<i} ini secara khusus dirancang untuk hanya halaman hasil penelusuran (Penelusuran Terkait di Penelusuran). Jika Anda menggunakan penelusuran terkait di jenis halaman lainnya (mis., artikel, postingan blog), Anda harus secara eksplisit tetapkan parameternya ke 'content'.

Catatan: Panduan berikut berlaku untuk penggunaan parameter ini:

  • Fitur penelusuran terkait tertentu mungkin diaktifkan atau dinonaktifkan, bergantung pada nilai parameter halaman web.
  • Tidak merepresentasikan jenis halaman atau mengandalkan 'kueri' default setelan untuk Parameter RelatedSearchTargeting pada halaman hasil non-penelusuran dianggap sebagai pelanggaran instruksi tertulis ini.
  • Google dapat memverifikasi keakuratan nilai ini secara berkala, terlepas dari apakah nilai tersebut disetel secara manual atau menggunakan {i>default<i}.

Contoh:

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId Wajib
Menentukan ID gaya penelusuran kustom yang akan diterapkan ke iklan atau unit penelusuran terkait di pada halaman. Pelajari lebih lanjut cara menggunakan gaya penelusuran kustom. Perhatikan bahwa dengan styleId ditetapkan untuk sebuah 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 terbuka di jendela yang sama atau baru jendela. Defaultnya adalah '_top'. Parameter ini juga dapat digunakan di tingkat unit.
  • '_top' Terbuka di jendela yang sama.
  • '_blank' Terbuka di jendela baru.

Contoh:

'linkTarget' : '_blank'
maxTermLength Opsional
Menentukan jumlah karakter maksimum 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 dari iklan tersebut atau link kata demi kata.

Panduan berikut berlaku untuk penggunaan parameter ini:

  • Parameter hanya boleh diberikan di permintaan Penelusuran Terkait untuk Konten, dan akan diabaikan pada semua permintaan lainnya.
  • Kunci ini hanya boleh digunakan pada traffic yang sengaja Anda dapatkan dari sumber lain situs, dan tidak boleh digunakan pada traffic organik.
  • Teks harus berisi baris judul, deskripsi, dan/atau kata lain di iklan atau link materi iklan.
  • Tidak mencantumkan nilai dari materi iklan link atau iklan (atau menyertakan nilai tambahan) dianggap sebagai pelanggaran atas instruksi tertulis ini.
  • ID ini tidak peka huruf besar/kecil.
  • Adaptor ini menerima encoding UTF-8 yang valid; karakter unicode / diakritik didukung.
  • Google dapat menggunakan atau mengabaikan parameter yang Anda kirimkan. Jika digunakan, hal ini dapat memengaruhi pilihan dan peringkat istilah.

Catatan: Parameter ini wajib ada 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, setelan defaultnya adalah 'q'.

Contoh:

'resultsPageQueryParam' : 'query'
terms Opsional
Parameter ini memungkinkan Anda menyediakan daftar istilah penelusuran terkait Anda sendiri yang dipisahkan dengan tanda koma ditampilkan dengan permintaan penelusuran terkait, meskipun Google mungkin atau mungkin tidak menggunakan persyaratan yang disediakan di sini.

Catatan: Saat menggunakan parameter ini, referrerAdCreative juga wajib dan relatedSearchTargeting wajib ada serta harus ditetapkan ke 'konten'.

Contoh:

'terms' : 'cars rental, flight ticket'
ignoredPageParams Opsional
Menentukan daftar parameter URL untuk halaman konten dengan Penelusuran Terkait untuk Konten unit iklan yang dapat diabaikan dengan aman tanpa memengaruhi konten inti atau pengalaman pengguna.

Catatan: Sebelum istilah penelusuran terkait dapat muncul di situs Anda, Google perlu melakukan crawling terhadap halaman Anda untuk memastikan istilah tersebut relevan secara kontekstual. Saat halaman belum di-crawl atau diblokir agar tidak dapat di-crawl (mis. 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 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 hasil yang istilah penelusuran yang tidak relevan. Parameter halaman ini menginstruksikan crawler Google untuk mengabaikan parameter yang tidak penting ini, memastikan pengindeksan konten yang tepat dan mengurangi crawling yang tidak perlu memuat halaman. Hal ini memungkinkan Google mengenali halaman yang telah di-crawl dengan lebih baik dan memulai menampilkan persyaratan yang disarankan (baik Google maupun partner, jika memenuhi syarat).

Panduan berikut berlaku untuk penggunaan parameter ini:

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

Contoh:
Pengguna mengunjungi halaman konten dan URL-nya:

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

Secara default, adsafe ditetapkan ke tinggi.

Contoh:

'adsafe': 'medium'
adtest Opsional
Parameter adtest digunakan untuk menunjukkan bahwa permintaan 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 "iklan percobaan" menjadi overlay dan tidak bisa 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 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 ie menetapkan skema encoding karakter yang harus digunakan untuk menafsirkan string kueri.

Nilai ie default adalah utf-8.

Nilai Nama standar Bahasa yang Didukung Terkait
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)
sirilik 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
sji 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 yang Didukung Terkait
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)
sirilik 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
sji 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 cookie khusus traffic tidak valid & penyimpanan lokal di traffic yang diberi izin dan tidak diberi 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 diberi izin.
  • false Jika Anda menetapkan parameter ini ke "false" kami akan menetapkan cookie khusus traffic tidak valid dan menggunakan penyimpanan lokal pada 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 'number' . Unit iklan ini harus cukup lebar agar baris pertama iklan tidak melebihi batas. Menggunakan maxTop di 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 diatur ke Fungsi callback JavaScript yang Anda terapkan yang 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 untuk ditampilkan dan false saat tidak ada iklan atau penelusuran terkait yang ditampilkan.
isExperimentVariant Tetapkan ke true jika eksperimen gaya kustom sedang berjalan dan varian dari eksperimen dipilih untuk merender iklan.
callbackOptions Objek JSON yang berisi kolom berikut:
termPositions: Untuk blok penelusuran terkait, berisi map<string,int> dari penayang yang diberikan istilah ke posisi indeks nol untuk istilah ini dalam respons. Jika persyaratan diberikan tetapi tidak dikembalikan, maka tidak akan muncul di peta.

Catatan: Uji fungsi callback Anda untuk memastikannya tidak menghasilkan error, terutama yang dapat mengganggu pemuatan laman 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