Menambahkan dukungan iklan pengiring

Pilih platform: HTML5 Android iOS

Panduan ini ditujukan bagi penayang yang ingin menambahkan iklan pengiring ke implementasi IMA Android.

Prasyarat

  • Aplikasi Android dengan IMA SDK terintegrasi. Lihat BasicExample jika Anda belum memiliki aplikasi dengan SDK 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 contoh, lihat FAQ kami.

Menambahkan iklan pengiring ke aplikasi

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

Membuat ViewGroup untuk menampilkan pengiring

Sebelum meminta pengiring, Anda harus membuat ruang untuk pengiring di tata letak. Di XML tata letak, tambahkan elemen ViewGroup; contoh ini menggunakan LinearLayout. Pada langkah berikutnya, 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.

<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" />
companion_ad_slot_snippet.xml

Membuat CompanionAdSlot

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

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}

CompanionAdSnippets.java

Buat slot iklan pengiring untuk setiap ukuran pengiring yang ingin Anda tampilkan di aplikasi. 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 lainnya yang tidak menggunakan ekstensi.

Ekstensi Exoplayer-IMA

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}

CompanionAdSnippets.java

Implementasi lainnya

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}

CompanionAdSnippets.java

Selesai! Aplikasi Anda kini menampilkan iklan pengiring.

Menampilkan iklan pengiring fleksibel

IMA mendukung iklan pengiring fleksibel. Iklan pengiring ini dapat diubah ukurannya agar sesuai dengan ukuran slot iklan. Iklan pengiring mengisi 100% lebar tampilan induk, lalu mengubah ukuran tingginya agar sesuai dengan konten pengiring. Iklan pengiring ini ditetapkan menggunakan ukuran 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.

Memperbarui aplikasi Android untuk pengiring fleksibel

Anda dapat mendeklarasikan slot pengiring fleksibel dengan memperbarui CompanionAdSlot.setSize() agar menggunakan CompanionAdSlot.FLUID_SIZE sebagai kedua parameter.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

FAQ

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

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

Gambar contoh iklan pengiring IMA Android.