MoPub panelin kullanımı ya da uygulama ve mediation networklerinin panel üzerinden kurulum işlemleriyle ilgili bilgi almak istiyorsanız bir önceki yazıya buradan erişebilirsiniz.

Unity ile oyun geliştiriyor ve reklam gösterimi için MoPub plugin kullanmak istiyorsanız MoPub Unity Plugin kurulum ve konfigürasyon işlemleriyle alakalı bilgi almak için yazının devamını okuyabilir, sorularınızı bu postun yorumlar kısmından iletebilirsiniz.

Kurulum işlemlerinin ilk adımı olarak MoPub Unity Plugin’i bu linkten indirin.

 

Download the SDK linkini takip ederek GitHub üzerinden SDK repository’sine ulaşın.

MoPub SDK’nın GitHub Üzerinden İndirilmesi

Aşağıdaki görselde gösterildiği gibi “Clone or download” butonuna tıklayarak repository linkini kopyalayın.

 

Terminali açın, aşağıdaki komutu girerek repository clone işlemini gerçekleştirin.

• git clone https://github.com/mopub/mopub-unity-sdk.git

 

MoPub Unity SDK Kurulumu

Lokalinize indirdiğiniz MoPub Unity Sdk klasörünü açın.

Mopub-unity-plugin klasöründeki MoPubUnity.unitypackage’a çift tıklayarak açın ya da Unity’e sürükleyin.

Aşağıdaki görseldeki gibi Import butonuna tıklayarak sdk kurulumunu gerçekleştirin.

MoPub Unity Mediation

MoPub Unity SDK kurulumundan sonra MoPub aracılığıyla birlikte çalışmak istenilen Ad Networklerin adaptör ve sdk kurulumlarının yapılması gerekmekte.

Mediation Network Adaptörlerinin Github Üzerinden İndirilmesi

İlgili networklerin adaptörlerinin kurulumu için mediation adaptörlerinin olduğu repository’e buradan ulaşın ve terminal aracılığıyla indirin.

Mediation Network Adaptörlerinin Kurulumu

Aşağıda gördüğünüz Mediation dokümantasyonuna buradan ulaşabilirsiniz.

MoPub paneli üzerinden seçtiğiniz networklerin kurulumunu yapmak için indirdiğiniz klasörü açın.

Örneğin AppLovin adaptör kurulumu için ilgili Unity package’ı projenize sürükleyin ve açılan pencerede import butonuna tıklayın.

Adaptör kurulumunu yaptıktan sonra SDK kurulumunu Pod aracılığıyla değil manuel olarak gerçekleştirmek istiyorsanız  aşağıdaki görseldeki gibi Applovin Panel üzerinden Unity SDK ya ulaşarak unity package’ı indirin.

İndirdiğiniz package’ı projenize ekleyin.

Her bir Ad Network için o network ün adaptör ve SDK kurulumunu yapmanız gerektiğini unutmayın.

Initialize MoPub

MoPub initialize işlemi için oluşturacağınız empty game object’e tanımlayacağınız aşağıdaki script, MoPub Sdk içindeki örnek projeden uyarlanmıştır. MoPubController scriptine buradan erişebilirsiniz.

Burada sdk initialize işlemlerinin gerçekleştirilebilmesi için MoPub panelinde oluşturduğunuz Unit ID leri ilgili alanlara girmeniz gerekmekte.

Android ve IOS platformları için ayrı ayrı oluşturduğunuz Banner, Rewarded ve Interstitial Unit ID’lerinizi aşağıda gösterildiği gibi tanımlayın.

#if UNITY_IOS    private readonly string bannerAdUnit =“0ac59b0996d947309c33f59d6676399f”;    private readonly string interstitialAdUnit =“4f117153f5c24fa6a3a92b818a5eb630”;    private readonly string rewardedVideoAdUnit =“8f000bd5e00246de9c789eed39ff6096”;    private readonly string rewardedRichMediaAdUnit = “”; #elif UNITY_ANDROID || UNITY_EDITOR    private readonly string bannerAdUnit = “b195f8dd8ded45fe847ad89ed1d016da”;    private readonly string interstitialAdUnit = “24534e1901884e398f1253216226017e”;    private readonly string rewardedVideoAdUnit = “920b6145fb1546cf8b5cf2ac34638bb7”;    private readonly string rewardedRichMediaAdUnit = “a96ae2ef41d44822af45c6328c4e1eb1”; #endif

 

MoPub SDK initialize işlemini gerçekleştirirken aşağıdaki örnekte interstitialAdUnit  kullanıldı. Ancak siz tanımladığınız herhangi bir Unit ID’yi kullanarak initialize işlemini gerçekleştirebilirsiniz.

 

private void InitializeMoPub()    {        Debug.Log(“[MoPubController] InitializeMoPub()”);        var anyAdUnitId = interstitialAdUnit;        Debug.Log(“[MoPubController] InitializeMoPub() anyAdUnitId : “ + anyAdUnitId);                MoPub.InitializeSdk(new MoPubBase.SdkConfiguration        {            AdUnitId = anyAdUnitId,            LogLevel = MoPubBase.LogLevel.MPLogLevelDebug,            MediatedNetworks = new MoPub.MediatedNetwork[]            {                new MoPub.SupportedNetwork.AppLovin()            },        });    }

 

MoPub Paneli üzerinden kurulumunu ve konfigürasyonunu yaptığınız Ad Networkleri yukarıda gördüğünüz MediatedNetworks kısmında tanımlamanız gerekmekte.

Her bir Ad Network kurulumu için ilgili networke ait Mediation dokümantasyonunu ve varsa kendi web sitelerinde yer alan adımları takip etmek oldukça önemli.

Örneğin AppLovin kurulumu için, AppLovin panelinde size verilen SDK Key’i kullanarak initialize işlemini ayrıca gerçekleştirmeniz gerekiyor.

AppLovin SDK initialize işlemini aşağıdaki şekilde gerçekleştirebilirsiniz.

public class AppLovinInitializer {       public void Initialize()      {          AppLovin.SetSdkKey(“YOUR_SDK_KEY”);          AppLovin.InitializeSdk();      } }

!!!

AppLovin SDK ve Adaptör kurulumunu manuel olarak gerçekleştirdiğiniz için build alırken karşılaşabileceğiniz bir hata ve bu hatanın çözümüne aşağıda ulaşabilirsiniz.

AppLovin Adaptör import işleminde projenize eklenen ve Sdk’nın Xcode ile build alırken kurulum işlemini gerçekleştiren .podspec uzantılı dosyayı silmediğimiz sürece kütüphaneler tekrar indirileceği için aşağıdaki görseldeki gibi “duplicate symbol” içerikli hatalar alacaksınız.

Bu hatanın ortadan kaldırılması için projenizde Assets/MoPub/Mediation/AppLovin/Adapter/iOS klasörüne giderek .podspec uzantılı MoPub-AppLovin-Adapters  dosyasını silin ve tekrar build alın.

Test

Kurulumları tamamladıysanız ve herhangi bir hata almadan başarılı bir build alabildiyseniz reklamları görebilmek için yapmanız gereken son bir adım var.

MoPub paneline gidin;

Segments > Global Segment adımlarını takip edin.

Global Segment sayfasında, oyununuz için oluşturduğunuz her bir Ad Unit için, yine Networks menüsünde sizin tanımladığınız Ad Netwok’lerin listelendiğini göreceksiniz. Buradan test etmek istediğiniz Ad Unit türüne göre, yine test etmek istediğiniz Network’ü “enabled” yapmanız gerekmekte.

Oyununuzdan MoPub’a ulaşan her istekte “Attempts” sayısı artarken, isteklerinize başarılı dönüş aldığınızda (reklam gösterildiğinde) “Impressions” sayısının arttığını gözlemleyeceksiniz.