Produk AdSense untuk Video dan AdSense untuk game menggunakan struktur pemberian tag yang sangat berbeda dengan AdSense untuk konten. Produk tersebut membutuhkan tag Iklan Media Interaktif (IMA), dan hanya mengembalikan iklan bila dipanggil dengan pemutar video atau peluncur game yang dapat mengintegrasikan IMA SDK Google, dan/atau sesuai dengan VAST dan VPAID (misalnya, Adaptor IMA).
Biasanya Anda dapat membuat tag tersebut melalui generator tag AdSense untuk Video. Di bawah ini, Anda akan menemukan daftar lengkap berbagai kriteria yang dapat Anda siapkan untuk tag iklan tersebut. Hanya ada beberapa parameter yang dibutuhkan agar tag AdSense untuk Video menayangkan iklan, namun Anda dapat meraih respons tag yang diinginkan dengan menambahkan parameter opsional seperti ID saluran, durasi iklan min./maks., bahasa, dll.
Parameter tag iklan IMA | Parameter yang dibutuhkan |
---|---|
ad_type | Ya |
client | Ya |
description_url | Ya - harus URL yang dikodekan |
channel | Tidak - Disarankan bila tersedia |
adsafe | Tidak - Disarankan |
videoad_start_delay | Tidak - Disarankan |
hl | Tidak - Disarankan |
max_ad_duration | Tidak - Disarankan |
min_ad_duration | Tidak - Disarankan |
sdmax | Tidak - Disarankan |
adtest | Tidak |
cust_age | Tidak |
cust_gender | Tidak |
host | Tidak |
h_ch | Tidak |
overlay | Tidak |
URL Dasar
URL berikut memberikan dasar untuk semua parameter kueri yang dijelaskan di bawah ini:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(String) Menentukan jenis iklan yang diinginkan. Ini harus digabungkan dengan menggunakan garis bawah (‘_’).
Nilai
- video: Semua iklan video: setara dengan standardvideo_skippablevideo_bumpervideo.
- skippablevideo: Hanya iklan video yang dapat dilewati. Mungkin perlu izin tambahan penayang untuk menerima iklan yang dapat dilewati.
- bumpervideo: Mengizinkan iklan video 6 detik yang tidak dapat dilewati.
- standardvideo: Hanya iklan video yang tidak dapat dilewati.
- image: Mengizinkan iklan gambar yang pas dengan ukuran slot non-linier yang ditentukan.
- text: Mengizinkan iklan teks.
Contoh
- &ad_type=video_text_image
- Mengizinkan semua format.
- &ad_type=video_text
- Mengizinkan format video dan iklan teks.
- &ad_type=standardvideo_image
- Mengizinkan iklan video dan gambar standar yang tidak dapat diabaikan.
client
(String) ID Properti Web penayang.
Contoh: &client=ca-video-afvtest
description_url
(String) URL penuh yang dikodekan URL dari halaman HTML yang menjelaskan video. Nilai description_url dapat dibuat secara dinamis menggunakan bahasa pemrograman sisi server, atau secara manual dengan menggunakan alat enkode URL online.
Contoh: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
Contoh URL
Berikut adalah contoh URL yang berisi parameter minimum yang dibutuhkan. https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
Meminta iklan video untuk penayang, ca-video-afvtest, dengan URL deskripsi http:// myurl.com/page?key=value&key2=value2
channel
(String) Daftar saluran yang dibatasi dengan tanda plus yang digunakan untuk penargetan dan pelaporan AdSense. Maksimal lima saluran yang diperbolehkan lewat di setiap permintaan iklan.
Contoh: &channel=mychannel+otherchannel+targetingchannel
adsafe
(String) Menentukan setelan yang digunakan untuk memfilter iklan yang tampil. Setelan default adalah “high”.
Nilai:
- high --(Default) Menampilkan iklan yang aman bagi keluarga. Tidak menampilkan iklan yang tidak aman bagi keluarga atau yang mengandung konten seksual dewasa.
- medium --Menampilkan iklan yang aman bagi keluarga dan yang tidak aman bagi keluarga (seperti iklan untuk perjudian atau obat resep). Tidak menampilkan iklan konten seksual dewasa.
Contoh: &adsafe=high
adtest
(String) Menentukan apakah hal ini merupakan penerapan percobaan. Nilai yang dapat dipakai adalah "on" atau "off". Jika ditetapkan ke "on", tayangan dan klik tidak akan dicatat di akun AFV. Parameter ini HARUS digunakan selama pengujian. Setelan default ditetapkan pada "off" jika tidak ditetapkan.
Nilai:
- off --(Default) Semua iklan akan ditagih seperti biasa. Ini merupakan setelan yang harus digunakan untuk produksi.
- on --Setelan ini memastikan bahwa tidak ada tayangan log iklan atau klik yang digunakan selama pengujian.
Contoh: &adtest=on
videoad_start_delay
(Bilangan bulat) Jumlah milidetik dari video ketika iklan akan diputar. Setelan default ditetapkan pada nilai paruh putar, “1,” secara khusus.
Nilai:
- -1 --Menentukan iklan pasca-putar yang akan ditampilkan di akhir konten
- 0 --Menentukan iklan pra-putar yang akan ditampilkan sebelum pemutaran konten dimulai
- Bilangan bulat positif apa pun --Menentukan iklan paruh-putar yang akan diputar setelah jumlah milidetik pemutaran konten ini.
Contoh:
- &videoad_start_delay=-1 --Pasca-putar.
- &videoad_start_delay=15000 --Iklan akan diputar pada detik ke-15 dari konten.
cust_age
(Bilangan bulat) Menentukan usia pengguna. Usia yang tepat didukung serta kelompok usia yang ditetapkan di com.google.ads.ima.api.Demographics.
Contoh:
- &cust_age=1001 --Usia 18 sampai 24 tahun
- &cust_age=38 --Tepat 38 tahun
cust_gender
(Bilangan bulat) Menentukan jenis kelamin pengguna sebagaimana ditetapkan di com.google.ads.ima.api.Demographics.
Nilai:
- 1 --Pria
- 2 -- Wanita
Contoh:
- &cust_gender=1 --Pria
- &cust_gender=2 --Wanita
host
(String) ID Host yang akan digunakan untuk pembagian hasil 3 arah.
Example: &host=ca-host-test --Membagi pendapatan dengan host ini.
h_ch
(String) Daftar string yang dibatasi tanda tambah yang mewakili ID saluran penargetan/pelaporan AdSense untuk host.
Contoh: &h_ch=channel1+channel2+channel3 --Melaporkan dan menargetkan saluran tambahan tersebut untuk host.
ht_id
(Angka) ID Tingkatan yang digunakan untuk menentukan tingkat bagi hasil antara penayang dan host.
Contoh: &ht_id=2 --Host tingkat 2.
hl
(String) Kode bahasa yang digunakan untuk meminta iklan dalam bahasa tersebut. Ini boleh berupa kode ISO 639-1 (dua huruf) atau ISO 639-2 (tiga huruf). Daftar kode yang valid.
Contoh:
- &hl=en --Inggris.
- &hl=es --Spanyol
max_ad_duration
(Bilangan bulat) Menentukan durasi video maksimum yang harus ditampilkan dalam milidetik. Jika tidak ditetapkan, defaultnya 100 detik.
Contoh: &max_ad_duration=30000 --Durasi maksimum iklan yang tidak dapat diabaikan adalah 30 detik.
min_ad_duration
(Bilangan bulat) Menentukan durasi video minimum yang harus ditampilkan dalam milidetik. Jika tidak ditetapkan, defaultnya 0 detik.
Contoh:
- &min_ad_duration=15000 --Durasi iklan yang tidak dapat diabaikan yang ditampilkan harus minimum 15 detik atau lebih lama.
- &min_ad_duration=0 --Durasi hanya akan dibatasi oleh nilai max_ad_duration.
sdmax
(Bilangan bulat) Menentukan durasi video maksimum untuk iklan yang dapat diabaikan dalam milidetik. Jika tidak ditetapkan, defaultnya tidak terbatas .
Contoh: &sdmax=120000 --Durasi iklan yang dapat diabaikan yang ditampilkan tidak boleh lebih dari 2 menit.
overlay
(Bilangan bulat) Digunakan untuk membatasi ukuran hamparan yang diminta menjadi hanya hamparan sepertiga bagian bawah non-linier. Secara default, tidak ada batas yang akan ditetapkan.
Contoh:
- &overlay=1 --Hanya ukuran hamparan sepertiga bagian bawah yang valid dalam permintaan iklan. Hamparan slot penuh tidak akan diminta.
- &overlay=0 --Nilai default, yang tidak menetapkan batas ukuran hamparan. Ukuran hamparan akan disajikan berdasarkan AdsRequest.nonLinearAdSlotWidth dan adsRequest.nonLinearAdSlotHeight.