Panduan ini menunjukkan cara menggunakan add-on iklan native untuk menerapkan iklan native AdMob di aplikasi Unity, serta beberapa hal penting yang perlu dipertimbangkan selama prosesnya.
Iklan native sesuai dengan bentuk dan fungsi pengalaman pengguna tempat iklan tersebut berada. Iklan ini juga cocok dengan desain visual aplikasi tempat tinggalnya. Format iklan native AdMob memungkinkan penayang merender iklan tanpa kendala dengan konten. Anda dapat menggunakan teknologi ini untuk menerapkan rendering kustom yang benar-benar memanfaatkan kode native di aplikasi Unity.
Iklan native ditampilkan menggunakan jenis GameObjects
yang sama dengan yang sudah Anda
buat aplikasi dan dapat diformat agar cocok dengan desain visual
pengalaman pengguna tempat aplikasi tersebut berada. Saat iklan native dimuat, aplikasi Anda
menerima objek native yang berisi asetnya, dan aplikasi Unity (bukan
SDK) akan menampilkannya.
Prasyarat
- Download dan instal Google Unity Ads Unity plugin versi 7.0.0 atau yang lebih tinggi.
- Download dan instal add-on iklan native.
- Ikuti petunjuk dari panduan Memulai tentang cara Mengimpor plugin Unity Iklan Seluler dan Menyertakan SDK Iklan Seluler.
Memuat format iklan native
Iklan native dimuat melalui class AdLoader
, yang memiliki class
AdLoader.Builder
sendiri untuk menyesuaikannya selama pembuatan. Metode ForNativeAd()
mengonfigurasi AdLoader untuk menangani iklan native.
private void RequestNativeAd() {
AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
.ForNativeAd()
.Build();
}
Mendaftar ke peristiwa iklan AdLoader
Agar diberi tahu saat iklan native berhasil dimuat atau gagal dimuat, tambahkan
delegasi ke class AdLoader
untuk peristiwa yang tercantum di bawah.
OnNativeAdLoaded
Dipanggil saat iklan native berhasil dimuat. Anda harus memiliki delegasi untuk peristiwa ini untuk mengakses iklan yang dimuat.
OnAdFailedToLoad
Dipanggil saat iklan native gagal dimuat.
Memuat iklan
Setelah selesai membuat AdLoader
, panggil metode LoadAd()
untuk
meminta iklan:
adLoader.LoadAd(new AdRequest.Builder().Build());
Menggabungkan permintaan iklan
Cuplikan kode di bawah menunjukkan cara membuat AdLoader
yang dikonfigurasi untuk meminta iklan native, menetapkan delegasi untuk pemuatan iklan yang berhasil dan gagal, serta membuat permintaan iklan.
private void RequestNativeAd() {
AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
.ForNativeAd()
.Build();
adLoader.OnNativeAdLoaded += this.HandleNativeAdLoaded;
adLoader.OnAdFailedToLoad += this.HandleAdFailedToLoad;
adLoader.LoadAd(new AdRequest.Builder().Build());
}
Menangani pemuatan iklan yang gagal
Peristiwa OnAdFailedToLoad
adalah dari jenis EventHandle<AdFailedToLoadEventArgs>
.
Menguraikan alasan kegagalan pemuatan iklan dari peristiwa ini ditampilkan di bawah.
private void RequestNativeAd() {
...
adLoader.OnAdFailedToLoad += this.HandleNativeAdFailedToLoad;
}
private void HandleNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args) {
Debug.Log("Native ad failed to load: " + args.Message);
}
Menampilkan iklan native
Saat Iklan Native dimuat, peristiwa iklan untuk format iklan yang sesuai akan dipanggil. Aplikasi Anda kemudian bertanggung jawab untuk menampilkan iklan, meskipun tidak harus segera melakukannya.
Menangani pemuatan iklan
Peristiwa OnNativeAdLoaded
adalah dari jenis EventHandler<NativeAdEventArgs>
. Iklan yang
dienkapsulasi dalam objek NativeAd
, dapat diambil dari
NativeAdEventArgs
seperti yang ditunjukkan:
private NativeAd nativeAd;
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
}
Mengambil aset iklan native
Setelah iklan dimuat, asetnya dapat diakses seperti yang ditunjukkan di bawah ini. Aset
grafis ditampilkan sebagai objek Texture2D
, dan aset teks ditampilkan sebagai
objek string
.
private bool nativeAdLoaded;
private NativeAd nativeAd;
void Update() {
...
if (this.nativeAdLoaded) {
this.nativeAdLoaded = false;
// Get Texture2D for the icon asset of native ad.
Texture2D iconTexture = this.nativeAd.GetIconTexture();
// Get string for headline asset of native ad.
string headline = this.nativeAd.GetHeadlineText();
}
}
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
this.nativeAdLoaded = true;
}
Perhatikan bahwa aset iklan hanya boleh diakses di thread utama, misalnya, dari metode Update()
skrip Unity. Perhatikan juga bahwa aset berikut
tidak selalu dijamin ada, dan harus diperiksa sebelum
ditampilkan:
GetStarRating()
GetStore()
GetPrice()
GetAdvertiser()
GetIconTexture()
Aset AdChoices
Ini adalah persyaratan untuk menampilkan aset iklan AdChoices sebagai bagian dari iklan native. Selain itu, aset iklan AdChoices harus mudah dilihat, jadi pilih warna dan gambar latar belakang dengan tepat.
Mendaftarkan GameObjects untuk aset iklan
Agar setiap aset iklan dapat ditampilkan, Anda harus mendaftarkan GameObject
yang akan digunakan untuk
menampilkan aset dalam aplikasi Unity. Setiap metode untuk mendaftarkan GameObject
untuk aset iklan akan menampilkan boolean yang menunjukkan bahwa pendaftaran berhasil. Jika
pendaftaran aset iklan tidak berhasil, tayangan dan klik pada
iklan native yang sesuai tidak akan dikenali.
if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
// Handle failure to register the icon ad asset.
}
GameObject
yang terdaftar untuk aset iklan harus memiliki komponen Collider cembung
yang mewakili ukuran dan bentuk GameObject
. Jika
objek GameObject
yang terdaftar ke aset iklan tidak memiliki komponen Collider
atau memiliki komponen yang salah dikonfigurasi, iklan native tidak akan beroperasi dengan benar.
Pada cuplikan kode di bawah, BoxCollider
ditambahkan ke GameObject
yang menggunakan
TextMesh
untuk menampilkan aset iklan judul iklan native. Setelah
dipasang ke GameObject
, BoxCollider
akan otomatis diskalakan
untuk mengakomodasi teks komponen TextMesh
.
// Create GameObject that will display the headline ad asset.
GameObject headline = new GameObject();
headline.AddComponent<TextMesh>();
headline.GetComponent<TextMesh>().characterSize = 0.5 f;
headline.GetComponent<TextMesh>().anchor = TextAnchor.MiddleCenter;
headline.GetComponent<TextMesh>().color = Color.black;
// Get string of the headline asset.
string headlineText = this.nativeAd.GetHeadlineText();
headline.GetComponent<TextMesh>().text = headlineText;
// Add box collider to the GameObject which will automatically scale.
headline.AddComponent<BoxCollider>();
Demo
Kode berikut menunjukkan cara mengambil aset ikon dari iklan native
yang berhasil dimuat, menampilkan aset iklan ikon dengan menetapkan tekstur Quad
,
dan mendaftarkan GameObject
yang akan digunakan untuk menampilkan aset. Proses pengambilan aset iklan dan mendaftarkannya ke class iklan native harus diulangi untuk setiap aset yang ditampilkan aplikasi.
private GameObject icon;
private bool nativeAdLoaded;
private NativeAd nativeAd;
...
void Update() {
...
if (this.nativeAdLoaded) {
this.nativeAdLoaded = false;
// Get Texture2D for icon asset of native ad.
Texture2D iconTexture = this.nativeAd.GetIconTexture();
icon = GameObject.CreatePrimitive(PrimitiveType.Quad);
icon.transform.position = new Vector3(1, 1, 1);
icon.transform.localScale = new Vector3(1, 1, 1);
icon.GetComponent<Renderer>().material.mainTexture = iconTexture;
// Register GameObject that will display icon asset of native ad.
if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
// Handle failure to register ad asset.
}
}
}
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
this.nativeAdLoaded = true;
}