Başlama

Google Mobil Reklamlar Unity eklentisi, Unity geliştiricilerin Android ve iOS uygulamalarında Java veya Objective-C kodu yazmak zorunda kalmadan Google mobil reklamları yayınlamasına olanak tanır. Bu eklenti, Unity projenizdeki C# komut dosyaları tarafından kullanılan reklamları istemek için bir C# arayüzü sağlar.

Bu kılavuz, Unity uygulamasından para kazanmak isteyen yayıncılara yöneliktir.

Ön koşullar

• Unity 2019.4 veya sonraki bir sürümü kullanın
• iOS'e dağıtmak için
  • Xcode 16.0 veya sonraki sürümler
  • iOS 12.0 veya sonraki sürümleri hedefleyin
  • CocoaPods
• Android'e dağıtmak için
  • Minimum Android API düzeyi 23 veya daha yeni sürümler
  • Android API düzeyi 34 veya sonraki sürümleri hedefleyin

• Önerilen: AdMob hesabı oluşturun ve Android veya iOS uygulaması kaydedin.

Android API seviyesi, Proje Ayarları > Oynatıcı > Android > Diğer Ayarlar > Diğer Ayarlar bölümünde ayarlanır.

Unity için Mobil Reklamlar eklentisini içe aktarma

OpenUPM-CLI

OpenUPM CLI yüklüyse OpenUPM kayıt defterini şu komutla yükleyebilirsiniz:

openupm add com.google.ads.mobile

.unitypackage eklenti öğelerini kaldırma

.unitypackage'den OpenUPM'ye geçiş yapıyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage'ten içe aktarılan aşağıdaki dizinleri kaldırın:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. Düzenle > Proje Ayarları > Paket Yöneticisi Unity menü seçeneğini belirleyerek paket yöneticisi ayarlarını açın.

2. OpenUPM'yi Paket Yöneticisi penceresine kapsamlı bir kayıt defteri olarak ekleyin:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Unity menü seçeneği Pencere > Paket Yöneticisi'ni seçerek paket yöneticisi menüsünü açın.

4. Yönetici kapsamı açılır menüsünden Kayıt Dairelerim'i seçin.

   

5. Paket listesinden Unity için Google Mobil Reklamlar paketini seçin ve Yükle'ye basın.

.unitypackage eklenti öğelerini kaldırma

.unitypackage'den OpenUPM'ye geçiş yapıyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage'ten içe aktarılan aşağıdaki dizinleri kaldırın:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

GitHub'dan içe aktarma

1. GitHub'dan en son .unitypackage sürümünü indirin.
2. Öğeler > Paket içe aktar > Özel Paket Unity menü seçeneğini belirleyip tüm öğeleri içe aktararak .unitypackage dosyasını içe aktarın.

Harici bağımlılıkları dahil etme

Google Mobil Reklamlar Unity eklentisi, Unity Play Hizmetleri Çözümleyici kitaplığı ile dağıtılır. Bu kitaplık, AAR'lar veya iOS CocoaPods gibi Android'e özgü kitaplıklara erişmesi gereken tüm Unity eklentileri tarafından kullanılmak üzere tasarlanmıştır. Unity eklentilerine, bağımlılıklarını belirtme olanağı sunar. Bu bağımlılıklar daha sonra otomatik olarak çözülür ve Unity projenize kopyalanır.

Önemli: Tüm gizlilik uyumluluğu özelliklerine erişebilmek için en son Google Mobile Ads SDK'sını kullanın.

Projenizin tüm bağımlılıkları içerdiğinden emin olmak için aşağıdaki adımları uygulayın:

Android

Proje Ayarları > Oynatıcı > Android > Yayınlama Ayarları > Derleme'ye gidin ve aşağıdakileri seçin:

• Özel Ana Gradle Şablonu
• Özel Gradle Özellikleri Şablonu

Unity harici bağımlılık yöneticisi kitaplığının, bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalamasını sağlamak için Unity düzenleyicisinde Öğeler > Harici Bağımlılık Yöneticisi > Android Çözümleyici > Çözümle'yi seçin.

iOS

iOS için Unity, bağımlılıkları tanımlamak ve yönetmek için CocoaPods'u kullanır. iOS bağımlılıklarınıza ilişkin belirli gereksinimler veya sorun giderme adımları için CocoaPods belgelerine bakın.

Google Mobil Reklamlar Unity eklentisi bağımlılıkları Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml bölümünde listelenir.

AdMob uygulama kimliğinizi ayarlama

Unity Editor'da menüden Öğeler > Google Mobil Reklamlar > Ayarlar'ı seçin.

Android ve iOS AdMob uygulama kimliğinizi her alana girin.

SDK'yı başlatma

Reklamları yüklemeden önce uygulamanızın MobileAds.Initialize() çağrısını yaparak Google Mobile Ads SDK'sını ilk kullanıma hazırlamasını sağlayın. Bu işlemin ideal olarak uygulamanın lansmanında bir kez yapılması gerekir.

Uyarı: Reklamlar, MobileAds.Initialize() çağrıldıktan sonra Google Mobile Ads SDK'sı veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılardan izin almanız gerekiyorsa tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi istekle ilgili işaretleri ayarlayın ya da reklamları yüklemeden önce başka bir işlem yapın. Google Mobile Ads SDK'sını ilk kullanıma hazırlamadan önce bunu yaptığınızdan emin olun.

GameObject'ye bağlı bir komut dosyasının Start() yönteminde Initialize()'nin nasıl çağrılacağıyla ilgili bir örnek aşağıda verilmiştir:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Uyumlulaştırma kullanıyorsanız tüm uyumlulaştırma bağdaştırıcıların başlatıldığından emin olmak için reklamları yüklemeden önce geri çağırma işlevinin gerçekleşmesini bekleyin.

Reklam biçimi seçme

Google Mobile Ads SDK'sı artık Android veya iOS platformuna dağıtırken Unity uygulamanıza dahil edilmiştir. Artık reklam uygulamaya hazırsınız. AdMob, en iyi kullanıcı deneyimini sunan reklam biçimini seçebilmeniz için çeşitli reklam biçimleri sunar.

Banner

Banner reklam birimleri, uygulama düzeninin bir kısmını kaplayan dikdörtgen reklamlar gösterir. Belirli bir süre sonra otomatik olarak yenilenebilirler. Bu, uygulamanızda aynı ekranda kalsalar bile kullanıcıların düzenli aralıklarla yeni bir reklam görecekleri anlamına gelir. Ayrıca, uygulanması en basit reklam biçimidir.

Banner reklamları uygulama

Geçiş reklamı

Geçiş reklamı birimleri, uygulamanızda tam sayfa reklamlar gösterir. Bu reklam birimlerini uygulamanızın arayüzündeki doğal bekleme ve geçiş alanlarına yerleştirin (ör. bir oyun uygulamasında seviye atlanmasından sonra).

Geçiş reklamları uygulama

Yerel biçim

Yerel reklamlar, başlık ve harekete geçirici mesaj gibi öğelerin uygulamalarınızda sunulma şeklini özelleştirebileceğiniz reklamlardır. Reklamı kendiniz biçimlendirerek zengin bir kullanıcı deneyimine katkıda bulunabilecek doğal ve rahatsız edici olmayan reklam sunumları oluşturabilirsiniz.

Yerel reklamları uygulama

Ödüllü

Ödüllü reklam birimlerinde kullanıcılar jeton, ek can veya puan toplamak için oyun oynayabilir, anket yapabilir veya video izleyebilir. Farklı reklam birimleri için farklı ödüller belirleyebilir ve kullanıcının aldığı ödül değerlerini ve öğeleri belirtebilirsiniz.

Ödüllü reklamları uygulama

Ödüllü geçiş reklamı

Ödüllü geçiş reklamı, doğal uygulama geçişleri sırasında otomatik olarak görünen reklamlar için para veya ek can gibi ödüller sunmanızı sağlayan yeni ve teşvik edici bir reklam biçimidir.

Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamı görüntülemeyi etkinleştirmesi gerekmez.

Ödüllü reklamlardaki etkinleştirme istemi yerine ödüllü geçiş reklamlarında ödülü bildiren ve kullanıcılara dilediklerinde bu seçeneği devre dışı bırakma şansı sunan bir tanıtım ekranı gerekir.

Ödüllü geçiş reklamlarını uygulama

Uygulama açılışı

Uygulama açılışı, kullanıcılar uygulamanızı açtığında veya uygulamanıza geri döndüğünde görünen bir reklam biçimidir. Reklam, yükleme ekranının üzerinde çıkar.

Uygulama açılış reklamlarını uygulama