Başlayın

Google Mobil Reklamlar Unity eklentisi, Unity geliştiricilerinin Java veya Objective-C kodu yazmak zorunda kalmadan Android ve iOS uygulamalarında Google mobil reklamları sunmasını sağlar. Eklenti, Unity projenizde C# komut dosyaları tarafından kullanılan reklamları istemek için bir C# arayüzü sunar.

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

Ön koşullar

  • Unity 2019.4 veya sonraki bir sürümü kullanma
  • iOS'a dağıtmak için
    • Xcode 15.3 veya üstü
    • iOS 12.0 veya sonraki sürümleri hedefleyin
    • CocoaPods
  • Android'e dağıtmak için
    • Minimum Android API düzeyi 21 veya üstü
    • Android API düzeyi 31 veya üstünü hedefleyin

Android API düzeyi, 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

Unity için Google Mobile Ads eklentisi; GitHub ve OpenUPM depolarımızda bir .unitypackage olarak dağıtılır.

GitHub'dan içe aktar

  1. En son .unitypackage sürümünü GitHub'dan indirin.
  2. 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.

OpenUPM ile içe aktar

OpenUPM CLI ile OpenUPM kayıt defterini yükleme

OpenUPM CLI yüklüyse aşağıdaki komutla OpenUPM kayıt defterini yükleyebilirsiniz:

openupm add com.google.ads.mobile

OpenUPM kayıt defterini manuel olarak yükleme

  1. Unity menü seçeneği olan Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçerek 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

Unity için Google Mobil Reklamlar paketini yükleyin

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

  2. Yönetici kapsamı açılır menüsünü kullanarak Kayıt Kayıtlarım'ı seçin.

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

Eski içe aktarmaları kaldır

.unitypackage içe aktarmasını kaldırmak için 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

Dış bağımlılıkları dahil etme

Google Mobil Reklamlar Unity eklentisi Unity Play Hizmetleri Çözümleyici kitaplığı ile birlikte dağıtılır. Bu kitaplık, AAR'ler veya iOS CocoaPods gibi Android'e özel kitaplıklara erişim gerektiren tüm Unity eklentilerinin kullanması için tasarlanmıştır. Unity eklentilerine bağımlılıkları bildirme özelliği sunar. Bu işlem daha sonra otomatik olarak çözümlenir ve Unity projenize kopyalanır.

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

Android

Proje Ayarları > Oynatıcı > Android > Yayınlama Ayarları > Derleme bölümüne gidip seçin:

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

Unity düzenleyicide Öğeler > Harici Bağımlılık Yöneticisi > Android Çözümleyici > Çözüm'ü seçerek, Unity External Dependency Manager kitaplığının beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalamasını sağlayın.

iOS

Google Mobile Ads SDK'sını Unity projesine eklemek için ek adım gerekmez.

iOS bağımlılıkları CocoaPods kullanılarak tanımlanır. CocoaPods, derleme sonrası süreç adımı olarak çalıştırılır.

  • Unity 5.6 veya sonraki sürümler kullanılırken gerekli bağımlılık kitaplıklarını içeren bir xcworkspace oluşturulur. Standart Xcode projesinin yerine oluşturulan xcworkspace'i kullanın.
  • Unity'nin önceki sürümleri kullanılırken bağımlılıklar standart Xcode projesine dahil edilir.

Google Mobile Ads Unity eklentisi bağımlılıkları Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml sayfasında listelenmiştir.

Uygulama kimliğinizi Ad Manager ayarlayın

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

Android ve iOS Ad Manager uygulama kimliğinizi her bir alana girin.

SDK'yı başlatma

Reklamları yüklemeden önce uygulamanızın MobileAds.Initialize() yöntemini çağırarak Google Mobile Ads SDK'sını başlatmasını sağlayın. Bu işlem yalnızca bir kez, ideal olarak uygulamanın lansmanında yapılması gerekir.

GameObject öğesine ekli bir komut dosyasının Start() yönteminde Initialize() çağrısının nasıl yapılacağına dair 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 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 sunduğu için en iyi kullanıcı deneyimi için en uygun olan biçimi seçebilirsiniz.

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örüntüledikleri anlamına gelir. Ayrıca, bu reklamlar aynı zamanda uygulanması en basit reklam biçimidir.

Banner reklamları uygulama

Geçişli

Geçiş reklamı birimleri, uygulamanızda tam sayfa reklamlar gösterir. Bunları, uygulamanızın arayüzündeki doğal ara ve geçişlere (ör. bir oyun uygulamasında seviye tamamlandıktan sonra) yerleştirin.

Geçiş reklamlarını uygulama

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 stilini kendiniz belirleyerek, zengin bir kullanıcı deneyimine katkıda bulunabilecek, doğal ve göze batmayan bir reklam sunusu oluşturabilirsiniz.

Yerel reklamlar uygulama

Ödül olarak verildi

Ödüllü reklam birimleri, kullanıcıların oyun oynayarak, anket yaparak veya video izleyerek jeton, ek can veya puan gibi uygulama içi ödüller kazanmalarını sağlar. Farklı reklam birimleri için farklı ödüller belirleyebilir ve kullanıcının aldığı ödül değerlerini ve öğelerini belirtebilirsiniz.

Ödüllü reklamları uygulama