Menambahkan dukungan iklan pengiring

Panduan ini ditujukan bagi penayang yang tertarik untuk menambahkan iklan pendamping ke penerapan IMA Android 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 contoh, lihat FAQ kami.

Menambahkan iklan pendamping ke aplikasi

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

Buat ViewGroup untuk menampilkan pendamping Anda

Sebelum meminta pendamping, Anda perlu 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 Anda.

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 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.

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 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 lainnya yang tidak menggunakan ekstensi.

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

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

Selesai. Aplikasi Anda kini menampilkan iklan pengiring.

Menampilkan iklan pengiring yang lancar

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

Mengupdate aplikasi Android untuk pendamping yang lancar

Anda dapat mendeklarasikan slot pendamping adaptif dengan memperbarui metode CompanionAdSlot.setSize() untuk mengambil 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, periksa untuk memastikan bahwa 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 jika mengikuti panduan ini?

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