Menambahkan dukungan iklan pengiring

Panduan ini ditujukan bagi penayang yang tertarik untuk menambahkan iklan pengiring ke implementasi 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 pengiring ke aplikasi Anda

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

Membuat ViewGroup untuk menampilkan pengiring Anda

Sebelum meminta pengiring, Anda perlu membuat ruang untuk pengiring tersebut di tata letak. Dalam XML tata letak, tambahkan elemen ViewGroup; contoh ini menggunakan LinearLayout. Pada langkah berikutnya, Anda akan meneruskan referensi ke elemen ini ke AdDisplayContainer Anda.

Jika Anda mengintegrasikan ke aplikasi BasicExample, tambahkan 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 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. 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 yang dapat menyesuaikan. Setelah Anda 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.

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 fleksibel

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

Mengupdate aplikasi Android untuk pendamping yang lancar

Anda dapat mendeklarasikan slot pengiring fluid dengan memperbarui metode CompanionAdSlot.setSize() untuk menggunakan CompanionAdSlot.FLUID_SIZE sebagai kedua parameter.

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

FAQ

Saya telah mengikuti panduan, tetapi saya tidak melihat iklan pengiring. Apa yang harus saya lakukan?

Pertama, periksa untuk memastikan tag Anda benar-benar menampilkan pengiring. Untuk melakukannya, buka tag di browser web dan cari tag <CompanionAds>. Jika Anda melihatnya, periksa untuk memastikan ukuran pengiring yang ditampilkan sama dengan dimensi yang Anda teruskan ke objek CompanionAdSlot.

Seperti apa tampilan slot iklan pengiring saya jika mengikuti panduan ini?

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