FAQ Google Interactive Media Ads SDK

Stay organized with collections Save and categorize content based on your preferences.

Mengapa saya tidak menampilkan iklan untuk semua format?
Tag iklan percobaan disiapkan agar selalu menampilkan iklan untuk permintaan yang valid. Hal ini dimaksudkan untuk memfasilitasi integrasi dan mempermudah pengujian cara pemutar Anda meminta dan merender iklan. Namun, iklan tidak selalu tersedia dalam setiap format untuk situs, akun, atau unit iklan Anda. Jika integrasi Anda berfungsi dengan baik untuk tag pengujian, tetapi tidak untuk tag Anda sendiri, penyebabnya mungkin salah satu dari hal berikut:
  • Anda menayangkan video dalam format yang tidak didukung ke lingkungan Anda. Misalnya, Anda hanya menayangkan iklan HTML5 ke iOS atau Android.
  • Jika Anda menggunakan Ad Manager, saat ini ID penayang Anda mungkin tidak memiliki iklan yang ditargetkan. Selain itu, pastikan Anda telah menyetujui iklan dan materi iklan yang relevan di Ad Manager.
  • Jika Anda menggunakan AdSense, kriteria penargetan untuk situs atau halaman pengujian mungkin tidak memiliki iklan aktif. Penyebab paling umum adalah penggunaan situs pribadi yang tidak di-crawl.
  • Jika Anda menggunakan Pengelolaan Partner Jaringan Ad Exchange dan descriptionURL tidak ditetapkan atau tidak ada dalam daftar pengelolaan domain yang dimiliki atau dioperasikan, iklan tidak akan ditayangkan untuk iklan ini.
  • Periksa nilai minimum minCPM yang ditentukan di Video Ad Exchange. CPM yang cukup tinggi dapat menyebabkan rasio pengisian yang sangat rendah. Untuk memperbaiki masalah ini, coba hapus minCPM atau hapus parameter unit iklan dari permintaan iklan (yaitu, nama slot) untuk memverifikasi apakah hal ini memengaruhi rasio pengisian atau tidak.
Seperti apa bentuk descriptionUrl yang baik?
Agar lebih efektif, konten halaman yang ditunjuk descriptionUrl tidak boleh berupa kumpulan kata atau frasa, melainkan 1-3 paragraf yang sebenarnya menggambarkan konten dan peran Anda dalam menyediakannya. Salah satu metode yang telah berhasil sebelumnya adalah menggabungkan konten halaman descriptionUrl secara dinamis dari blok yang telah ditetapkan. Misalnya, beberapa kalimat tentang konten, beberapa kalimat tentang penawaran situs Anda, dan beberapa cuplikan standar yang terkait dengan setiap saluran AdSense (seperti "Hiburan" atau "Olahraga"). Akibatnya, setiap bagian konten memiliki descriptionUrl yang cukup berbeda yang terkait dengannya dan menyediakan informasi umum (seperti deskriptor genre) serta informasi spesifik (konten tentang konten secara langsung).

HTML metadata ini harus sederhana, misalnya:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
  
Mengapa saya menerima error "Respons iklan tidak berisi jenis iklan yang valid"?
Error ini umumnya muncul karena tidak ada iklan yang ditargetkan ke publisherId tertentu (untuk jangka waktu tertentu). Kondisi ini dapat bervariasi sepanjang hari, atau selama beberapa hari saat kampanye dimulai dan berakhir. Anda harus memeriksa apakah iklan yang ingin ditargetkan belum habis masa berlakunya dan kriteria penargetan iklan sudah benar. Selama iklan diminta, diterima, dan dirender dengan benar menggunakan publisherId pengujian, Anda dapat memastikan bahwa iklan tersebut ditangani dengan benar menggunakan publisherId aktif saat iklan tersedia.
Apakah Anda memiliki tag iklan video Ad Manager yang dapat digunakan untuk pengujian?
Contoh tag tersedia di halaman tag contoh.
Haruskah saya menetapkan adSlotWidth dan adSlotHeight ke nilai yang sama dengan sz di tag iklan Ad Manager saya?
Belum tentu. adSlotWidth dan adSlotHeight harus ditetapkan ke lebar/tinggi pemutar atau area yang Anda inginkan untuk diisi oleh iklan. Iklan ini digunakan oleh AdSense untuk menentukan iklan yang sesuai untuk ruang tersebut. Pasangan kunci/nilai sz di tag iklan Ad Manager Anda adalah parameter penargetan dan tidak selalu memengaruhi materi iklan yang ditayangkan (informasi selengkapnya di bawah).
Tag iklan demo terlihat bagus, tetapi saat saya beralih dengan tag iklan, tidak ada iklan yang muncul.
Periksa untuk memastikan bahwa sesuatu diproses untuk tag iklan yang Anda minta. Cara termudah untuk mengetahuinya adalah dengan melihat traffic HTTP. Jika gambar 1x1 piksel grey.gif ditampilkan dalam blok anchor HTML, Anda perlu memeriksa penargetan di Ad Manager.
Saya ingin meminta iklan menggunakan tag yang sama lebih dari sekali, tetapi saya hanya mendapatkan iklan untuk permintaan pertama saya. Bagaimana cara mengatasinya?
Saat meminta iklan lebih dari sekali, Anda perlu memberi tahu server iklan bahwa ini adalah permintaan yang sah, dan bukan merupakan duplikat yang tidak disengaja. SDK melakukan hal ini untuk Anda dengan dua panggilan API cepat:
  1. Panggil destroy() pada instance AdsManager Anda. Hal ini mencegah pemutaran post-roll jika Anda melakukan panggilan di bawah ke contentComplete(). Anda akan mendapatkan AdsManager baru saat membuat permintaan berikutnya.
  2. Panggil contentComplete() pada instance AdsLoader Anda. Tindakan ini akan mereset SDK, sehingga permintaan iklan baru tidak terlihat seperti duplikat dari iklan sebelumnya.
Setelah melakukan dua panggilan di atas, Anda dapat memanggil requestAds() di instance AdsLoader untuk mendapatkan kumpulan iklan lain yang akan diputar untuk video baru Anda.
Bagaimana cara meminta iklan overlay slot penuh dan AdSense menggunakan IMA SDK?

Untuk meminta iklan AdSense menggunakan SDK, Anda harus mendapatkan tag iklan AdSense terlebih dahulu. Anda dapat mempelajari lebih lanjut hal itu di halaman AdSense untuk Video. Setelah memiliki tag, Anda perlu melakukan langkah-langkah berikut untuk membuat permintaan iklan overlay atau slot penuh:

Iklan overlay
  1. Di AdsRequest, setel ViewMode ke NORMAL.
  2. Di tag iklan, tambahkan parameter overlay=1.
Iklan slot penuh
  1. Di AdsRequest, setel ViewMode ke FULLSCREEN.
  2. Di tag iklan, tambahkan parameter overlay=0.
Saya menerima pesan error "URL klik-tayang tidak valid" saat mengklik iklan saya. Apa kemungkinan penyebabnya?
Penyebab paling umum error ini adalah URL klik-tayang yang di-escape dengan tidak benar. Jika melihat error ini, periksa untuk memastikan bahwa URL klik-tayang di-escape dengan benar dalam respons VAST.
Di SDK Android dan iOS, apakah ada cara untuk membuat seluruh iklan video dapat diklik?
Untuk pelacakan klik video secara keseluruhan, pengalaman penonton standar untuk video seluler yang muncul adalah bahwa mengetuk video dapat menjeda atau memunculkan kontrol pemutar. Untuk menghindari pengguna mengklik iklan secara tidak sengaja saat mereka benar-benar hanya ingin mengakses kontrol pemutar, IMA menggunakan tombol Pelajari lebih lanjut untuk memungkinkan pengguna mengklik iklan dan mempelajari lebih lanjut produk yang diiklankan.
Mengapa saya melihat error "Dokumen VAST Kosong"?
Error ini terjadi jika tag iklan menampilkan dokumen VAST kosong, yang menunjukkan bahwa iklan tidak ditayangkan dengan benar. Hubungi Account Manager atau perwakilan server iklan Anda untuk mengetahui alasan tag iklan tidak berfungsi.
Dapatkah saya mengubah ukuran/teks kotak Lewati Iklan atau elemen UI lainnya?
IMA SDK tidak mendukung perubahan tata letak, ukuran, atau konten elemen UI. Untuk detail selengkapnya tentang elemen UI, lihat AdsManager.uiElements.
Mengapa saya mendapatkan error "Tidak ada metode virtual" saat runtime?

Pesan error yang serupa dengan yang berikut disebabkan oleh penggunaan layanan Google Play versi lama yang tidak menyertakan ID iklan.

No virtual method
getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in
class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its
super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'

Upgrade ke versi 4.0 atau yang lebih baru (tetapi sebaiknya yang terbaru) akan menyelesaikan masalah ini.

Dapatkah saya menggunakan beberapa thread untuk menginisialisasi dan memanipulasi UI?
Tidak, semua inisialisasi dan manipulasi UI harus dilakukan pada thread utama. Di Android, objek UI tidak aman untuk thread. Lihat Thread untuk informasi selengkapnya.