Başlayın

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

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

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

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

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

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

   

5. 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

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

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.

Önemli: Tüm gizlilik uygunluğu özelliklerine erişmek için Google Mobile Ads SDK'sının son sürümü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 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.

Uyarı: MobileAds.Initialize() çağrıldığında reklamlar, 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 isteğe özel işaretleri ayarlayın veya reklamları yüklemeden önce harekete geçin. Google Mobile Ads SDK'sını başlatmadan önce bunu yaptığınızdan emin olun.

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.

Banner reklam uygulama

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.

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ın stilini kendiniz belirleyerek, zengin bir kullanıcı deneyimine katkıda bulunabilecek doğal ve rahatsız edici olmayan reklam sunumları oluşturabilirsiniz.

Doğal reklam uygulama

Ö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.

Ödüllü reklamları uygulama