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 15.3 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 21 veya daha yeni sürümler
- Android API düzeyi 34 veya sonraki sürümleri hedefleyin
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
- Düzenle > Proje Ayarları > Paket Yöneticisi Unity menü seçeneğini belirleyerek paket yöneticisi ayarlarını açın.
OpenUPM'yi Paket Yöneticisi penceresine kapsamlı bir kayıt defteri olarak ekleyin:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Unity menü seçeneği Pencere > Paket Yöneticisi'ni seçerek paket yöneticisi menüsünü açın.
Yönetici kapsamı açılır menüsünü Kayıt otoritelerim'i seçecek şekilde ayarlayın.
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
- GitHub'dan en son
.unitypackage
sürümünü indirin. - Öğ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ık beyan etme olanağı sağlar. Bu bağımlılıklar daha sonra otomatik olarak çözülür ve Unity projenize kopyalanır.
Projenizin tüm bağımlılıkları içerdiğinden emin olmak için aşağıdaki adımları uygulayın:
Yapay Zeka
Proje Ayarları > Oynatıcı > Android > Yayınlama Ayarları > Derleme'ye gidin ve şunları 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.
Ad Manager Uygulama kimliğinizi ayarlama
Unity düzenleyicisinde menüden Öğeler > Google Mobil Reklamlar > Ayarlar'ı seçin.
Android ve iOS Ad Manager 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.
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.
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).
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 tasarlayarak zengin bir kullanıcı deneyimine katkıda bulunabilecek doğal ve rahatsız edici olmayan reklam sunumları oluşturabilirsiniz.
Ö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 alacağı ödül değerlerini ve öğeleri belirtebilirsiniz.