Unity Geliştiricileri için Open Mediation ve HMS Unity Plugin ile Reklam Entegrasyonunu Kolaylaştırma

Hilal Tepecik
Huawei Developers - Türkiye
6 min readMar 31, 2023
Image by PIRO from Pixabay

Giriş🎸

Uygulama geliştiricileri için, reklamların uygulamalara entegre edilmesi, gelir elde etmek için harika bir yöntemdir. Popüler bir platform olan Open Mediation uyumlulaştırması, reklam göstermek isteyen birçok geliştiricinin tercih ettiği bir seçenektir. Ancak, uygulamanızın gelir potansiyelini en üst düzeye çıkarmak ve daha geniş bir kitleye ulaşmak istiyorsanız, Huawei Ads’i Unity’de HMS Unity Plugin kullanarak Open Mediation uyumluluğuna entegre edebilirsiniz. Bu yazı, bu süreçte size yol gösterecek!

Open Mediation Nedir?

Open Mediation, uygulama geliştiricilerin birden çok reklam ağını ve talep kaynağını tek bir birleştirilmiş SDK entegrasyonunda kolayca yönetmesine olanak tanıyan bir mobil reklam aracılık platformudur. Açık Uyumlulaştırma ile geliştiriciler, AdMob, Facebook Audience Network ve Unity Ads gibi popüler ağlar da dahil olmak üzere çok çeşitli küresel talep kaynaklarına erişerek reklam entegrasyonunun karmaşıklığını ve zahmetini azaltabilir ve gelir potansiyellerini en üst düzeye çıkarabilir. Ayrıca Open Mediation, geliştiricilerin para kazanma stratejilerini optimize etmelerine ve uygulamalarının kullanıcı deneyimini iyileştirmelerine yardımcı olmak için gerçek zamanlı reklam performansı analizi ve optimizasyon araçları sağlar.

HMS Unity Plugin Nedir? 🤖

HMS Unity Plugin, Huawei Mobil Hizmetleri ve Unity arasındaki entegrasyonu kolaylaştıran bir açık kaynak eklentidir. Bu eklenti, geliştiricilere Huawei Reklamları dahil olmak üzere Hesap Yönetimi, Uygulama içi alım gibi birçok hizmet sunar ve HMS Unity Eklentisi ile Open Mediation uyumlu hale getirilebilir. Huawei Reklamları, uygulamaların daha geniş bir kitleye ulaşmasına ve daha fazla kazanç elde etmesine yardımcı olur.

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 Open Mediation entegrasyonuna geçmeden önce, aşağıdaki ön koşulu başarıyla tamamladığınızdan emin olun:

  • Unity Projesi: HMS Unity Plugin ve Open Mediation entegrasyonu yapabilmek için açık bir Unity projesine ihtiyacınız vardır. Unity Editörünü indirip yükleyerek yeni bir proje oluşturabilirsiniz.
  • Uyumlulaştırma Oluşturma: Open Mediation 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 Open Mediation uyumlulaştırmasıyla entegre etme kısmına geçelim. Bu amaçla, size 5 kolay adımı sağlayacağız.

  1. 🔧 Open Mediation işlevini etkinleştirmek için Open Mediation Unity 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.

Başlayalım!

1️⃣ Adım 1: Open Mediation Unity SDK’sını yükleyin 🔧

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

Open Mediation Unity SDK Yükleme

📌Not: Kullandığınız Unity Sürümüne ile Open Mediation Unity Entegrasyonu sürümü indirmeyi unutmayın. Ben OpenMediationUnity(2021.2.1.5) indirdim.

İlk olarak açılan package manager resolver üzerinde Add Selected Registries’e tıklayın.

Package Manage Resolver

Daha sonra paket taşıma ile ilgili migration pop-up’ı çıkacaktır karşınıza. Apply’a tıklayın.

Paket Taşıma

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”, ve “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.

HMS Unity Package İndirme

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

Open Mediation 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.

🎥Son durumda baseProjectTemplate.gradle şu şekilde görünmelidir;

baseProjectTemplate.gradle

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 durumda mainTemplate.gradle şu şekilde görünmelidir;

mainTemplate.gradle

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

🎥Son durumda gradleTemplate.properties bu şekilde görünmelidir;

gradleTemplate.properties

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. Sadece bu kadardı!

🖼️ Huawei Reklamlarını Gösterin 🖼️

Entegrasyon tamamlandığında artık reklamları görüntüleyebilirsiniz. Huawei reklamları için Open Mediation üzerinden desteklenen Reklam türlerinin Banner, Interstitial and Rewarded (Ödüllü) reklamlar olduğunu unutmayın. Bir önceki cümlede linke tıklayarak ilgili kod örneklerini bulabilirsiniz. Reklamları initialize etmek için ise bu guide’dan faydalanabilirsiniz;

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

OpenMediation Reklam Gösterimi

Sonuç🎉

Open Mediation uyumluluğunu Huawei Ads ile birleştirdiğinizde daha geniş bir kitleye ulaşabilir ve uygulamanızdan daha yüksek bir gelir elde edebilirsiniz.

HMS Unity Plugin, reklam gösterimini kolaylaştırarak bu süreci daha da basitleştirir. Yüklediğiniz Unity sürümüne uygun Open Mediation Unity Entegrasyonu sürümünü indirmeyi unutmayın. Böylece, HMS Unity Eklentisini kullanarak Huawei Ads’i Unity’de Open Mediation uyumluluğuna entegre etmek, basit ve doğrudan bir işlem olacaktır. Bu makale, size adım adım rehberlik ederek bu entegrasyonu gerçekleştirmenize yardımcı olacaktır.

Herhangi bir sorunuz veya yorumunuz varsa, lütfen aşağıda belirtin.

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

Referanslar🛸

--

--

Hilal Tepecik
Huawei Developers - Türkiye

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