Başlama

Platform seçin: Android iOS Unity Flutter

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

Bu kılavuz, Unity uygulamasından para kazanmak isteyen yayıncılar için hazırlanmıştır.

Ön koşullar

  • Unity Editor 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 bir sürümü hedefleyin
    • CocoaPods
  • Android'e dağıtmak için
    • Minimum Android API düzeyi 23 veya üstü olmalıdır.
    • Android API düzeyi 34 veya sonraki sürümleri hedefleyin

Android API seviyesi Project Settings > Player > Android > Other Settings > Other Settings (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 aşağıdaki komutla yükleyebilirsiniz:

openupm add com.google.ads.mobile

.unitypackage eklenti öğelerini kaldırma

.unitypackage kullanımdan OpenUPM'ye geçiyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage öğesinden 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. Paket yöneticisi ayarlarını açmak için Unity menü seçeneği olan Edit > Project Settings > Package Manager'ı (Düzenle > Proje Ayarları > Paket Yöneticisi) seçin.

  2. OpenUPM'yi Package Manager penceresine kapsamlı kayıt defteri olarak ekleyin:

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

  3. Unity menü seçeneği Window > Package Manager'ı (Pencere > Paket Yöneticisi) belirleyerek paket yöneticisi menüsünü açın.

  4. Yönetici kapsamı açılır listesini Kayıtlarım'ı seçecek şekilde ayarlayın.

  5. Paket listesinden Google Mobile Ads for Unity paketini seçin ve Install (Yükle) düğmesine basın.

.unitypackage eklenti öğelerini kaldırma

.unitypackage kullanımdan OpenUPM'ye geçiyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage öğesinden 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. .unitypackage dosyasını, Unity menü seçeneği Öğeler > Paketi içe aktar > Özel Paket'i belirleyip tüm öğeleri içe aktararak içe aktarın.

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

Google Mobile Ads Unity eklentisi, Unity Play Services Resolver 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ı bildirme olanağı tanır. 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:

Android

Project Settings > Player > Android > Publishing Settings > Build'e (Proje Ayarları > Oyuncu > Android > Yayınlama Ayarları > Derleme) gidin ve şunları seçin:

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

Unity External Dependency Manager kitaplığının, bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalaması için Unity düzenleyicide Assets > External Dependency Manager > Android Resolver > Resolve'u 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ızla ilgili özel gereksinimler veya sorun giderme adımları için CocoaPods belgelerine bakın.

Google Mobile Ads Unity eklentisi bağımlılıkları Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml bölümünde listelenmiştir.

AdMob uygulama kimliğinizi ayarlama

Unity Editor'da menüden Assets > Google Mobile Ads > Settings'i (Öğeler > Google Mobil Reklamlar > Ayarlar) seçin.

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

SDK'yı başlatma

Uygulamanız, reklamları yüklemeden önce MobileAds.Initialize() çağırarak Google Mobile Ads SDK'sını ilk kullanıma hazırlamalıdır. Bu işlemin yalnızca bir kez yapılması gerekir. İdeal olarak uygulama başlatılırken yapılmalıdır.

MobileAds.Initialize()'yı çağırma örneğini aşağıda görebilirsiniz:

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

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ğırma işleminin gerçekleşmesini bekleyin.

Bir reklam biçimi seçin

Google Mobile Ads SDK'sı, Android veya iOS platformuna dağıtılırken Unity uygulamanıza dahil edilir. 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 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ş anlarına yerleştirin (ör. bir oyun uygulamasında seviye atlanmasından sonra).

Geçiş reklamlarını uygulama

Yerel biçim

Yerel reklamlar, başlıklar ve harekete geçirici mesajlar gibi öğelerin uygulamalarınızda gösterilme şeklini özelleştirebileceğiniz reklamlardır. Reklamı kendiniz stilize ederek 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