Başlayın

Yerel yer paylaşımlı reklamlar, platforma özgü kullanıcı arayüzü bileşenleri aracılığıyla kullanıcılara sunulur. Bu reklamlar, uygulamanın üstünde yer alan bir yer paylaşımı olarak sunulur. Bu, banner reklamların işleyişine benzer ancak reklamların görünümünü özelleştirme olanağı sunar.

Yerel yer paylaşımlı reklamlar, uyumlulaştırma ve video reklamları destekler. Bu, doğal yer paylaşımlı reklamların doğal reklamlara kıyasla sahip olduğu önemli bir avantajdır.

Bu kılavuzda, Unity uygulamasına doğal yer paylaşımlı reklamları nasıl uygulayacağınız ve bu süreçte dikkate almanız gereken bazı önemli noktalar gösterilmektedir.

Ön koşullar

• Başlangıç kılavuzunu tamamlayın.
• Unity eklentisi 9.0.0 veya daha yeni bir sürüm.

Her zaman test reklamlarıyla test yapın

Aşağıdaki örnek kod, test reklamları istemek için kullanabileceğiniz bir reklam birimi kimliği içerir. Her istek için yayın reklamları yerine test reklamları döndürecek şekilde özel olarak yapılandırılmıştır. Bu sayede güvenli bir şekilde kullanılabilir.

Ancak Ad Manager web arayüzüne bir uygulama kaydettikten ve uygulamanızda kullanılacak kendi reklam birimi kimliklerinizi oluşturduktan sonra, geliştirme sırasında cihazınızı açıkça test cihazı olarak yapılandırın.

/21775744923/example/native

Yer paylaşımlı doğal reklamı yükleme

Doğal yer paylaşımlı reklam yükleme işlemi, NativeOverlayAd sınıfındaki statik Load() yöntemi kullanılarak gerçekleştirilir. Yüklenen NativeOverlayAd nesnesi, tamamlanma işleyicide bir parametre olarak sağlanır.

Aşağıdaki kodda, reklam yüklemek için NativeOverlayAd kullanılır:

// This ad unit is configured to always serve test ads.
private string _adUnitId = "/21775744923/example/native";



private NativeOverlayAd _nativeOverlayAd;

/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
    // Clean up the old ad before loading a new one.
    if (_nativeOverlayAd != null)
    {
        DestroyAd();
    }

    Debug.Log("Loading native overlay ad.");

    // Create a request used to load the ad.
    var adRequest = new AdRequest();

    // Optional: Define native ad options.
    var options = new NativeAdOptions
    {
        AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
        MediaAspectRatio = NativeMediaAspectRatio.Any,
    };

    // Send the request to load the ad.
    NativeOverlayAd.Load(_adUnitId, adRequest, options,
        (NativeOverlayAd ad, LoadAdError error) =>
    {
        if (error != null)
        {
            Debug.LogError("Native Overlay ad failed to load an ad " +
                           " with error: " + error);
            return;
        }

        // The ad should always be non-null if the error is null, but
        // double-check to avoid a crash.
        if (ad == null)
        {
            Debug.LogError("Unexpected error: Native Overlay ad load event " +
                           " fired with null ad and null error.");
            return;
        }

        // The operation completed successfully.
        Debug.Log("Native Overlay ad loaded with response : " +
                   ad.GetResponseInfo());
        _nativeOverlayAd = ad;

        // Register to ad events to extend functionality.
        RegisterEventHandlers(ad);
    });
}

Yerel yer paylaşımlı reklamı oluşturma ve stillendirme

Yerel yer paylaşımlı reklamlar, NativeTemplateStyle kullanılarak oluşturulur. Bu sınıf, reklamın görünümünü özelleştirmenizi sağlayan alanları tanımlar.

TemplateID, yerel yer paylaşımlı reklamı oluşturmak için kullanılan yerel şablonu tanımlayan zorunlu bir dizedir. Reklamınız için uygun bir yerel şablon seçmek üzere NativeTemplateID sabit değerini kullanın.

Aşağıdaki kod, yerel yer paylaşımlı reklamı orta boyutlu bir şablon ve özel bir stille oluşturur.

/// <summary>
/// Renders the ad.
/// </summary>
public void RenderAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Rendering Native Overlay ad.");

        // Define a native template style with a custom style.
        var style = new NativeTemplateStyle
        {
            TemplateID = NativeTemplateID.Medium,
            MainBackgroundColor = Color.red,
            CallToActionText = new NativeTemplateTextStyles
            {
                BackgroundColor = Color.green,
                FontColor = Color.white,
                FontSize = 9,
                Style = NativeTemplateFontStyle.Bold
            }
        };

        // Renders a native overlay ad at the default size
        // and anchored to the bottom of the screne.
        _nativeOverlayAd.RenderTemplate(style, AdPosition.Bottom);
    }
}

Yerel yer paylaşımlı reklamı gösterme ve gizleme

Aşağıdaki kodda, yüklenmiş bir doğal yer paylaşımlı reklamın nasıl gösterileceği gösterilmektedir.

/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Showing Native Overlay ad.");
        _nativeOverlayAd.Show();
    }
}

Yer paylaşımlı doğal reklamı gizleme

Aşağıdaki kodda, doğal yer paylaşımlı reklamın nasıl gizleneceği gösterilmektedir.

/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Hiding Native Overlay ad.");
        _nativeOverlayAd.Hide();
    }
}

Yerel yer paylaşımlı reklamı yok etme

Yerel yer paylaşımlı reklamı kullanmayı tamamladığınızda kaynakları serbest bırakmak için Destroy() işlevini çağırdığınızdan emin olun.

/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Destroying native overlay ad.");
        _nativeOverlayAd.Destroy();
        _nativeOverlayAd = null;
    }
}