Panduan teknis memulai cepat (AFG)

Gunakan panduan ini untuk mempelajari cara berintegrasi dengan IMA HTML5 SDK Google untuk menayangkan iklan di game web HTML 5 dengan AdSense. 

Ringkasan penyiapan teknis

AdSense untuk Game beroperasi menggunakan Interactive Media Ads Software Development Kit (IMA HTML5 SDK) Google. SDK ini memungkinkan Anda meminta iklan AdSense melalui JavaScript untuk lebih menyelaraskan konten dan iklan.

Catatan: Produk tersebut tunduk pada Persyaratan & Ketentuan AdSense, kebijakan program AdSense, dan panduan penggunaan spesifik per produk. Perhatikan bahwa klik tidak disengaja yang berasal dari penerapan yang terlalu agresif atau salah akan mengakibatkan tindakan hingga (dan termasuk) penghentian akun.

Untuk meminta dan menampilkan iklan melalui IMA HTML5 SDK, siapkan permintaan iklan, muat iklan yang dihasilkan, dan putar iklan tersebut pada waktu yang tepat. Uji integrasi Anda menggunakan ID penayang default ca-games-pub-4968145218643279.

Perhatikan bahwa Anda harus memberikan contoh integrasi kepada Account Manager Anda sebelum Anda diizinkan untuk menerapkan iklan ke situs Anda.

Ada dua opsi integrasi, sederhana atau lanjutan. 

Integrasi sederhana

Opsi integrasi sederhana adalah cara termudah untuk mengintegrasikan AdSense untuk Game dengan game HTML5 Anda. Opsi ini memberikan solusi penerapan cepat yang menyediakan semua fitur dan format iklan di AdSense untuk Game.

Bagi penayang yang ingin menggunakan opsi integrasi sederhana ini, Anda dapat mendaftarkan minat Anda.

Integrasi lanjutan

Bagi penayang yang menginginkan integrasi kustom yang lebih kompleks, IMA HTML5 SDK lengkap harus diterapkan dengan game HTML5. Opsi ini memberikan fleksibilitas tambahan seperti fitur tertentu yang tersedia melalui Google Ad Manager, tetapi perlu diingat juga bahwa opsi ini dapat lebih rumit.

Memulai integrasi lanjutan

Untuk memulai, integrasikan IMA HTML5 SDK dengan game Anda.

1. Siapkan integrasi IMA HTML5 SDK

   Ikuti panduan di situs Google Developer untuk membuat integrasi IMA HTML5 SDK dengan game Anda. Ada beberapa langkah untuk memulai, beserta kode contoh yang dapat didownload, dan referensi API lengkap untuk membantu.

2. Siapkan penampung iklan (AdDisplayContainer)

   Karena IMA HTML5 SDK mengakomodasi penayang video dan game, objek AdDisplayContainer dapat dikonfigurasi dalam beberapa cara.

   Saat mengonfigurasi objek AdDisplayContainer untuk digunakan dengan AdSense untuk Game, cukup masukkan referensi ke div yang akan berisi iklan.

   Contoh:

   var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));

3. Konfigurasikan permintaan iklan (AdsRequest)

   Saat membuat objek AdsRequest, Anda harus memastikan bahwa parameter dan properti yang relevan dikonfigurasi dengan benar sehingga iklan dihasilkan dan ditampilkan dengan benar.

   Contoh:

   // Request AdSense for games ads.
var adsRequest = new google.ima.AdsRequest();
 
// Setup AdSense for games ad tag
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
 
// Force image/text ads to render with Full-Slot UI
adsRequest.forceNonLinearFullSlot = true;
 
// Specify the linear and nonlinear slot sizes.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height};

4. Pantau peristiwa yang relevan dan buat callback

   Penting untuk memantau peristiwa yang diaktifkan dalam IMA SDK, sehingga Anda mengetahui kapan harus berhenti menampilkan iklan, dan membiarkan pengguna lanjut memainkan game Anda.

   Berikut beberapa peristiwa iklan yang biasa digunakan untuk menentukan penempatan iklan dengan konten game Anda. Misalnya, Anda dapat memerhatikan peristiwa LENGKAP untuk mengetahui kapan iklan diputar sampai selesai, dan kemudian Anda dapat menampilkan konten game kepada pengguna. Daftar lengkap peristiwa iklan tersedia di referensi API.

   Nama peristiwa	Deskripsi
   AdEvent.Type.CLICK	Diaktifkan saat iklan diklik.
   AdEvent.Type.COMPLETE	Diaktifkan saat iklan selesai diputar.
   AdEvent.Type.LOADED	Diaktifkan saat data iklan tersedia.
   AdEvent.Type.SKIPPED	Diaktifkan saat iklan dilewati oleh pengguna.
   AdEvent.Type.START	Diaktifkan saat iklan mulai diputar.
   AdEvent.Type.USER_CLOSE	Diaktifkan saat iklan ditutup oleh pengguna.
   AdErrorEvent.Type.AD_ERROR	Diaktifkan saat terjadi peristiwa error. Ada banyak jenis error iklan berbeda yang dapat terjadi. Contohnya mencakup kegagalan memuat aset media iklan, atau respons iklan kosong ditampilkan di permintaan iklan. Daftar berisi kemungkinan error tersedia di referensi API.