Huawei Reklamlarını OpenMediation Ad Mediation Hizmeti ile Kullanma (Native Android)

Sena Zincircioğlu
Huawei Developers - Türkiye
6 min readDec 9, 2022
Huawei Ads

Giriş

Herkese merhaba,

Bu yazımızda OpenMediation’ın Android SDK ve Huawei Ads adaptörünü kullanılarak nasıl reklam uyumlulaştırma (Ad Mediation) gerçekleştirebileceğimizden bahsedeceğiz.

Entegrasyon adımlarına geçmeden önce Reklam Uyumlulaştırma kavramına ve OpenMediation platformuna bir göz atalım.

Reklam Uyumlulaştırma (Ad Mediation) nedir?

Reklam Uyumlulaştırma ya da diğer adıyla Mediation, birden çok reklam ağının reklam envanterinize erişmesini sağlar ve reklam alanları için birbirleriyle rekabet etmelerini sağlar. Bu süreç, reklamverenler arasındaki rekabeti artırır ve bunun karşılığında da reklam gelirinizi artırır. Mediation platformu, tüm çeşitli reklam ağlarının sunduğu CPM’i kontrol eder ve en yüksek olanı arar.

OpenMediation

OpenMediation, kullanıcı yaşam döngüsü yönetimine odaklanan ve mobil uygulama geliştiricilerinin uygulamadan para kazanmalarını sağlayan bir üçüncü taraf platformudur. Başka bir deyişle OpenMediation, SDK’dan sunucuya, dashboarda ve veri merkezine uçtan uca bir sistem sağlayan tamamen açık bir mediation platformudur.

OpenMediation şu anda aşağıdaki reklam biçimlerini desteklemektedir:

  • Banner
  • Native
  • Interstitial
  • Rewarded

OpenMediation Huawei Ads Adapterının Entegrasyon Aşamaları

Artık Huawei Ads ve OpenMediation SDK’nın mediation yoluyla entegrasyon sürecinden bahsetmeye başlayabiliriz. Bu süreç 3 bölümden oluşmaktadır:

  1. Huawei Ads Console Tarafındaki Yapılandırmalar
  2. OpenMediation Dashboard Tarafındaki Yapılandırmalar
  3. Kaynak Kod Tarafındaki Geliştirmeler

1. Huawei Ads Console Tarafındaki Yapılandırmalar

Huawei Ads platformunda tek yapmanız gereken, kullanmak istediğiniz reklam formatlarının reklam birimlerini oluşturmak ve reklam birimi kimliklerini (unit ID ) sonraki işlemlerde kullanmak üzere saklamak.

Huawei Ads Platformunda reklam birimi oluşturmak ile ilgili detaylı bilgiye bu bağlantıya tıklayarak erişebilirsiniz.

2. OpenMediation Dashboard Tarafındaki Yapılandırmalar

OpenMediation Dashboard’a erişmek için OpenMediation platformuna kaydolmanız gerekiyor. Bu bağlantıyı kullanarak bir hesap oluşturabilirsiniz.

Platforma kaydolduktan sonra, aşağıdaki adımları izleyeceğiz:

  • OpenMediation Konsolunda Uygulama Oluşturma
  • Reklamlar için Placement Ekleme ve Yönetme
  • Ad Placement için Ad Instance Yapılandırması
  • Mediation Kuralı Ayarlama

OpenMediation Konsolunda Uygulama Oluşturma

OpenMediation Dashboard’da oturum açın ve “Overview” arayüzüne gidin. Uygulama listesinin en üstündeki “Add App” butonuna tıklayın.

OpenMediation Dashboard Overview

Öncelikle, uygulamanızın platformunu seçin ve uygulamanızın desteklenen bir uygulama mağazasında listelenip listelenmediğini belirtin.

Uygulama Bilgileri

Uygulamanız herhangi bir mağazada listeleniyorsa, lütfen uygulamanızı seçilen mağazada bulun.

Uygulamanın Mağaza Linkini Ekleme

OpenMediation Platformunda uygulama ekleme işlemi hakkında detaylı bilgi için Uygulama Ekleme Dökümanı’nı inceleyebilirsiniz.

Reklamlar için Placement Ekleme ve Yönetme

Reklamlar için ekleyeceğiniz Placement platforma eklenen uygulamayla eşleşmesi gerekir, bu yüzden önce Overview sayfasından uygulama listesinde ilgili uygulamayı seçmeniz gerekiyor. Uygulamanın içine girdikten sonra, Monetize kısmına gidin ve Setup sekmesine tıklayın. Gezinme çubuğunda “Placements” kısmına gidin ve yeni bir Placement eklemek için “Add Placement” butonuna tıklayın.

Placements Sekmesi

“Name” sütununda Placement adını ekledikten sonra, istediğiniz reklam türünü seçin ve sayfanın sağ üst kısmındaki “Save” butonuna tıklayın.

Reklamlar için Placement Ekleme

Operations bölümünde, her bir Placement’ın durumunu kontrol edebilir, etkinleştirip, devre dışı bırakabilirsiniz.

Placement Etkinleştir/Devre Dışı Bırak

Not

OpenMediation platformunda yalnızca bir Rewarded ve bir Interstitial reklamı Placement’ı oluşturulmasına izin verilir. Çoklu reklam sahnesi gereksinimleri, OpenMediation SDK üzerinden mantık ve sahne işlevleri otomatik olarak çağrılarak gerçekleştirilebilir. Böylece, Rewarded ve Interstitial Reklamları için Placement ekleme adımlarını gerçekleştirdikten sonra, bunlar için de Placement Sahneleri (Scenes) ekleyebilirsiniz.

Rewarded ve Interstial Scene Ekleme Seçeneği

Detaylı bilgi için OpenMediation Help Center’daki Ad Placement ve Scenes dökümanlarını inceleyebilirsiniz.

Ad Placement için Ad Instance Yapılandırması

Monetize sayfasına erişmek için, sayfanın solundaki gezinti çubuğundan Setup>Mediation bölümüne gidin.

Mediation Sekmesi

Yapılandırmak istediğiniz Placement’ı sol üstten seçin ve instance bilgilerini yapılandırmak için “Instances” alt arayüzündeki “+Add Instance” butonuna tıklayın.

Ad Instance Ekleme

Reklam ağı seçim menüsüne erişmek için Ad Network alanına tıkladıktan sonra açılan menüde HUAWEI seçeneğine tıklayın.

Ad Network Seçme

Daha sonra, Instance’ları yapılandırmaya başlamak için +Add Instance butonuna tıklaryın.

Ad Instance Oluşturma (Adım 1)

Açılan pencerede Instance’a ait temel bilgileri giriniz.

Ad Instance Oluşturma (Adım 2)

Not

Yukarıdaki penceredeki gireceğimiz “Unit ID” değeri, Huawei Ads Konsolunda oluşturduğumuz reklam birimlerinin ID’si ile aynı olmalıdır.

eCPM değerini manuel olarak yapılandırabilirsiniz.

Ad Instance Oluşturma (Adım 3)

Lütfen oluşturduğunuz Instance’ları etkinleştirmeyi unutmayın.

Ad Instance Etkinleştir/Devre Dışı Bırak

Daha fazla bilgi için OpenMediation Help Center’daki Ad Instance dökümanını inceleyebilirsiniz.

Mediation Kuralı Ayarlama

Setup>Mediation sekmesinde, yapılandırılması gereken Placement’ı seçin ve Mediation kuralını yapılandırmak için Mediation Rule alt arayüzünde +Add Mediation Rule butonuna tıklayın.

Mediation Kuralı Ekleme

Temel bilgileri giriniz.

Mediation Kuralı Temel Bilgiler

Advanced Options buttonuna tıklayın.

Mediation Kuralına Gelişmiş Seçenekler Ekleme

Gelişmiş Seçenekler için temel bilgileri giriniz.

Gelişmiş Seçenekler İçin Temel Bilgiler

Son olarak, oluşturduğunuz Mediation kuralının etkinleştirilmiş olduğundan emin olun.

Mediation Kuralı Etkinleştir/Devre Dışı Bırak

Detaylı bilgi için OpenMediation Help Center’daki Mediation Rule Settings dökümanını inceleyiniz.

3. Kaynak Kod Tarafındaki Geliştirmeler

Huawei Ads ve OpenMediation için konsol işlemlerini gerçekleştirdikten sonra projemize bazı bağımlılıkları eklememiz gerekiyor. Öncelikle, lütfen aşağıdaki maven URL’lerini proje düzeyindeki build.gradle dosyanıza ekleyin.

Ardından, uygulama düzeyindeki build.gradle dosyanızın “dependencies” bölümüne aşağıdaki bağımlılıkları ekleyin.

Uygulamanızda Proguard kullanıyorsanız aşağıdakileri Proguard yapılandırma dosyanıza (Android Studio: proguard-rules.pro veya Eclipse: proguard-project.txt) eklemelisiniz. Bunu yapmamak hatalara yol açacaktır.

Not

Bu bölümden sonra bahsedilen aşamalar, projelerinde OpenMediation entegrasyonu bulunmayan uygulama geliştiriciler için hazırlanmıştır. Openmediation Android SDK Geliştirme Adımlarını daha önce tamamladıysanız, bu bölümün geri kalanını atlayabilirsiniz.

OpenMediation SDK Başlatma

OpenMediation platformundan reklam talep edebilmek için, uygulamanız başladığında ilk olarak OpenMediation SDK’sını başlatmanız gerekir. Bunu yapmak için, OpenMediation SDK’nın init() yöntemini bir uygulama parçasının ilk oluşturulduğu bölümde veya Activity’nin onCreate() içinde aşağıdaki gibi çağırmanızı öneririz:

Note : APP KEY değerine OpenMediation platformu içinde oluşturduğunuz uygulamanın bilgilerinin olduğu bölümden ulaşabilirsiniz.

Yukarıda belirtilen tüm işlemleri gerçekleştirdikten sonra uygulamanız için reklam birimlerini geliştirmeye başlayabilirsiniz.

  • Banner Ad

Native Android uygulamalarında Banner reklamları kullanmak için lütfen OpenMediation Mediation SDK’sını kontrol edin. OpenMediation SDK’sını kullanarak Banner Reklam geliştirme hakkında daha fazla bilgi almak için buraya tıklayın.

  • Interstitial Ad

Native Android uygulamalarında Interstitial reklamları kullanmak için lütfen OpenMediation Mediation SDK’sını kontrol edin. OpenMediation SDK’sını kullanarak Interstitial Reklam geliştirme hakkında daha fazla bilgi almak için buraya tıklayın.

  • Rewarded Video Ad

Native Android uygulamalarında Rewarded Video reklamları kullanmak için lütfen OpenMediation Mediation SDK’sını kontrol edin. OpenMediation SDK’sını kullanarak Rewarded Video Reklam geliştirme hakkında daha fazla bilgi almak için buraya tıklayın.

  • Native Ads

Native Android uygulamalarında Native reklamları kullanmak için lütfen OpenMediation Mediation SDK’sını kontrol edin. OpenMediation SDK’sını kullanarak Native Reklam geliştirme hakkında daha fazla bilgi almak için buraya tıklayın.

Sonuç

  • Huawei Ads ve OpenMediation Platformlarını kullanarak Reklam Uyumlulaştırması (Ad Mediation) yapabilabilir.
  • OpenMediation SDK’nın Huawei Ads Adapterının entegrasyon süreci, hem Huawei Ads tarafında hem de OpenMediation tarafında birkaç konsol işlemi ve ilgili projenin kaynak kodu üzerinde bazı geliştirme adımlarından oluşmaktadır.
  • Huawei Ads Adapter kaynak koduna bu linkten ulaşabilirsiniz.

--

--