Penayang Ad Manager memiliki opsi untuk membuat format iklan native sendiri dengan
menentukan daftar aset kustom. Ini disebut format iklan
native kustom, dan dapat digunakan
dengan iklan yang dipesan. Iklan native kustom memungkinkan penayang meneruskan data string
dan gambar arbitrer ke aplikasi mereka. Data ini diwakili oleh objek
CustomNativeAd
.
Memuat iklan native kustom
Iklan native kustom dimuat menggunakan objek AdLoader
. Metode ForCustomNativeAd()
mengonfigurasi AdLoader
untuk menangani iklan native kustom. Ada dua parameter untuk metode ini:
formatId
iklan kustom yang harus diminta olehAdLoader
. Setiap format iklan native kustom memiliki nilai ID format yang terkait dengannya. Parameter ini menunjukkan format yang diminta oleh aplikasi Anda untukAdLoader
.Action<CustomNativeAd, string>
opsional yang akan dipanggil saat pengguna mengklik iklan.
Iklan native kustom dimuat melalui class AdLoader
, yang memiliki class
AdLoader.Builder
sendiri untuk menyesuaikannya selama pembuatan. Metode
ForCustomNativeAd()
mengonfigurasi AdLoader
untuk menangani iklan native.
void LoadCustomNativeAd()
{
AdLoader adLoader = new AdLoader.Builder("/6499/example/native")
.ForCustomNativeAd("10063170")
.Build();
adLoader.LoadAd(new AdRequest.Builder().Build());
}
Karena satu unit iklan dapat disiapkan untuk menayangkan lebih dari satu format iklan native kustom, ForCustomNativeAd()
dapat dipanggil beberapa kali dengan ID format yang berbeda untuk menyiapkan loader iklan untuk lebih dari satu kemungkinan format iklan native kustom.
Peristiwa iklan native kustom
Class AdLoader
menyediakan peristiwa iklan, dengan jenis EventHandler
, untuk memberi tahu Anda tentang siklus proses iklan native kustom. Contoh di bawah menunjukkan cara
mendaftar ke peristiwa iklan native kustom di loader iklan:
private AdLoader adLoader;
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
Metode HandleCustomNativeAdLoaded()
berisi parameter CustomNativeAdEventArgs
. Iklan native kustom yang telah dimuat dapat diakses melalui parameter peristiwa ini, seperti yang ditunjukkan di bawah:
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
this.customNativeAd = args.nativeAd;
}
Metode HandleCustomNativeAdFailedToLoad()
berisi parameter AdFailedToLoadEventArgs
. Pesan error dapat diakses dengan memanggil metode GetMessage
di kolom LoadAdError
, seperti ditunjukkan di bawah:
void HandleCustomNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
string message = args.LoadAdError.GetMessage();
Debug.Log("Ad Loader fail event received with message: " + message);
}
Menampilkan format iklan native kustom
Iklan native kustom memberikan dukungan untuk sejumlah aset gambar dan
teks yang ditentukan pengguna. Aset ini diakses melalui class CustomNativeAd
, yang
menyediakan metode GetTexture2D()
dan GetText()
yang menggunakan ID variabel
kolom format sebagai parameter.
Berikut contoh penerapan yang mengakses aset dari iklan native kustom:
private bool adLoaded;
private Texture2D mainImageTexture;
private string headline;
private CustomNativeAd customNativeAd;
...
void Update()
{
if(adLoaded)
{
mainImageTexture = customNativeAd.GetTexture2D("MainImage");
headline = customNativeAd.GetText("Headline");
adLoaded = false;
}
}
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
customNativeAd = args.nativeAd;
adLoaded = true;
...
}
Menangani tayangan dan klik iklan native kustom
Dengan iklan native kustom, aplikasi Anda bertanggung jawab untuk mencatat tayangan dan melaporkan peristiwa klik ke SDK.
Rekam tayangan
Untuk mencatat tayangan iklan kustom, panggil metode RecordImpression()
pada
CustomNativeAd
yang sesuai:
customNativeAd.RecordImpression();
Laporkan klik
Untuk melaporkan ke SDK bahwa sebuah klik terjadi pada aset, panggil
metode PerformClick()
pada CustomNativeAd
yang sesuai dan teruskan nama
aset yang diklik tersebut. Misalnya, jika Anda memiliki aset dalam format kustom yang disebut "MainImage" dan ingin melaporkan klik pada tekstur yang
terkait dengan aset tersebut, kode Anda akan terlihat seperti ini:
customNativeAd.PerformClick("MainImage");
Merespons tindakan klik kustom
Saat klik dilaporkan pada iklan kustom, respons yang memungkinkan dari SDK dicoba dalam urutan ini:
Temukan resolver konten untuk URL deep link iklan dan mulai URL yang pertama yang diselesaikan.
Buka browser dan buka URL tujuan tradisional iklan.
Jika Anda ingin menangani sendiri tindakan klik untuk format iklan native kustom,
bukan mengarahkan pengguna ke deep link atau browser web, berikan
Action<CustomNativeAd, string>
opsional di
metode AdLoader.Builder.ForCustomNativeAd()
. Dengan menetapkan tindakan klik
kustom ini, Anda akan mengganti perilaku klik SDK. Berikut adalah contoh yang menggunakan
tindakan klik kustom untuk mencatat klik pada aset tertentu:
private void LoadCustomNativeAd()
{
AdLoader adLoader = new AdLoader.Builder("/6499/example/native")
.ForCustomNativeAd("10063170", HandleCustomNativeAdClicked)
.Build();
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.LoadAd(createAdRequest());
}
private void HandleCustomNativeAdClicked(CustomNativeAd customNativeAd, string assetName)
{
Debug.Log("Custom Native ad asset with name " + assetName + " was clicked.");
}