Iklan pengiring

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

Prasyarat

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

Penjelasan dasar yang bermanfaat

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

Menambahkan iklan pengiring ke aplikasi

Buat ViewGroup untuk menampilkan pendamping Anda

Sebelum meminta pendamping, Anda harus membuat ruang untuknya di tata letak. Dalam XML tata letak Anda, tambahkan elemen ViewGroup; contoh ini menggunakan LinearLayout. Pada langkah selanjutnya, Anda akan meneruskan referensi ke elemen ini ke AdDisplayContainer. Jika Anda mengintegrasikan ke aplikasi BasicExample, tambahkan ini ke activity_my.xml di bawah com.google.android.exoplayer2.ui.PlayerView.

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 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 dapat menyesuaikan. Setelah dibuat, companionAdSlots 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 lain yang tidak menggunakan ekstensi.

BasicExample

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

Implementasi lainnya

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

Itu saja! Aplikasi Anda kini menampilkan iklan pengiring.

Tampilkan iklan pengiring yang dapat menyesuaikan

IMA kini 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 ukuran tingginya agar sesuai dengan konten pengiring. Aset 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 pendamping yang dapat menyesuaikan 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 panduan, tetapi tidak melihat iklan pengiring. Apa yang sebaiknya saya lakukan?

Pertama, periksa untuk memastikan tag Anda benar-benar mengembalikan pengiring. Untuk melakukannya, buka tag di browser web dan cari tag CompanionAds. Jika Anda melihatnya, periksa untuk memastikan 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 di bawah dibuat dari BasicExample dan video konten diputar di atas dengan iklan pengiring di bawah ini.