Format iklan native kustom

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 oleh AdLoader. Setiap format iklan native kustom memiliki nilai ID format yang terkait dengannya. Parameter ini menunjukkan format yang diminta oleh aplikasi Anda untuk AdLoader.
  • 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:

  1. Temukan resolver konten untuk URL deep link iklan dan mulai URL yang pertama yang diselesaikan.

  2. 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.");
}