Untuk pengguna tingkat lanjut, kami telah menyediakan daftar parameter gaya penelusuran yang saat ini didukung. Kode yang Anda buat di AdSense berisi semua setelan parameter yang paling sering digunakan. Ada dua parameter yang diperlukan: pubId dan query. AdSense menyediakan pubId, tetapi Anda harus mengedit kode dan meneruskan nilai untuk parameter query. Semua parameter lainnya bersifat opsional dan dijelaskan di bawah ini.
Jenis parameter
Ada dua jenis parameter:
- Parameter tingkat halaman yang berlaku untuk semua unit iklan pada halaman
- Parameter tingkat unit yang berlaku untuk unit iklan tunggal.
Berikut beberapa contoh output dari pembuat kode dengan dua unit iklan. Untuk mengonfigurasi kode ini, Anda harus menetapkan parameter query yang diperlukan dalam fungsi pageOptions (misalnya, “query”: myQuery). Hanya inilah yang diperlukan untuk mulai menampilkan iklan. Anda juga dapat menetapkan parameter tingkat halaman opsional di blok tingkat halaman serta parameter tingkat unit iklan tunggal pada fungsi adblock1 dan adblock2.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Parameter tingkat halaman
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parameter tingkat unit
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
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 Ini adalah kueri penelusuran yang dimasukkan oleh pengguna. Nilai parameter kueri harus dibatalkan encoding-nya. Contoh:
|
resultsPageBaseUrl |
Wajib jika ada unit penelusuran terkait di halaman Menentukan URL halaman hasil penelusuran di mana kueri penelusuran adalah istilah penelusuran terkait yang diklik pengguna. resultsPageBaseUrl dapat menyertakan parameternya sendiri, kecuali kueri penelusuran yang akan otomatis ditambahkan.
Contoh:
|
styleId |
Wajib Menentukan ID gaya penelusuran yang akan diterapkan ke unit penelusuran terkait atau iklan di halaman. Pelajari lebih lanjut cara menggunakan gaya penelusuran. 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
|
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' |
maxTermLength |
Opsional Menentukan jumlah maksimum karakter istilah penelusuran terkait termasuk spasi. Tidak ada jumlah maksimum jika tidak ditetapkan. Contoh: 'maxTermLength' : 50 |
referrerAdCreative |
Opsional Jika pengguna membuka halaman konten 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:
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. Contoh: 'terms' : 'cars rental, flight ticket' |
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:
Catatan: Secara default,
adsafe ditetapkan ke 'high'.Contoh: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Opsional Parameter adtest digunakan untuk menunjukkan bahwa permintaan untuk iklan merupakan sebuah 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 Catatan: 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 'off'. Contoh: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Opsional Anda dapat menyertakan saluran AdSense untuk Penelusuran untuk melacak performa berbagai halaman. Gunakan ID saluran unik yang Anda buat di akun AdSense. Pelajari lebih lanjut cara melacak performa iklan dengan saluran khusus. 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. Nilai default parameter ini adalah 'en'. Google mendukung semua kode bahasa Google Ads API. Catatan: Pengiklan menentukan bahasa yang akan ditargetkan oleh iklan mereka. Jika Anda menyertakan parameter ini dalam permintaan, 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 Contoh: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Opsional
Parameter Nilai default
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Opsional
Parameter Nilai default parameter
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Opsional Menentukan apakah pengguna telah memberikan izin kepada penayang untuk berbagi informasi pribadi dengan Google untuk tujuan iklan yang dipersonalisasi.
Catatan: Secara default,
personalizedAds ditetapkan ke 'true'.Contoh: 'personalizedAds': false |
Deskripsi parameter tingkat unit
Parameter berikut 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 dari penampung iklan yang kosong <div id='afscontainer1'></div> tempat iklan akan ditampilkan.
Contoh: |
maxTop |
Wajib
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: |
width |
Wajib Menentukan lebar unit 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/penelusuran terkait telah dimuat atau saat tidak ada iklan/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 { // cenderung tidak melakukan apa pun } catch (e) { alert ("Error in callback function"); // Melakukan sesuatu untuk menangani error dengan andal } } else { // seperti yang biasa Anda lakukan jika tidak ada cakupan iklan dari Google } } }; |
||||||||
number |
Opsional Jumlah iklan yang akan ditampilkan di unit ini. Nilai defaultnya adalah '2'. Contoh: |
||||||||
relatedSearches |
Opsional Jumlah penelusuran terkait yang akan ditampilkan di unit ini. Parameter ini menampilkan minimal tiga penelusuran terkait, kecuali jika ditetapkan ke nol. Jika tidak ditentukan, setelan defaultnya adalah 0. Contoh: 'relatedSearches' : 4 |
