Iklan banner mengisi suatu tempat dalam tata letak aplikasi, baik di atas ataupun di bawah layar perangkat. Mereka tetap berada di layar saat pengguna berinteraksi dengan aplikasi, dan dapat diperbarui secara otomatis setelah jangka waktu tertentu. Jika Anda baru saja periklanan seluler, iklan banner merupakan tempat yang tepat untuk memulai. Studi kasus.
Prasyarat
- Selesaikan Memulai.
- (Khusus Android) Memahami cara menggunakan referensi
jobject
JNI (lihat Tips JNI Android).
Selalu uji dengan iklan percobaan
Saat membuat dan menguji aplikasi, pastikan Anda menggunakan iklan percobaan, bukan iklan produksi secara langsung. Jika Anda tidak melakukannya, akun Anda dapat ditangguhkan.
Cara termudah untuk memuat iklan percobaan adalah dengan menggunakan ID unit iklan percobaan khusus untuk banner, yang bervariasi per platform perangkat:
- Android:
ca-app-pub-3940256099942544/6300978111
- iOS:
ca-app-pub-3940256099942544/2934735716
ID unit iklan ini telah dikonfigurasi secara khusus guna menampilkan iklan percobaan untuk setiap permintaan, dan Anda bebas menggunakannya di aplikasi Anda sendiri saat melakukan coding, menguji, dan proses debug. Pastikan Anda menggantinya dengan ID unit iklan Anda sendiri sebelum memublikasikan aplikasi Anda.
Untuk informasi selengkapnya tentang cara kerja iklan percobaan Mobile Ads SDK, lihat Iklan Percobaan.
Penerapan
Mengonfigurasi AdView
Iklan banner ditampilkan dalam objek AdView
, jadi langkah pertama menuju
mengintegrasikan iklan banner adalah dengan membuat dan memosisikan AdView
.
Tambahkan header berikut ke kode C++ aplikasi Anda:
#include "firebase/gma/ad_view.h"
Deklarasikan dan buat instance objek
AdView
:firebase::gma::AdView* ad_view; ad_view = new firebase::gma::AdView();
Buat
AdSize
dan lakukan inisialisasi tampilan iklan menggunakan indukAdParent
{i>view<i}. Tampilan induk adalah referensijobject
JNI keActivity
Android atau pointer ke transmisiUIView
iOS ke jenisAdParent
:// my_ad_parent is a jobject reference // to an Android Activity or a pointer to an iOS UIView. firebase::gma::AdParent ad_parent = static_cast<firebase::gma::AdParent>(my_ad_parent); firebase::Future
result = ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner); Sebagai alternatif untuk mempertahankan masa depan sebagai variabel, Anda dapat memeriksa status operasi inisialisasi secara berkala dengan memanggil
InitializeLastResult()
pada objekAdView
. Ini mungkin berguna bagi melacak proses inisialisasi dalam game loop global Anda.// Monitor the status of the future in your game loop: firebase::Future<void> result = ad_view->InitializeLastResult(); if (result.status() == firebase::kFutureStatusComplete) { // Initialization completed. if(future.error() == firebase::gma::kAdErrorCodeNone) { // Initialization successful. } else { // An error has occurred. } } else { // Initialization on-going. }
Untuk informasi selengkapnya tentang cara bekerja dengan
firebase::Future
, lihat Gunakan Future untuk memantau status penyelesaian metode panggilan telepon.
Tetapkan posisi iklan
Anda dapat menetapkan posisi AdView
kapan saja setelah diinisialisasi:
firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);
Memuat iklan
Anda dapat memuat iklan setelah AdView
diinisialisasi:
firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);
Objek AdRequest
mewakili satu permintaan iklan dan berisi properti untuk
informasi seperti penargetan.
Menampilkan iklan
Terakhir, tampilkan iklan di layar dengan memanggil Show()
. Metode ini dapat
dipanggil kapan saja setelah iklan diinisialisasi:
firebase::Future<void> result = ad_view->Show();
Peristiwa iklan
Google Mobile Ads C++ SDK menyediakan class AdListener
yang dapat Anda perluas
dan teruskan ke AdView::SetListener()
agar diberi tahu tentang perubahan pada iklan
status tampilan.
Memperluas metode di AdListener
bersifat opsional, jadi Anda hanya perlu mengimplementasikan
metode yang Anda inginkan. Di bawah ini adalah contoh implementasi class yang memperluas semua
dari class metode AdListener
:
class ExampleAdListener : public firebase::gma::AdListener { public: ExampleAdListener() {} void OnAdClicked() override { // This method is invoked when the user clicks the ad. } void OnAdClosed() override { // This method is invoked when the user closes the ad. } void OnAdImpression() override { // This method is invoked when an impression is recorded for an ad. } void OnAdOpened() override { // This method is invoked when an ad opens an overlay that covers the screen. } }; ExampleAdListener* ad_listener = new ExampleAdListener(); ad_view->SetAdListener(ad_listener);
Ukuran spanduk
Tabel di bawah mencantumkan ukuran banner standar.
Ukuran dalam titik (WxT) | Deskripsi | Ketersediaan | konstanta firebase::gma::AdSize |
---|---|---|---|
320x50 | Banner | Ponsel dan Tablet | kBanner |
320x100 | Banner Besar | Ponsel dan Tablet | kLargeBanner |
300x250 | Persegi Panjang Sedang IAB | Ponsel dan Tablet | kMediumRectangle |
468x60 | Banner Ukuran Penuh IAB | Tablet | kFullBanner |
728x90 | Papan Peringkat IAB | Tablet | kLeaderboard |
Lebar yang diberikan x Tinggi adaptif | Banner adaptif | Ponsel dan Tablet | T/A |
Ukuran iklan khusus
Untuk menentukan ukuran spanduk khusus, setel dimensi yang diinginkan menggunakan
firebase::gma::AdSize
dengan parameter lebar dan tinggi, seperti yang ditampilkan di sini:
firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);
Referensi lainnya
Contoh di GitHub
- Lihat kode sumber contoh aplikasi panduan memulai di GitHub.