Google Mobile Ads Unity eklentisini ayarlama

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

Google Mobil Reklamlar 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 isteğinde bulunma 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 daha yeni 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 daha yeni bir sürüm
    • iOS 13.0 veya sonraki sürümleri hedefleyin.
    • CocoaPods
  • Android'e dağıtmak için
    • Minimum Android API düzeyi 24 veya üstü olmalıdır.
    • Android API düzeyi 35 veya sonraki sürümleri hedefleyin

Android API düzeyi, Project Settings > Player > Android > Other Settings > Other Settings 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 cihazı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 with UI

  1. Unity menü seçeneğini belirleyerek Edit > Project Settings > Package Manager (Düzenle > Proje Ayarları > Paket Yöneticisi) paket yöneticisi ayarlarını açın.

  2. OpenUPM'yi Paket Yöneticisi 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'ı belirleyerek paket yöneticisi menüsünü açın.

  4. Yönetici kapsamı açılır listesini Kayıtlarım'ı seçmek için ayarlayın.

  5. Paket listesinden Google Mobile Ads for Unity paketini seçin ve Install'a (Yükle) 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 cihazı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 getirin. v öneki hariç olmak üzere etiketin döndürdüğü sürüm Google Mobile Ads Unity Plugin'dir.

    • 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ığı 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.5.0"
  }
}

.unitypackage eklenti öğelerini kaldırma

.unitypackage kullanımdan OpenUPM'ye geçiyorsanız öğeleri eski konumdan manuel olarak kaldırmanız gerekir. .unitypackage cihazı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. .unitypackage sürümünü GitHub'dan indirin.
  2. .unitypackage dosyasını, Unity menü seçeneği Assets > Import package > Custom Package'ı belirleyip tüm öğeleri içe aktararak içe aktarın.

AdMob uygulama kimliğinizi ayarlama

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

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

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

SDK'yı başlatma

Reklamları yüklemeden önce uygulamanızın Google Mobile Ads Unity Plugin başlatmasını sağlamak için MobileAds.Initialize() çağrısını yapın. Bu işlem yalnızca bir kez yapılmalıdır. İdeal olarak uygulama başlatılırken yapılabilir.

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.");

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

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

Google Mobile Ads Unity Plugin, arka plan iş parçacığında reklam etkinlikleri oluşturur. Reklam geri çağırmaları, UnityEngine gibi Unity nesneleriyle etkileşimde bulunuyorsa 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, Android veya iOS platformuna dağıtıldığında 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 sunulma ş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.

Doğal 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 reklam göstererek 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ının üzerinde çıkar.

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