FAQ Google Interactive Media Ads SDK


Mengapa iklan saya tidak ditampilkan lagi untuk semua format?
Tag iklan pengujian disiapkan agar selalu menampilkan iklan untuk permintaan yang valid. Ini adalah yang dimaksudkan untuk memfasilitasi integrasi dan meminta dan merender iklan. Namun, iklan tidak selalu tersedia di setiap untuk situs, akun, atau unit iklan Anda. Jika integrasi Anda berfungsi untuk tag pengujian, tetapi tidak untuk tag Anda sendiri, penyebabnya mungkin salah satu hal berikut:
  • Anda menayangkan video dengan format yang tidak didukung ke lingkungan Anda. Misalnya, Anda hanya menayangkan iklan HTML5 ke iOS atau Android.
  • Jika Anda menggunakan Ad Manager, ID penayang Anda tidak boleh memiliki iklan yang ditargetkan ke pada saat ini. Selain itu, pastikan Anda telah menyetujui iklan yang relevan dan materi iklan di Ad Manager.
  • Jika Anda menggunakan AdSense, kriteria penargetan untuk situs atau halaman percobaan mungkin tidak memiliki iklan aktif. Penyebab yang paling umum adalah penggunaan situs pribadi yang tidak di-crawl.
  • Jika Anda menggunakan Pengelolaan Partner Jaringan Ad Exchange dan descriptionURL tidak ditetapkan atau tidak dimiliki atau dioperasikan daftar pengelolaan domain, iklan tidak ditayangkan ke sini.
  • Periksa nilai minimum minCPM yang ditentukan dalam Video Ad Exchange. J CPM yang cukup tinggi dapat menghasilkan rasio pengisian yang sangat rendah. Untuk memperbaikinya, coba menghapus CPM min. atau menghapus parameter unit iklan dari permintaan iklan (yaitu, slotname) untuk memverifikasi apakah ini memengaruhi rasio pengisian.
Seperti apa tampilan descriptionUrl yang baik?
Agar lebih efektif, konten halaman yang descriptionUrl sebaiknya tidak berupa kumpulan kata atau frasa, melainkan Buat 1-3 paragraf yang sebenarnya menggambarkan konten dan peran Anda dalam menyediakannya. Salah satu metode yang telah berhasil di masa lalu adalah dengan menggabungkan Konten halaman descriptionUrl secara dinamis dari pemblokiran yang telah ditentukan sebelumnya. Misalnya, beberapa kalimat tentang konten, beberapa kalimat tentang yang ditawarkan situs tersebut, lalu beberapa cuplikan singkat yang terkait Saluran AdSense (seperti "Hiburan" atau "Olahraga"). Hasilnya, setiap bagian dari konten memiliki descriptionUrl yang cukup berbeda, yang terkait dengan yang memberikan informasi umum (seperti deskriptor genre) sebagai 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 pesan error "Respons iklan tidak berisi jenis iklan yang valid"?
Error ini biasanya muncul karena tidak ada iklan yang ditargetkan ke publisherId spesifik (untuk jangka waktu tertentu). Kondisi ini dapat bervariasi sepanjang hari, atau selama beberapa hari saat kampanye dimulai dan berakhir. Anda harus memeriksa bahwa iklan yang ingin Anda targetkan belum kedaluwarsa dan bahwa kriteria penargetan iklan Anda sudah benar. Selama iklan diminta, diterima, dan ditampilkan dengan benar menggunakan pengujian publisherId, Anda dapat memastikan bahwa iklan-iklan ini ditangani dengan benar menggunakan publisherId aktif saat iklan yang tersedia.
Apakah Anda memiliki tag iklan video Ad Manager yang dapat saya gunakan untuk pengujian?
Contoh tag tersedia di halaman contoh tag.
Haruskah saya menyetel adSlotWidth dan adSlotHeight ke nilai yang sama seperti sz di tag iklan Ad Manager saya?
Belum tentu. adSlotWidth dan adSlotHeight harus disetel ke lebar/tinggi pemutar atau area yang diinginkan untuk iklan akan terisi. Istilah ini digunakan oleh AdSense untuk menentukan iklan mana yang sesuai ke bidang tersebut. Pasangan kunci/nilai sz di tag iklan Ad Manager Anda adalah parameter penargetan dan tidak memengaruhi materi iklan yang ditayangkan (informasi selengkapnya ada di bawah).
Tag iklan demo terlihat bagus, tetapi ketika saya menggantinya dengan tag iklan, tidak ada iklan yang muncul.
Periksa untuk memastikan bahwa sesuatu diproses ke tag iklan yang Anda diminta. Cara termudah untuk mengetahuinya adalah dengan melihat lalu lintas HTTP. Jika Gambar 1x1 piksel grey.gif ditampilkan dalam blok anchor HTML, maka Anda harus memeriksa penargetan di Ad Manager.
Saya ingin meminta iklan menggunakan tag yang sama lebih dari sekali, tetapi saya hanya mendapatkan iklan untuk permintaan. Bagaimana cara mengatasinya?
Jika Anda meminta iklan lebih dari sekali, Anda harus memberi tahu server iklan bahwa permintaan ini adalah permintaan yang sah, dan bukan duplikat yang tidak disengaja. SDK melakukannya dengan dua panggilan API cepat:
  1. Panggil destroy() pada instance AdsManager Anda. Tindakan ini mencegah post-roll diputar saat Anda melakukan panggilan di bawah ini ke contentComplete(). Anda mendapatkan AdsManager baru ketika Anda membuat permintaan berikutnya.
  2. Telepon contentComplete() di AdsLoader Anda di instance Compute Engine. Ini akan menyetel ulang SDK sehingga permintaan iklan baru tidak terlihat seperti duplikat dari yang sebelumnya.
Setelah melakukan dua panggilan di atas, Anda dapat memanggil requestAds() di instance AdsLoader Anda guna mendapatkan kumpulan iklan lain untuk diputar untuk video baru.
Bagaimana cara meminta iklan AdSense overlay dan slot penuh menggunakan IMA SDK?

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

Iklan overlay
  1. Di AdsRequest, tetapkan ViewModes ke NORMAL.
  2. Di tag iklan Anda, tambahkan parameter overlay=1.
Iklan slot penuh
  1. Di AdsRequest, tetapkan ViewModes ke FULLSCREEN.
  2. Di tag iklan Anda, tambahkan parameter overlay=0.
Saya mendapatkan pesan "URL klik-tayang tidak valid" saat saya mengklik iklan. Apa kemungkinan penyebabnya?
Penyebab paling umum untuk kesalahan ini adalah klik-tayang yang di-escape dengan tidak benar . Jika Anda melihat kesalahan ini, periksa untuk memastikan bahwa klik-tayang Anda URL di-escape dengan benar dalam respons VAST Anda.
Mengapa saya melihat "Dokumen VAST Kosong" {i>error<i}?
Error ini terjadi ketika tag iklan menampilkan dokumen VAST kosong, yang menunjukkan bahwa iklan tidak ditayangkan dengan benar. Hubungi Account Manager Anda atau perwakilan server iklan untuk mengetahui penyebab 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.
Apakah kontrol video native didukung dengan HTML5 SDK?
Tidak, HTML5 SDK tidak mendukung kontrol native.
Saya melihat "Gagal menjalankan 'putar' di 'HTMLMediaElement': API hanya dapat dimulai dengan gestur pengguna" dalam implementasi HTML5. Bagaimana cara mengatasinya?
Di perangkat seluler, Anda harus memanggil adDisplayContainer.initialize() sebagai hasil dari tindakan pengguna (seperti ketukan). Jika Anda melihat {i>error<i} ini, kemungkinan besar Anda memanggilnya pada konteks yang tidak dimulai oleh pengguna. Perhatikan bahwa harus merupakan hasil langsung dari tindakan pengguna. Misalnya, jika Anda menanggapi "ketuk" peristiwa dengan memutar video, lalu menggunakan "putar" pemutar video acara untuk dipanggil initialize(), SDK akan menampilkan error ini. Anda harus memanggil initialize() sebagai sebagai hasil dari peristiwa ketuk itu sendiri.
Bagaimana cara menangani fokus keyboard pada klik iklan?
Jika Anda menggunakan kontrol keyboard untuk pemutar, Anda mungkin menyadari bahwa kontrol tersebut tidak akan berfungsi lagi mengikuti klik pada adDisplayContainer. Hal ini karena, setelah iklan diklik fokus keyboard dialihkan ke iframe IMA. Untuk mempertahankan fokus keyboard pada pemutar konten, harap memanfaatkan CLICK untuk mentransfer fokus keyboard kembali ke container yang diinginkan. Lihat cuplikan kode berikut untuk detail selengkapnya:
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });