Iklan pengiring

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

Prasyarat

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

Panduan dasar yang bermanfaat

Jika Anda masih perlu menerapkan IMA SDK di aplikasi, lihat Panduan Memulai.

Menambahkan iklan pendamping ke aplikasi

Membuat ViewGroup untuk menampilkan pendamping

Sebelum meminta pendamping, Anda harus membuat ruang untuknya dalam 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. Jika Anda berintegrasi ke aplikasi BasicExample, tambahkan ini ke 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 berikutnya adalah mem-build objek CompanionAdSlot, yang kemudian ditambahkan ke ArrayList<CompanionAdSlot>. AdDisplayContainer mengambil daftar slot iklan pengiring sehingga Anda dapat menampilkan beberapa iklan pengiring sekaligus. Anda harus membuat instance ImaSdkFactory untuk membuat 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 pendamping untuk setiap ukuran pendamping yang ingin Anda tampilkan di aplikasi. IMA SDK mengisi slot iklan pendamping dengan pendamping dari respons VAST yang memiliki dimensi yang cocok dengan tinggi dan lebar tampilan. IMA SDK juga mendukung penggunaan pengiring berukuran fleksibel. Setelah Anda membuat companionAdSlots, AdsLoader harus ditambahkan ke AdsLoader. Contoh berikut menunjukkan cara melakukannya, bergantung pada apakah Anda menggunakan IMA Android BasicExample yang menggunakan ekstensi Exoplayer-IMA, atau implementasi IMA lainnya yang tidak menggunakan ekstensi.

BasicExample

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 fleksibel

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

Mengupdate aplikasi Android untuk pendamping yang fleksibel

Anda dapat mendeklarasikan slot pendamping yang fleksibel dengan memperbarui metode CompanionAdSlot.setSize() untuk menggunakan 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 panduannya, 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 melihat hal itu, periksa untuk memastikan ukuran pengiring yang ditampilkan sama dengan dimensi yang Anda teruskan ke objek CompanionAdSlot.

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

Gambar di bawah dibuat dari BasicExample dan memiliki video konten yang diputar di atas dengan iklan pendamping di bawah.