Google Mobile Ads Unity eklentisini ayarlama

Platform seçin: Android iOS Unity Flutter Android (Eski)

Google Mobil Reklamlar Unity eklentisi, Unity geliştiricilerinin 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 reklamları 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.
  • 2022.2 veya daha yeni bir sürümü kullanmanızı öneririz.
• iOS'e dağıtmak için
  • Xcode 16.0 veya sonraki sürümler
  • iOS 13.0 veya sonraki sürümleri hedefleme
  • CocoaPods
• Android'e dağıtmak için
  • Minimum Android API düzeyi 24 veya daha yüksek olmalıdır.
  • Android API düzeyi 35 veya sonraki sürümleri hedefleme

• Önerilen: AdMob hesabı oluşturun ve Android veya iOS uygulaması kaydedin

Android API düzeyi, 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 öğesini kaldırma

.unitypackage kullanmaktan OpenUPM kullanmaya geçiyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage uygulamasından 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

Kullanıcı arayüzü ile OpenUPM

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

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 menüsünü Kayıt Defterlerim'i seçecek şekilde ayarlayın.

   

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

.unitypackage eklenti öğesini kaldırma

.unitypackage kullanmaktan OpenUPM kullanmaya geçiyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage uygulamasından 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. En son sürümün sürüm etiketini alın. Döndürülen etiket, v öneki hariç olmak üzere Google Mobile Ads Unity Plugin sürümüdür.

   • macOS ve Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. Önceki komuttan elde edilen sürümü kullanarak OpenUPM kapsamlı kayıt defterini ve bağımlılığını eklemek için Packages/manifest.json dosyasını değiştirin:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

.unitypackage eklenti öğesini kaldırma

.unitypackage kullanmaktan OpenUPM kullanmaya geçiyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage uygulamasından 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 .unitypackage sürümünü indirin.
2. Öğeler > Paketi içe aktar > Özel Paket Unity menü seçeneğini belirleyip tüm öğeleri içe aktararak .unitypackage dosyasını içe aktarın.

İsteğe bağlı: External Dependency Manager'ı devre dışı bırakma

Android ve iOS kitaplıklarını kendi derleme araçlarınızla yönetiyorsanız com.unity.external-dependency-manager paketini devre dışı bırakabilirsiniz:

Unity Editor'da Window > Package Manager'ı (Pencere > Paket Yöneticisi) seçin ve External Dependency Manager (com.unity.external-dependency-manager) paketini kaldırın. Bu paketin kaldırılması, Assets > Google Mobile Ads > Settings (Öğeler > Google Mobile Ads > Ayarlar) bölümündeki Enable External Dependency Manager (Harici Bağımlılık Yöneticisi'ni Etkinleştir) seçeneğini temizler.

Not: GoogleMobileAdsSettings.asset dosyasını silmek ayarlarınızı sıfırlar ve bir sonraki içe aktarma veya Editor yükleme işleminde com.unity.external-dependency-manager paketini yeniden yükler. Paketi daha sonra yeniden yüklemek için Assets > Google Mobile Ads > Settings (Öğeler > Google Mobile Ads > Ayarlar) bölümüne gidip Enable External Dependency Manager'ı (Harici Bağımlılık Yöneticisi'ni Etkinleştir) seçin.

Eski External Dependency Manager'ı yükleme

Projeniz Unity 2022.2 veya daha eski bir sürümü kullanıyorsa Unity'nin paketini devre dışı bıraktıktan sonra Google'ın eski com.google.external-dependency-manager paketini yükleyebilirsiniz:

• Unity için Harici Bağımlılık Yöneticisi sürümleri sayfasından en son .unitypackage dosyasını indirin ve Assets > Import Package > Custom Package'ı (Öğeler > Paketi İçe Aktar > Özel Paket) seçin.

• Aşağıdaki OpenUPM CLI komutunu çalıştırın:

  openupm add com.google.external-dependency-manager

Yerel bağımlılıkları manuel olarak yapılandırma

Harici Bağımlılık Yöneticisi paketi kullanmıyorsanız Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml ve Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml dosyalarındaki gerekli kitaplıkları derleme dosyalarınıza ekleyin:

• Android için Edit > Project Settings > Player > Android > Publishing Settings > Build'i (Düzenle > Proje Ayarları > Oynatıcı > Android > Yayınlama Ayarları > Derleme) seçin ve Custom Main Gradle Template'i (Özel Ana Gradle Şablonu) etkinleştirin. GoogleMobileAdsDependencies.xml ve GoogleUmpDependencies.xml dosyalarındaki gerekli kitaplıkları Assets/Plugins/Android/mainTemplate.gradle dosyasındaki dependencies bloğuna ekleyin:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  Ayrıca GoogleMobileAdsDependencies.xml dosyasındaki sürümleri kullanarak androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process ve androidx.fragment:fragment paketlerini ekleyin.

• iOS için Xcode projenizi dışa aktarın. GoogleMobileAdsDependencies.xml ve GoogleUmpDependencies.xml dosyalarındaki gerekli kapsülleri, dışa aktarılan proje klasörünüzdeki Podfile dosyasına ekleyin:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  Ardından, dışa aktarılan iOS proje klasörünüzde aşağıdaki komutu çalıştırın:

  pod install --repo-update

AdMob uygulama kimliğinizi ayarlama

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

Android ve iOS AdMob uygulama kimliğinizi ilgili alanlara girin.

Google Mobile Ads Unity Plugin, bu ayarları Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset yapılandırma dosyasına metin olarak kaydeder.

SDK'yı ilk kullanıma hazırlama

Reklamları yüklemeden önce MobileAds.Initialize() yöntemini çağırarak uygulamanızın Google Mobile Ads Unity Plugin başlatmasını sağlayın. Bu işlemin yalnızca bir kez, tercihen uygulama başlatılırken yapılması gerekir.

Uyarı: Reklamlar, MobileAds.Initialize() çağrıldığında Google Mobile Ads Unity Plugin veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir. Avrupa Ekonomik Alanı (AEA), Birleşik Krallık veya İsviçre'deki kullanıcılardan izin almanız gerekiyorsa reklamları yüklemeden önce tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi isteğe özel işaretleri ayarlayın ya da başka bir işlem yapın. Google Mobile Ads Unity Plugin başlatılmadan önce bu işlemi yaptığınızdan emin olun.

MobileAds.Initialize() yöntemini çağırmayla ilgili bir örneği aşağıda bulabilirsiniz:

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

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

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

Ana iş parçacığında Unity nesneleriyle etkileşim kurma

Google Mobile Ads Unity Plugin, arka plan iş parçacığında reklam etkinliklerini tetikler. Reklam geri çağırmaları UnityEngine gibi Unity nesneleriyle etkileşim kuruyorsa MobileAdsEventExecutor.ExecuteInUpdate yöntemini kullanarak bu çalışmayı Unity ana iş parçacığında açıkça planlayın. Uygulama ayrıntıları için Unity ana iş parçacığında reklam etkinliklerini tetikleme başlıklı makaleyi inceleyin.

Bir reklam biçimi seçin

Google Mobile Ads Unity Plugin artık Android veya iOS platformuna dağıtım yaparken 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

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ş alanlarına yerleştirin (ör. bir oyun uygulamasında seviye atlanmasından sonra).

Geçiş reklamlarını uygulama

Yerel biçim

Doğal 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, göze batmayan reklam sunumları oluşturabilirsiniz.

Doğal reklamları uygulama

Ödüllü

Ödüllü reklam birimleri, kullanıcıların jeton, ekstra can veya puan gibi uygulama içi ödüller kazanmak için oyun oynamasına, anketlere katılmasına ya da video izlemesine olanak tanır. 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ı 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ıyla yer paylaşımlı olarak gösterilir.

Uygulama açılış reklamlarını uygulama