Menambahkan dukungan iklan pengiring

Pilih platform: HTML5 Android iOS

Panduan ini ditujukan bagi penayang yang tertarik untuk menambahkan iklan pendamping ke penerapan Android IMA mereka.

Prasyarat

  • Aplikasi Android dengan IMA SDK yang terintegrasi. Lihat BasicExample jika Anda belum memiliki aplikasi dengan SDK yang terintegrasi. Jika Anda memerlukan bantuan untuk menerapkan IMA SDK di aplikasi, lihat Menyiapkan IMA SDK.
  • Tag iklan yang dikonfigurasi untuk menampilkan iklan pengiring. Jika Anda memerlukan sampel, lihat FAQ kami.

Menambahkan iklan pendamping ke aplikasi Anda

Ikuti langkah-langkah untuk menambahkan slot iklan pengiring dan menampilkan iklan pengiring di aplikasi Anda.

Membuat ViewGroup untuk menampilkan pendamping

Sebelum meminta pendamping, Anda harus membuat ruang untuknya di tata letak. Di XML tata letak, tambahkan elemen ViewGroup; contoh ini menggunakan LinearLayout. Pada langkah selanjutnya, Anda akan meneruskan referensi ke elemen ini ke AdDisplayContainer.

Jika Anda melakukan integrasi ke aplikasi BasicExample, tambahkan kode ini ke file activity_my.xml di bawah videoPlayerContainer.

activity_my.xml

<LinearLayout
  android:id="@+id/companionAdSlot"
  android:layout_width="match_parent"
  android:layout_height="250dp"
  android:layout_gravity="center_horizontal"
  android:gravity="center"
  android:orientation="vertical"
  android:textAlignment="center" />

Membuat CompanionAdSlot

Langkah selanjutnya adalah membuat objek CompanionAdSlot, yang kemudian ditambahkan ke instance ArrayList<CompanionAdSlot>. Antarmuka AdDisplayContainer menggunakan daftar slot iklan pendamping sehingga Anda dapat menampilkan beberapa iklan pendamping sekaligus. Anda perlu membuat instance class ImaSdkFactory untuk membuat objek CompanionAdSlot.

ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
companionAdSlot.setContainer(companionViewGroup);
companionAdSlot.setSize(300, 250);
ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
companionAdSlots.add(companionAdSlot);

Buat slot iklan pengiring untuk setiap ukuran pengiring yang ingin Anda tampilkan di aplikasi Anda. IMA SDK mengisi slot iklan pengiring dengan pengiring apa pun dari respons VAST yang memiliki dimensi yang cocok dengan tinggi dan lebar tampilan. IMA SDK juga mendukung penggunaan pengiring berukuran fleksibel. Setelah membuat companionAdSlots, tambahkan ke AdsLoader. Contoh berikut menunjukkan cara melakukannya, bergantung pada apakah Anda menggunakan Ekstensi Exoplayer-IMA, atau implementasi IMA lain yang tidak menggunakan ekstensi.

Ekstensi Exoplayer-IMA

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

Implementasi lainnya

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

Selesai. Aplikasi Anda kini menampilkan iklan pendamping.

Menampilkan iklan pengiring yang lancar

IMA mendukung iklan pengiring yang dapat menyesuaikan. Iklan pendamping ini dapat diubah ukurannya agar sesuai dengan ukuran slot iklan. Iklan ini mengisi 100% lebar tampilan induk, lalu mengubah ukuran tingginya agar sesuai dengan konten pendamping. Ukuran ini ditetapkan dengan menggunakan ukuran iklan pengiring Fluid di Ad Manager. Lihat gambar berikut untuk mengetahui tempat menetapkan nilai ini.

Gambar yang menampilkan setelan iklan pendamping Ad Manager. Menandai opsi ukuran pengiring.

Mengupdate aplikasi Android untuk perangkat pendamping yang lancar

Anda dapat mendeklarasikan slot pendamping adaptif dengan memperbarui metode CompanionAdSlot.setSize() untuk mengambil CompanionAdSlot.FLUID_SIZE sebagai kedua parameter.

ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
companionAdSlot.setContainer(companionViewGroup);
companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
companionAdSlots.add(companionAdSlot);

FAQ

Saya telah mengikuti panduan, tetapi tidak melihat iklan pengiring. Apa yang harus saya lakukan?
Pertama, periksa untuk memastikan tag Anda benar-benar menampilkan pendamping. Untuk melakukannya, buka tag di browser web dan cari tag <CompanionAds>. Jika Anda melihatnya, periksa untuk memastikan ukuran pendamping yang ditampilkan sama dengan ukuran dimensi yang Anda teruskan ke objek CompanionAdSlot.
Seperti apa tampilan slot iklan pendamping saya saat mengikuti panduan ini?

Gambar berikut dibuat dari BasicExample dan menampilkan video konten yang diputar di atas dengan iklan pendamping di bawahnya.

Gambar contoh iklan pengiring IMA Android.