Format Iklan Native Kustom

Penayang Google Ad Manager dapat membuat format iklan native sendiri dengan menentukan daftar aset kustom. Format iklan native kustom ini dapat digunakan dengan iklan yang direservasi. Format iklan native kustom memungkinkan penayang meneruskan data gambar dan string arbitrer ke aplikasi mereka. Data ini direpresentasikan oleh objek CustomNativeTemplateAd.

Memuat format iklan native kustom

Format iklan native kustom dimuat menggunakan objek AdLoader. Metode forCustomTemplateAd() mengonfigurasi AdLoader untuk menangani format iklan native kustom. Setiap format iklan native kustom memiliki nilai ID template yang terkait dengannya. Anda harus menentukan ID template format iklan native kustom yang ingin diminta oleh aplikasi Anda ke AdLoader. Telusuri ID template di UI Ad Manager untuk menemukan ID template format iklan native yang ingin Anda minta.

void LoadCustomNativeTemplateAd()
{
    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 template materi iklan, forCustomTemplateAd() dapat dipanggil beberapa kali dengan ID template yang berbeda untuk menyiapkan Adloader untuk lebih dari satu kemungkinan format iklan native kustom. Cuplikan kode di bawah menunjukkan cara menyiapkan AdLoader untuk beberapa template format iklan native kustom.

void LoadCustomNativeTemplateAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
        .forCustomNativeAd("10063170")
        .forCustomNativeAd("10063171")
        .forCustomNativeAd("10063172")
        .Build();
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

Peristiwa iklan format iklan native kustom

Class AdLoader menyediakan peristiwa iklan berjenis EventHandler untuk memberi tahu Anda tentang siklus proses format iklan native kustom. Contoh di bawah menunjukkan cara mendaftar ke peristiwa iklan format iklan native kustom:

adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;

Metode HandleCustomNativeAdLoaded() berisi parameter CustomNativeEventArgs. Format iklan native kustom yang telah dimuat dapat diakses melalui parameter peristiwa ini, seperti yang ditunjukkan di bawah:

private boolean adLoaded;
private CustomNativeTemplateAd customNativeTemplateAd;
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
    customNativeTemplateAd = args.nativeAd;
    adLoaded = true;
}

Menampilkan format iklan native kustom

Format iklan native kustom memberikan dukungan untuk sejumlah aset gambar dan teks yang ditentukan pengguna. Aset ini diakses melalui class CustomNativeTemplateAd, yang menyediakan metode GetTexture2D() dan GetText() yang menggunakan ID variabel kolom template sebagai parameter.

Contoh penerapan berikut mengekstrak aset dari CustomNativeTemplateAd:

public const int NATIVE_AD_TEMPLATE_1 = 10063170;
public const int NATIVE_AD_TEMPLATE_2 = 10063171;

private boolean adLoaded;
private Texture2d mainImageTexture;
private string headline;
private CustomNativeTemplateAd customNativeTemplateAd;
...

void Update()
{
    if(adLoaded)
    {
        mainImageTexture = customNativeTemplateAd.GetTexture2D("MainImage");
        headline = customNativeTemplateAd.GetText("Headline");

        string templateId = customNativeTemplateAd.GetCustomTemplateId();
        if (templateId == NATIVE_AD_TEMPLATE_1)
        {
            ...
        }
        else if (templateId == NATIVE_AD_TEMPLATE_2)
        {
            ...
        }
        ...
        adLoaded = false;
    }
}
...

void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
    customNativeTemplateAd = args.nativeAd;
    adLoaded = true;
    ...
}

Menangani klik dan tayangan format iklan native kustom

Dengan format iklan native kustom, aplikasi Anda bertanggung jawab untuk mencatat tayangan iklan dan melaporkan peristiwa klik ke SDK.

Merekam tayangan

Untuk mencatat tayangan iklan untuk format iklan native kustom, panggil metode RecordImpression() di CustomNativeTemplateAd yang sesuai:

customNativeTemplateAd.RecordImpression();

Klik laporan

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

customNativeTemplateAd.PerformClick("MainImage");

Saat klik dilaporkan pada iklan template kustom, ada dua kemungkinan respons dari SDK, yang dicoba dalam urutan ini:

  1. Temukan pemroses konten untuk URL deep link iklan dan mulai pemroses konten pertama yang diselesaikan.
  2. Buka browser dan buka URL tujuan tradisional iklan.

Tindakan klik kustom

Anda dapat memutuskan untuk menangani sendiri tindakan klik untuk format iklan native kustom daripada mengarahkan pengguna ke deep link atau browser web. Anda dapat melakukannya dengan memberikan Action<CustomNativeTemplateAd, string> opsional dalam metode AdLoader.Builder.forCustomTemplateAd(). Dengan menetapkan tindakan klik kustom ini, Anda mengganti perilaku klik SDK yang dijelaskan di atas. Berikut adalah contoh yang menggunakan tindakan klik kustom untuk mencatat klik untuk aset tertentu:

private void LoadCustomNativeTemplateAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
        .forCustomNativeAd("10063170", HandleCustomNativeAdClicked)
        .Build();
    adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
    adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
    adLoader.LoadAd(createAdRequest());
}

private void HandleCustomNativeAdClicked(CustomNativeTemplateAd customNativeTemplateAd, string assetName)
{
    Debug.Log("Native ad asset with name " + assetName + " was clicked.");
}