Özel yerel reklam biçimleri

Ad Manager yayıncıları, özel öğe listeleri tanımlayarak kendi doğal reklam biçimlerini oluşturabilir. Bunlar özel doğal reklam biçimleri olarak adlandırılır ve rezervasyon reklamlarıyla kullanılabilir. Özel doğal reklamlar, yayıncıların uygulamalarına rastgele resim ve dize verileri iletmesine olanak tanır. Bu veriler bir CustomNativeAd nesnesiyle temsil edilir.

Özel doğal reklam yükleme

Özel doğal reklamlar, AdLoader nesneleri kullanılarak yüklenir. ForCustomNativeAd() yöntemi, AdLoader nesnesini özel doğal reklamları işleyecek şekilde yapılandırır. Bu yöntemin iki parametresi vardır:

  • AdLoader tarafından istenmesi gereken özel reklamın formatId. Her özel doğal reklam biçiminin kendisiyle ilişkili bir biçim kimliği değeri vardır. Bu parametre, uygulamanızın AdLoader tarafından hangi biçimin istenmesini istediğini gösterir.
  • 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ştirmek için kendi AdLoader.Builder sınıfına sahip olan AdLoader sınıfı aracılığıyla yüklenir. ForCustomNativeAd() yöntemi, AdLoader öğesini doğal 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çimine hazırlamak için ForCustomNativeAd() farklı biçim kimlikleriyle birden çok kez çağrılabilir.

Özel doğal reklam etkinlikleri

AdLoader sınıfı, özel doğal 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 doğal reklam etkinliklerine nasıl kaydolacağınız gösterilmektedir:

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

HandleCustomNativeAdLoaded() yöntemi bir CustomNativeAdEventArgs parametresi içerir. Yüklenen özel doğal reklama, aşağıda gösterildiği gibi bu etkinlik parametresi aracılığıyla erişilebilir:

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

HandleCustomNativeAdFailedToLoad() yöntemi bir AdFailedToLoadEventArgs parametresi içerir. Hata mesajına, LoadAdError alanında GetMessage yöntemini çağırarak erişebilirsiniz. Örnek:

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

Özel doğal reklam biçimlerini görüntüleme

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

Özel bir doğal reklamdaki öğelere erişen örnek bir uygulama aşağıda 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 doğal 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.

Gösterimleri kaydetme

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

customNativeAd.RecordImpression();

Rapor tıklamaları

Bir öğenin tıklandığını 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 dokuyla ilgili bir tıklamayı raporlamak istiyorsanız kodunuz şöyle görünür:

customNativeAd.PerformClick("MainImage");

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

Özel bir reklamda tıklama raporlandığında SDK'dan gelebilecek yanıtlar şu sırayla denenir:

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

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

Kullanıcıyı bir 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ıklama kaydetmek amacıyla özel tıklama işleminin kullanıldığı bir örnek aşağıda verilmiştir:

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