Google Mobile Ads Unity eklentisi, Unity geliştiricilerinin Java veya Objective-C kodu yazmak zorunda kalmadan Android ve iOS uygulamalarında Google mobil reklamları sunmalarına olanak tanır. Eklenti, Unity projenizde C# komut dosyaları tarafından kullanılan reklamları istemek için bir C# arayüzü sağlar.
Bu kılavuz, Unity uygulamalarından para kazanmak isteyen yayıncılara yöneliktir.
Ön koşullar
- Unity 2019.4 veya daha yeni 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 hedefleme
- CocoaPods
- Android'e dağıtım yapmak için
- Minimum Android API düzeyi 21 veya üstü
- Android API düzeyi 31 veya sonraki sürümleri hedefleyin
Android API düzeyi, Proje Ayarları > Oynatıcı > Android > Diğer Ayarlar > Diğer Ayarlar bölümünden ayarlanır.
Unity için Mobil Reklamlar eklentisini içe aktarma
OpenUPM-KSA
OpenUPM CLI yüklüyse aşağıdaki komutu kullanarak OpenUPM kayıt defterini yükleyebilirsiniz:
openupm add com.google.ads.mobile
.unitypackage
eklenti öğesini kaldırın
.unitypackage
kullanımından OpenUPM kullanımına geçiş yapıyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage
hizmetinden içe aktarılan aşağıdaki dizinleri kaldırın:
- Öğeler/ExternalDependencyManager
- Öğeler/GoogleMobil Reklamlar
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- Unity menü seçeneğini belirleyerek Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçerek paket yöneticisi ayarlarını açın.
Paket Yöneticisi penceresine kapsamlı bir kayıt defteri olarak OpenUPM'yi ekleyin:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Unity menü seçeneğini 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 Defterlerim'i seçin.
Paket listesinden Unity için Google Mobil Reklamlar paketini seçin ve Yükle'ye basın.
.unitypackage
eklenti öğesini kaldırın
.unitypackage
kullanımından OpenUPM kullanımına geçiş yapıyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage
hizmetinden içe aktarılan aşağıdaki dizinleri kaldırın:
- Öğeler/ExternalDependencyManager
- Öğeler/GoogleMobil Reklamlar
- 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 aktar
- GitHub'dan en son
.unitypackage
sürümünü indirin. - Unity menü seçeneğini Öğeler > Paketi içe aktar > Özel Paket'i seçip tüm öğeleri içe aktararak
.unitypackage
dosyasını içe aktarın.
Dış bağımlılıkları dahil etme
Google Mobile Ads Unity eklentisi Unity Play Services Çözümleyici kitaplığı ile birlikte dağıtılır. Bu kitaplık, AAR'ler veya iOS CocoaPods gibi Android'e özgü kitaplıklara erişim gerektiren tüm Unity eklentileri tarafından kullanılmak üzere tasarlanmıştır. Unity eklentilerine bağımlılıkları bildirebilir, bu bağımlılıklar daha sonra otomatik olarak çözülüp 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:
Android
Proje Ayarları > Oynatıcı > Android > Yayınlama Ayarları > Derleme bölümüne gidin ve şunları seçin:
- Özel Ana Gradle Şablonu
- Özel Gradle Özellikleri Şablonu
Unity Editor'da Assets > External Dependency Manager > Android
Çözümleyici > Çöz'ü seçerek Unity Harici Bağımlılık Yöneticisi kitaplığının beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android
dizinine kopyalamasını sağlayın.
iOS
iOS için Unity, bağımlılıkları belirlemek ve yönetmek için CocoaPods kullanır. iOS bağımlılıklarınızla ilgili özel gereksinimler veya sorun giderme adımları için CocoaPods belgelerini inceleyin.
Google Mobile Ads Unity eklentisi bağımlılıkları Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
konumunda listelenmiştir.
Uygulama kimliğinizi Ad Manager ayarlayın
Unity Editor'da menüden Öğeler > Google Mobile Ads > Ayarlar'ı seçin.
Her alana Android ve iOS Ad Manager uygulama kimliğinizi girin.
SDK'yı başlatma
Reklamları yüklemeden önce, MobileAds.Initialize()
numaralı telefonu çağırarak uygulamanızın Google Mobile Ads SDK'sını başlatmasını sağlayın. Bu işlemin yalnızca bir kez yapılması gerekir. İdeal olanı, uygulama lansmanıdır.
GameObject
öğesine ekli bir komut dosyasının Start()
yöntemi içinde Initialize()
yönteminin nasıl çağrılacağıyla ilgili bir örneği aşağıda bulabilirsiniz:
...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize(initStatus => { });
}
}
Uyumlulaştırma özelliğini kullanıyorsanız tüm uyumlulaştırma bağdaştırıcılarının başlatıldığından emin olmak için reklamları yüklemeden önce geri çağırmanın gerçekleşmesini bekleyin.
Reklam biçimi seçin
Google Mobile Ads SDK'sı artık Android veya iOS platformuna dağıtım yaparken Unity uygulamanıza dahil edildi. Artık bir reklam uygulamaya hazırsınız. AdMob bir dizi farklı reklam biçimi sunar. Bu sayede en iyi kullanıcı deneyimi için en uygun olanı seçebilirsiniz.
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. Diğer bir deyişle, kullanıcılar uygulamanızda aynı ekranda kalsalar bile düzenli aralıklarla yeni bir reklamı görürler. Aynı zamanda, uygulanması en basit reklam biçimidir.
Geçişli
Geçiş reklam birimleri, uygulamanızda tam sayfa reklamlar gösterir. Bu reklamları, bir oyun uygulamasında seviye atlanması gibi doğal aralara ve geçişlere yerleştirin.
Yerel biçim
Yerel reklamlar, başlıklar ve harekete geçirici mesajlar gibi öğelerin uygulamalarınızda sunulma şeklini özelleştirebileceğiniz reklamlardır. Reklamın stilini kendiniz belirleyerek, zengin bir kullanıcı deneyimine katkıda bulunabilecek doğal ve rahatsız edici olmayan reklam sunumları oluşturabilirsiniz.
Ödül olarak verildi
Ödüllü reklam birimleri, kullanıcıların jeton, ek can veya puan gibi uygulama içi ödüller kazanmak için oyun oynamasına, anket yanıtlamasına veya video izlemesine olanak tanır. Farklı reklam birimleri için farklı ödüller ayarlayabilir ve kullanıcının aldığı ödül değerlerini ve öğelerini belirtebilirsiniz.