HMS Unity Pluginini Kullanarak IronSource Uyumlulaştırmasını Huawei Ads ile Entegre Etme: Adım Adım Kılavuz

Hilal Tepecik
Huawei Developers - Türkiye
4 min readApr 3, 2023
Resim stokpic tarafından Pixabay’a yüklendi

Giriş:🛸

Mobil oyun endüstrisi genişlemeye devam ederken, geliştiriciler uygulamalarından para kazanmanın etkili yollarını arıyor. Popüler çözümlerden biri, IronSource gibi uyumlulaştırma platformları aracılığıyla reklamları dahil etmektir. Bu makale, Huawei Mobile Services (HMS) Unity eklentisini kullanarak IronSource arabuluculuğunu Huawei Ads ile entegre etme sürecinde size rehberlik edecektir. Bu adımları izleyerek, Unity oyununuzda birden çok ağdan reklam sunarak gelirinizi en üst düzeye çıkarabileceksiniz.💰

🔩IronSource Nedir?

Ironsource logo

IronSource uyumlulaştırması, mobil uygulama geliştiricilerin birden çok reklam ağını ve talep kaynağını yönetip tek bir arabirim üzerinden uygulamalarına entegre ederek geliri optimize etmelerine yardımcı olan bir platformdur. Geliştiriciler, IronSource uyumlulaştırması ile daha iyi bir kullanıcı deneyimi için performans metriklerini görüntüleyebilir, reklam önceliklendirme kuralları belirleyebilir ve reklam dağıtımını optimize edebilir.
Platform, banner, geçiş reklamı, ödüllü video ve yerel reklamlar dahil olmak üzere çeşitli reklam biçimlerini destekler. Geliştiriciler, IronSource aracılığını kullanarak reklam gelirlerini artırırken reklamların alakalı, müdahaleci olmayan ve iyi zamanlanmış olmasını sağlayabilir.

🌡️HMS Unity Plugin Nedir?

HMS Unity Eklentisi, geliştiricilerin Huawei Mobile Services (HMS) Core SDK’yı Unity projelerine entegre etmelerine olanak tanıyan, Unity oyun motoru için bir eklentidir. Eklenti, geliştiricilerin HMS tarafından sağlanan Ads Kit, Push Kit ve Analytics Kit gibi özelliklere ve hizmetlere erişmesini sağlayan bir dizi araç ve API sağlar. Geliştiriciler, HMS Unity Eklentisini Unity projelerine entegre ederek HMS’nin yeteneklerinden yararlanabilir ve Huawei cihazları için ilgi çekici ve zengin özelliklere sahip mobil uygulamalar oluşturabilir.

🛠 ️Ön koşullar:

-Bir AppGallery Connect hesabı.🔑

-Bir IronSource hesabı.💻

-Ironsource Aracılığı ve Huawei Reklam Yapılandırması.📱

3. madde için bu detaylı kılavuzun “IronSource Üzerinden Hesap Oluşturma ve Unity ile Bağlantı Kurma 🖇” ve “Huawei Reklamlarını IronSource’a Ekleme” bölümlerini takip edebilirsiniz. Gerisini biz devralacağız.

1.Adım:🌌IronSource Unity Eklentisini Kurun 🌌

IronSource Unity Eklentisi, Unity’de IronSource arabuluculuk işlevselliğini etkinleştirir. Eklentiyi yüklemek için şu adımları izleyin:

📥IronSource Unity Plugin’i indirin.

📤Varlıklar > Paketi İçe Aktar > Özel Paket’i seçip indirilen eklentiyi seçerek eklentiyi Unity projenize aktarın.

🚶‍♂️Kurulumu tamamlamak için kurulum sihirbazını takip edin.

IronSource SDK

Her bağımlılığı içe aktardıktan sonra, Android çözümleyiciyi etkinleştirmenizi isteyen bir pop-up olacaktır. Önce “Import”a tıklayarak içe aktarmanız gerekir.

Mobile Dependency Resolver

Android Resolve tamamlandıktan sonra Win32Exception Hatası olacaktır.

Win32Exception

Bunu düzeltmek için bu github repo’sunu ziyaret etmeniz ve gradlew.bat’ı indirmeniz gerekir.

Ve bunu projelerinizin Temp>PlayServicesResolverGradle klasörüne yerleştirmeniz gerekiyor.

gradlew.bat

Şimdi projeye geri dönün ve proje konsolunun boş bir yerine sağ tıklayarak bağımlılıkları yeniden içe aktarın.

Bağımlılıkları Yeniden İçe Aktar

Yeniden içe aktarma tamamlandıktan sonra, Android Çözümleyici gayet iyi çalışmalı ve çözümü tamamlamalıdır.

Çözümleme başarılı

2. Adım: 🛡 ️Yayınlama Ayarlarını Yapılandırın 🛡

  1. Unity’de Edit -> Project Settings -> Player -> Publishing Settings ‘ e gidin.
  2. “Custom Main Gradle Template”, “Custom Base Gradle Template” ve “Custom Gradle Properties Template”ı seçin. Bu, projedeki mainTemplate.gradle, baseProjectTemplate.gradle ve gradleTemplate.properties dosyalarını geçersiz kılmanıza izin verecektir.
“Custom Main Gradle Template”, “Custom Base Gradle Template” ve “Custom Gradle Properties Template”

📝baseProjectTemplate.gradle dosyasını bir metin düzenleyicide açın ve şu maven satırlarını ekleyin:

Not 2: Unity sürümü 2019.2'den daha düşükse, bu maven satırlarının da mainTemplate.gradle içindeki project.repositories bölümüne eklenmesi gerekir. Desteklenen minimum Gradle Tools sürümü 3.4.3'tür.

📝mainTemplate.gradle’ı bir metin düzenleyicide açın ve seçtiğiniz platforma bağlı olarak aşağıdaki uygulama satırlarını ekleyin:

🔍Son versiyonu burdan kontrol edebilirsiniz.

📝Son olarak gradleTemplate.properties dosyasını açın ve aşağıdaki satırları eklediğinizden emin olun:

Adım 3:🔧 HMS Unity Eklentisinin Uygulandığından Emin Olun🔧

  1. HMS Unity Plugin’in en son sürümünü resmi HMS Unity Plugin Gitbook’tan indirin. Henüz yapmadıysanız.

4. Adım: 🔌 Unity projenizde Huawei Reklamlarını başlatın🔌

  1. Projenizde Editor > Huawei > Kit Settings’e gidin.
  2. Ads Kit’i etkinleştirin:
Hms Kitleri

5. Adım: 🧰 Reklam birimlerini uygulayın 🧰

  1. Unity projenizde, uygulamak istediğiniz her reklam birimi için komut dosyaları oluşturun (Huawei reklamları yalnızca ödüllü videoyu, geçiş reklamını destekler).
  2. Oyununuzda reklam yüklemek ve görüntülemek için IronSource’un API yöntemlerini kullanın.
  3. Örneğin, interstatial ve ödüllü reklam yüklemek ve göstermek için komut dosyanıza aşağıdaki kodu ekleyin:

6. Adım: 🕵️‍♀️Entegrasyonunuzu test edin🕵️‍♀️

  1. Unity projenizi bir cihazda oluşturun ve çalıştırın.
  2. Doğru çalıştıklarından emin olmak için uyguladığınız reklam birimlerini test edin.

Ve tebrikler! Sonuna kadar başardınız!

🏁Sonuç:

HMS Unity eklentisini kullanarak IronSource arabuluculuğunu Huawei Ads ile entegre etmek, birden fazla ağdan reklam sunarak mobil oyunlarınızdan etkili bir şekilde para kazanmanıza olanak tanır. Bu kapsamlı kılavuzu takip ederek Unity projenizde bu çözümü kurup uygulayabilir, böylece gelirinizi en üst düzeye çıkarabilir ve oyununuzun kullanıcı deneyimini geliştirebilirsiniz.

Bu kılavuzun yardımcı olduğunu umar ve oyun geliştirme yolculuğunuzda size en iyi dileklerimizi sunarız.

Güle güle ve yakında görüşürüz!

🛰️Referanslar

--

--

Hilal Tepecik
Huawei Developers - Türkiye

Game and SDK Developer @Huawei - Unity, Unreal, HMS Unity Plugin, XR Interactions Toolkit