🤝 HMS Unity Plugin ve Google AdMob’u Birlikte Entegre Ederek Huawei Reklamları Yayınlama Kılavuzu

Hilal Tepecik
Huawei Developers - Türkiye
5 min readMar 23, 2023
Image by Carlos / Saigon — Vietnam from Pixabay

Giriş🌟

Bir geliştirici olarak, uygulamanıza reklamları entegre etmek, uygulamanızdan para kazanmanın ve gelir elde etmenin harika bir yolu olabilir. AdMob/Google Ads uyumlulaştırması, birçok geliştiricinin uygulamalarında reklam görüntülemek için kullandığı popüler bir platformdur. Ancak, daha geniş bir kitleye ulaşmak ve uygulamanızın gelir potansiyelini en üst düzeye çıkarmak istiyorsanız HMS Unity Plugin kullanarak Unity’de Huawei Ads’i AdMob/Google Ads uyumlulaştırmasıyla entegre etmeyi düşünebilirsiniz. Bu yazıda, süreç boyunca size rehberlik edeceğiz!

HMS Unity Plugin Nedir? 🤔

HMS Unity Plugin, geliştiricilerin Huawei Mobil Hizmetlerini (HMS) Unity ile entegre etmesine izin veren bir eklentidir. HMS, HMS Unity Eklentisi kullanılarak AdMob/Google Ads uyumlulaştırmasıyla entegre edilebilen Huawei Reklamları da dahil olmak üzere çok çeşitli hizmetler sunar. Geliştiriciler, Huawei Reklamlarını entegre ederek daha geniş bir kitleye ulaşabilir ve daha fazla gelir elde edebilir.

HMS Unity Plugin’i kullanmanın faydaları şunları içerir:

  • 🤝💻💼 — HMS hizmetleriyle kolay entegrasyon
  • 🚀📈💪 —Geliştirilmiş uygulama performansı ve kararlılığı
  • 💰💸💵 — Artan gelir potansiyeli
  • 🆕🔥📱 — Yeni özelliklere ve hizmetlere erişim

Önkoşullar: 📋

HMS Unity Plugin ve Google AdMob entegrasyonuna geçmeden önce, aşağıdaki ön koşulu başarıyla tamamladığınızdan emin olun:

  • Uyumlulaştırma Oluşturma: Google AdMob hesabınızda uyumlulaştırma grupları ve Reklam birimleri kurduğunuzdan ve Huawei Reklamlarını bir uyumlulaştırma ağı olarak doğru şekilde yapılandırdığınızdan emin olun. Bu, her iki platformdan da reklamları sorunsuz bir şekilde görüntülemenizi sağlayacaktır. 🔄🔗

Şimdi HMS Unity Eklentisini kullanarak Huawei Ads’i Unity’de AdMob/Google Ads uyumlulaştırmasıyla entegre etme kısmına geçelim. Bu amaçla, size 6 kolay adımı sağlayacağız.

  1. 🔧 AdMob işlevini etkinleştirmek için Google Mobile Ads SDK’sını yükleyin.
  2. ⚙️ Özel Gradle dosyaları için Unity proje ayarlarını yapılandırın.
  3. 🌐 Projeniz için HMS Unity Plugin’i içe aktarın ve ayarlayın.
  4. 📝 Gradle dosyalarını gerekli kod parçacıklarıyla değiştirin ve kaydedin.
  5. ✅ HMS Unity Eklentisinde Reklam Kitini etkinleştirin.
  6. 🖼️ Hem Google AdMob hem de HMS Unity Plugin’den reklamlar görüntüleyin.

Başlayalım!

1️⃣ Adım 1: Google Mobile Ads SDK’sını yükleyin 🔧

Bu entegrasyon sürecindeki ilk adım, Google Mobile Ads SDK’sını Unity projenize yüklemektir. Bu SDK, uygulamanızda Google AdMob reklamlarını görüntülemek için gereken araçları sağlar. Başlamak için Google AdMob’ resmi Unity plugin dökümantasyonunu takip etmeniz yeterlidir.

Admob Mobile SDK

Geliştirmenizi XCode üzerinde yapmıyorsanız XCode ile ilgili hata almamak için Google.IOSResolver.dll dosyasını silin.

Google.IOSResolver.dll

2️⃣ 2. Adım: Proje Ayarlarınızı Yapılandırın ⚙️

Ardından, Unity Editörünüze gidin ve şu adımları izleyin:

“Edit” -> “Project Settings” ->“Player” -> “Publishing Settings”

  • “Custom Main Gradle”, “Custom Base Gradle”, ve “Custom Gradle Properties.” yanlarındaki kutucukları işaretleyin.
“Custom Main Gradle”, “Custom Base Gradle”, “Custom Gradle Properties.”

Bu ayarlar, projenizin entegrasyon için hazırlanmasını sağlar.

3️⃣ 3. Adım: HMS Unity Eklentisini Kurun ve Projeyi Ayarlayın 🌐
HMS Unity Plugin’i indirin ve projenize aktarın. Eklentiyi içe aktardıktan sonra, HMS entegrasyonunu sağlamak için proje ayarlarınızı gerektiği gibi ayarladığınızdan emin olun. Ayrıntılı talimatlar resmi olarak HMS Unity Plugin’de bulunabilir.

4️⃣ Adım 4: Gradle Dosyalarını Değiştirin ve Kaydedin 📝

Google AdMob ile HMS Unity Plugin arasında sorunsuz uyumluluk sağlamak için Gradle dosyalarınıza bazı özel kod parçacıkları eklemeniz gerekir. Assets -> Plugins -> Android.

Note: Before Unity 2019.2, there is only one Gradle template, which is Custom Gradle Template.

baseProjectTemplate.gradle dosyasını bir metin düzenleyicide açın ve uyumlulaştırma için şu satırları ekleyin:

Not: Unity sürümü 2019.2'den 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:

Bu makaleyi yazarken en son sürüm 2.0.2'dir, bu nedenle kod parçacığı şöyle olacaktır;

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

5️⃣ 5. Adım: HMS Unity Eklentisinde Reklam Kitini Etkinleştirin ⚙️

Şimdi Unity Editor’a geri dönün ve şu adımları izleyin:

  • “Huawei”ye tıklayın.
  • “Kit Settings.”e gidin
  • “Ads Kit” option seçeneğini etkinleştirin.
HMS Unity Plugin Kitleri

Bu, HMS Unity Eklentisinin uygulamanızda Huawei reklamlarını göstermeye hazır olmasını sağlayacaktır.

6️⃣ Adım 6: Huawei Reklamlarını Gösterin 🖼️

Entegrasyon tamamlandığında artık reklamları görüntüleyebilirsiniz. Burada, banner reklamları görüntülemek için bir kod örneği verilmiştir. Huawei reklamları için desteklenen Reklam türlerinin Banner, Interstitial and Rewarded (Ödüllü) reklamlar olduğunu unutmayın. Bir önceki cümlede her bir reklam türüne tıklayarak daha fazla örnek bulabilirsiniz.

Bu komut dosyasını sahnedeki bir oyun nesnesine ekler ve kullandığınız cihaz için oluşturursanız, projeniz için Huawei Reklamları hazır olacaktır.

💥Build alırken sık karşılaşılan bir hata olan java.lang.UnsupportedOperationException hatasını alırsanız, minimum API kullandığınız cihazla uyumlu olan bir API Level’i ile değiştirin

java.lang.UnsupportedOperationException

Edit -> Project Settings -> Player -> Other Settings

Minimum API leveli en düşük 21 olabilir. Benim kullandığım cihaz en yüksek 30 desteklemekte.

Daha fazla açıklama için lütfen bu belgelere bakın.💥

İşte Admob Kullanarak oluşturduğumuz build ile Huawei Ads’den iki gerçek banner reklam🔮

Huawei Ads Admob ile Gösterim
Huawei Ads Admob ile Gösterim

Sonuç🎉

Sonuç olarak, yukarıda belirtilen adımları izlerseniz, HMS Unity Eklentisini kullanarak Huawei Ads’i Unity’de AdMob/Google Ads uyumlulaştırmasıyla entegre etmek basit ve doğrudan bir işlem olabilir.

AdMob/Google Ads uyumlulaştırmasının ve Huawei Ads’in güçlü yanlarını birleştirerek daha geniş bir kitleye ulaşabilir ve daha yüksek reklam geliri elde edebilirsiniz. HMS Unity Plugin’in yardımıyla Huawei Reklamlarını kolayca entegre edebilir ve avantajlarından yararlanabilirsiniz!🖖🏽

Umarız bu makale, HMS Unity Plugin kullanarak Unity’de Huawei Ads’i AdMob/Google Ads uyumlulaştırmasıyla entegre etme sürecinde size rehberlik etmede yardımcı olmuştur. Herhangi bir sorunuz veya yorumunuz varsa, lütfen bunları aşağıda bırakmaktan çekinmeyin.

Başka bir yazıda görüşmek üzere!

Image by Gerd Altmann from Pixabay

References

--

--

Hilal Tepecik
Huawei Developers - Türkiye

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