Yerel yer paylaşımlı reklamlar

Platform seçin: Android iOS Flutter Unity Android (Eski)

Başlayın

Doğal yer paylaşımlı reklamlar, kullanıcılara platformun yerel kullanıcı arayüzü bileşenleri aracılığıyla sunulur. Bu reklamlar, uygulamanın üzerinde yer paylaşımı olarak gösterilir. Bu, banner reklamların işleyiş şekline benzer ancak reklamların görünümünü özelleştirme olanağı sunar.

Doğal yer paylaşımlı reklamlar, uyumlulaştırmayı ve video reklamları destekler. Bu, doğal yer paylaşımlı reklamların doğal reklamlara kıyasla önemli bir avantajıdır.

Bu kılavuzda, Unity uygulamalarında doğal yer paylaşımlı reklamların nasıl uygulanacağı ve bu süreçte dikkat edilmesi gereken bazı önemli noktalar açıklanmaktadır.

Ön koşullar

Devam etmeden önce şunları yapın:

Her zaman test reklamlarıyla test edin

Aşağıdaki örnek kod, test reklamları istemek için kullanabileceğiniz bir reklam birimi kimliği içerir. Bu kimlik, her istek için üretim reklamları yerine test reklamları döndürecek şekilde özel olarak yapılandırıldığından güvenle kullanılabilir.

Ancak AdMob web arayüzünde 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.

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Doğal yer paylaşımlı 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, tamamlama işleyicide parametre olarak sağlanır.

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



  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/2247696110";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/3986624511";
#else
  private string _adUnitId = "unused";
#endif


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

Doğal yer paylaşımlı reklamı oluşturma ve stilini belirleme

Doğal 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, doğal yer paylaşımlı reklamı oluşturmak için kullanılan doğal şablonu tanımlayan zorunlu bir dizedir. Reklamınız için uygun bir doğal şablon seçmek üzere NativeTemplateID sabitini kullanın.

Aşağıdaki kod, doğal yer paylaşımlı reklamı orta boy şablon ve özel 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);
    }
}

Doğal yer paylaşımlı reklamı gösterme ve gizleme

Aşağıdaki kodda, yüklenen doğal yer paylaşımlı reklamın nasıl gösterileceği açıklanmaktadır.

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

Doğal yer paylaşımlı 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();
    }
}

Doğal yer paylaşımlı reklamı imha etme

Doğal yer paylaşımlı reklamı kullanmayı tamamladığınızda kaynakları serbest bırakmak için Destroy() yöntemini ç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;
    }
}

Sonraki Adımlar