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.