Özel yerel reklam biçimleri

Ad Manager yayıncıları, özel öğe listeleri tanımlayarak kendi doğal reklam biçimlerini oluşturabilir. Bunlara özel yerel reklam biçimleri denir ve ayrılmış reklamlarla birlikte kullanılabilir. Özel yerel reklamlar, yayıncıların uygulamalarına rastgele resim ve dize verileri aktarmasına olanak tanır. Bu veriler CustomNativeAd nesnesiyle gösterilir.

Özel bir doğal reklam yükleme

Özel doğal reklamlar, AdLoader nesneleri kullanılarak yüklenir. ForCustomNativeAd() yöntemi, AdLoader öğesini özel yerel reklamları işleyecek şekilde yapılandırır. Bu yöntem için iki parametre vardır:

  • AdLoader tarafından istenmesi gereken özel reklamın formatId. Her özel doğal reklam biçimiyle ilişkilendirilmiş bir biçim kimliği değeri vardır. Bu parametre, uygulamanızın hangi biçimi istemesini istediğinizi gösterir.AdLoader
  • Kullanıcı reklamı tıkladığında çağrılacak isteğe bağlı bir Action<CustomNativeAd, string>.

Özel doğal reklamlar, oluşturma sırasında özelleştirilebilen kendi AdLoader sınıfına sahip olan AdLoader.Builder sınıfı aracılığıyla yüklenir. ForCustomNativeAd() yöntemi, AdLoader öğesini yerel reklamları işleyecek şekilde yapılandırır.

void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
            .ForCustomNativeAd("10063170")
            .Build();
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

Tek bir reklam birimi birden fazla özel doğal reklam biçimi yayınlayacak şekilde ayarlanabildiğinden, reklam yükleyiciyi birden fazla olası özel doğal reklam biçimi için hazırlamak amacıyla ForCustomNativeAd() farklı biçim kimlikleriyle birden fazla kez çağrılabilir.

Özel yerel reklam etkinlikleri

AdLoader sınıfı, özel bir yerel reklamın yaşam döngüsü hakkında sizi bilgilendirmek için EventHandler türünde reklam etkinlikleri sağlar. Aşağıdaki örnekte, bir reklam yükleyicide özel yerel reklam etkinliklerine nasıl kaydolacağınız gösterilmektedir:

private AdLoader adLoader;
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;

HandleCustomNativeAdLoaded() yöntemi CustomNativeAdEventArgs parametresi içeriyor. Yüklenen özel yerel reklama aşağıdaki örnekte gösterildiği gibi bu etkinlik parametresi üzerinden erişilebilir:

void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
    this.customNativeAd = args.nativeAd;
}

HandleCustomNativeAdFailedToLoad() yöntemi AdFailedToLoadEventArgs parametresini içeriyor. Hata mesajına, aşağıdaki örnekte gösterildiği gibi LoadAdError alanında GetMessage yöntemi çağrılarak erişilebilir:

void HandleCustomNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    string message = args.LoadAdError.GetMessage();
    Debug.Log("Ad Loader fail event received with message: " + message);
}

Özel yerel reklam biçimlerini görüntüleme

Özel yerel reklamlar, kullanıcı tanımlı herhangi bir sayıda resim ve metin öğesini destekler. Bu öğelere, bir biçim alanının değişken kimliğini parametre olarak alan CustomNativeAd ve GetText() yöntemlerini sağlayan GetTexture2D() sınıfı üzerinden erişilir.

Aşağıda, özel bir doğal reklamdaki öğelere erişen bir örnek uygulama verilmiştir:

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;
    ...
}

Özel yerel reklamların gösterimlerini ve tıklamalarını işleme

Özel doğal reklamda, gösterimleri kaydetme ve tıklama etkinliklerini SDK'ya bildirme sorumluluğu uygulamanıza aittir.

Kayıt gösterimleri

Özel bir reklam için gösterim kaydetmek üzere ilgili CustomNativeAd üzerinde RecordImpression() yöntemini çağırın:

customNativeAd.RecordImpression();

Rapor tıklamaları

Bir öğenin tıklanmasıyla ilgili bilgileri SDK'ya bildirmek için ilgili CustomNativeAd üzerinde PerformClick() yöntemini çağırın ve tıklanan öğenin adını iletin. Örneğin, özel biçiminizde "MainImage" adlı bir öğeniz varsa ve bu öğeye karşılık gelen dokudaki bir tıklamayı bildirmek istiyorsanız kodunuz şu şekilde görünür:

customNativeAd.PerformClick("MainImage");

Özel tıklama işlemlerine yanıt verme

Özel bir reklamda tıklama bildirildiğinde SDK'dan gelen olası yanıtlar şu sırayla denenir:

  1. Reklamın derin bağlantı URL'si için bir içerik çözümleyici bulun ve çözüme kavuşan ilk çözümleyiciyi başlatın.

  2. Bir tarayıcı açın ve reklamın geleneksel hedef URL'sine gidin.

Kullanıcıyı derin bağlantıya veya web tarayıcısına yönlendirmek yerine özel doğal reklam biçimleriniz için tıklama işlemini kendiniz yönetmek istiyorsanız AdLoader.Builder.ForCustomNativeAd() yönteminde isteğe bağlı bir Action<CustomNativeAd, string> sağlayın. Bu özel tıklama işlemini ayarlayarak SDK'nın tıklama davranışını geçersiz kılarsınız. Belirli bir öğe için tıklamayı kaydetmek üzere özel tıklama işleminin kullanıldığı bir örneği aşağıda bulabilirsiniz:

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