Format iklan native kustom

Penayang Ad Manager memiliki opsi untuk membuat format iklan native mereka sendiri dengan menentukan daftar aset kustom. Format ini disebut format iklan native kustom, dan dapat digunakan dengan iklan yang dicadangkan. Iklan native kustom memungkinkan penayang meneruskan data string dan gambar arbitrer ke aplikasi mereka. Data ini direpresentasikan 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 ingin diminta AdLoader oleh aplikasi Anda.
  • Action<CustomNativeAd, string> opsional yang akan dipanggil saat pengguna mengklik iklan.

Iklan native kustom dimuat melalui class AdLoader, yang memiliki class AdLoader.Builder-nya sendiri untuk menyesuaikannya selama pembuatan. Metode ForCustomNativeAd() mengonfigurasi AdLoader untuk menangani iklan native.

void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/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 untuk 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 yang 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 adalah 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.

Mencatat tayangan

Untuk mencatat tayangan iklan kustom, panggil metode RecordImpression() di CustomNativeAd yang sesuai:

customNativeAd.RecordImpression();

Melaporkan klik

Untuk melaporkan ke SDK bahwa klik telah terjadi pada aset, panggil metode PerformClick() pada CustomNativeAd yang sesuai dan teruskan nama aset yang diklik. Misalnya, jika Anda memiliki aset dalam format kustom yang disebut "MainImage" dan ingin melaporkan klik pada tekstur yang sesuai dengan aset tersebut, kode Anda akan terlihat seperti ini:

customNativeAd.PerformClick("MainImage");

Merespons tindakan klik kustom

Saat klik dilaporkan di iklan kustom, kemungkinan respons dari SDK akan dicoba dalam urutan ini:

  1. Temukan resolver konten untuk URL deep link iklan dan mulai yang pertama yang di-resolve.

  2. Buka browser dan buka URL tujuan tradisional iklan.

Jika Anda ingin menangani tindakan klik untuk format iklan native kustom sendiri, bukan mengarahkan pengguna ke deep link atau browser web, berikan Action<CustomNativeAd, string> opsional dalam metode AdLoader.Builder.ForCustomNativeAd(). Dengan menetapkan tindakan klik kustom ini, Anda mengganti perilaku klik SDK. Berikut adalah contoh yang menggunakan tindakan klik kustom untuk mencatat klik untuk aset tertentu:

private void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/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.");
}