Huawei App Messaging

Herkese merhaba. Bu yazıda Huawei’nin geliştiricilere sunduğu App Messaging servisten bahesedeceğim ve projenize nasıl ekleyip, kullanıcılara mesaj gönderebileceğinizi anlatacağım.

App Messaging Nedir?

App Messaging uygulamanın aktif kullanıcılarını hedefleyen iletiler, bilgilendirmeler göndermek için kullanılır. Konsol üzerinden belirli bir uygulamaya belirlenen formatta mesajlar gönderilmesini sağlar.

Eğer bireysel bir geliştiriciyseniz, Ads Kit şu anda sizzler için uygun bir kullanım sunmayacaktır. Bunun yerine eğer reklam anlaşmanız varsa, App Message ile reklamlarınızı yayınlayabilirsiniz.

Örneğin “X” şirketi uygulamanıza reklam vermek istiyor. App Message sayesinde bu reklamların hangi günlerde, günde kaç kere, kullanıcının hangi eylemine bağlı olarak gösterileceğini ve hangi ülkelerde gösterileceğini seçerek, uygulamanızdaki en uygun yerlerde bu mesajların gösterilmesini sağlayabilirsiniz.

Ya da kullanıcılarınıza uygulamanızdaki yenilikler hakkında bilgi vermek, abonelik sisteminizi tanıtmak gibi çeşitli sebeplerle App Messaging kullanılabilir. Herhangi bir kullanım kısıtı yoktur, tamamen hayal gücünüz ile sistemi istediğiniz şekilde kullanabilirsiniz.

En basit tanımıyla App Messaging, Push Kit ve Ads Kit karması olarak nitelendirilebilir.

Üç farklı mesaj türü vardır. Bunlar Pop-up mesaj, banner mesajlar ve resimli mesajlardır. Pop-up mesajlara butonlar eklenip, butonlara yönlendirme eklenebilir. Pop-up mesajların resimleri ve text alanları daha büyüktür. Banner mesajlar küçük bir resim, başlık ve içerikten oluşmaktadır. Resimli mesajlar ise yalnızca resimden oluşur.

App Messaging aynı zamanda HMS Analytics Kit ile birlikte de kullanılabilir. Daha önce kullanıcı analizleri için eklediğiniz eventler gerçekleştiğinde (login, logout, register, click events vs.) kullanıcılara mesajlar gösterilebilmektedir. Böylece doğru yerde doğru mesajların gösterilmesi sağlanmaktadır.

Geliştirme Adımları

1. Servisi Aktif Etme

• Servis aktif etmek için, AppGallery Connect’e giriş yapıp “My Apps” başlığından uygulamanızı seçin.
• Sol üstteki “Develop” sekmesinden -> “Growing” -> “App Messaging” yoluyla yönetim paneline erişilir.
• Sağ üst köşede bulunan “Enable Now” butonuna tıklayarak servisi kullanıma hazır hale getirebilirsiniz.

2. Bağımlılıkların ve İzinlerin Eklenmesi

• Servisi aktif ettikten sonra App Messaging kütüphanesi app dizini altındaki build.gradle dosyasına eklenmeli.

dependencies {
    implementation 'com.huawei.agconnect:agconnect-appmessaging:1.3.1.300‘
}

• Manifest dosyasına gerekli izinler eklenir.

android.permission.INTERNET
android.permission.ACCESS_NETWORK_STATE

3. AAID Oluşturma

• AAID, cihazdaki herhangi bir uygulamayı tanımlamak için kullanılan benzersiz bir ID değeridir.
• Uygulama kaldırılıp yeniden yüklenirse, API ile değer silinirse, uygulama verileri silinirse ve cihaz resetlenirse AAID değeri silinir ve yeni bir değer oluşturulur.
• Mesaj göndeririken kullanmak için AAID değeri gereklidir. Bunun için gerekli kodları yazıyourz.
• Son olarak Analytics Kit için gerekli kodları ekleyip sonraki adıma geçilebilir.

4. Mesaj Alma İşlemleri

• Gönderilen mesajın cihaza alınması için Messaging servisin bazı metodları kullanılmalı.
• İlk olarak AGConnectAppMessaging nesnesinden bir örnek oluşturulur.
• Daha sonra veri çekmek için izin verilmeli. appMessaging.setFetchMessageEnable(true);
• Ardından mesaj ekranı aktifleştirilir. -> appMessaging.setDisplayEnable(true);
• Son olarak verilerin zorla çekilmesini sağlamalıyız. -> appMessaging.setForceFetch();
• Bir önceki adımda ve bu adımda yaptığımız işlemler sonucunda elde edilen kod aşağıdaki gibi olmalıdır.

5. Mesaj Gönderme İşlemleri

• Proje için yazılacak kodlar bu kadar az.
• Şimdi konsol üzerinden bir mesaj oluşturulup test etmek için gönderilmeli.
• Bunun için AppGallery Connect’e giriş yapıp “My Apps” başlığından uygulamanızı seçin. Sol üstteki “Develop” sekmesinden -> “Growing” -> “App Messaging” yoluyla yönetim paneline erişilir.
• Bu sayfada hem daha önce oluşturulan mesajlar listelenir, hem de yeni mesaj oluşturmak için “New” button yer alır.
• Mesajı oluşturmak için sol üst köşedeki “New” buttonuna tıklayın.

• Açılan sayfada ilk önce mesaj için yalnızca bizim görebileceğimiz isim ve açıklama bilgileri isteniyor.
• Daha sonra mesaj türü ( pop-up, banner, image) seçilmeli.
• Mesaj türü seçildikten sonra başlık, içerik, metin renkleri ve arkaplan rengi seçilmeli.
• Yani, bu adımda özel bir çerçeve tasrlanıyor.

• Daha sonra mesajda gözükmesi bir görsel belirlememiz gerekiyor.
• Bu adımda görseller direk konsola yüklenemiyor maalesef. Yalnızca link olarak verilebilir.
• İki tane resim seçilmesi gerekiyor. İlki cihaz dikey durumdayken çıkacak resim, ikincisi ise yatay durumdayken.
• Bunun için bir ölçü standartı var. ilk görsel için 3:2 oranında, ikinci görsel için ise 1:1 oranında ya da 3:2 oranında görseller seçilmeli.
• Son olarak bir button hazırlanıyor.
• Buttona text yazıp, rengini seçebiliriz.
• Aynı zamanda buttona atanması iki farklı aksiyon var. ilki buttona tıkayınca mesajın kapanmasını sağlıyor, ikinci ise belirlenen linke yönlendirme yapıyor.
• Son olarak “Next”e tıklayıp, bir sonraki aşamaya geçiyoruz.

• Bu sayfada mesajın gönderileceği hedefi belirlememiz gerekiyor.
• Zorunlu olarak yalnızca bir app seçilmeli. Diğer seçenekler hedef kitleye göre opsiyonel olarak belirlenebilir.
• “Next” diyerek sonraki adıma ilerliyoruz.

• Sıradaki işlem mesajın ne zaman gönderileceğini, hangi eyleme bağlı olarak gönderileceğini ve hangi sıklıkla gönderileceğini belirlemek.
• Default olarak AppOnForeground ve AppLaunch seçenekleri tercih olarak sunuluyor. Eğer Analytics Kit kullandıysanız, buradaki eventler de aşağıdaki gibi listelenir. Mesajın hangi evente bağlı olarak gösterileceğini buradan seçebilirsiniz.
• Mesajın ne zaman yayına başlayacağını ve yayının ne zaman sona ereceğini yine bu sayfadan belirleyebilirsiniz.
• Aynı sayfada mesajın bir kullanıcıya hangi sıklıkla, kaç kere gösterileceğini seçebilirsiniz. Belirttiğiniz başlangıç ve bitiş zamanları arasında mesaj kullanıcılara günde bir kere, 3 günde bir (bu sayıyı değiştirebilirsiniz) ya da günde 10 kere(bu sayıyı değiştirebilirsiniz) gösterilir.

• Son olarak dönüşüm olayları ayarlanmalı. Burada default olarak none seçili oluyor ve değiştiirilmiyor.

• Tüm bilgileri girdikten sonra artık mesaj hazır. Fakat “Publish” demeden önce ilk olarak “Save” dememiz gerekiyor, çünkü henüz test kullanıcısı eklenmedi.
• Ayrıca mesajın nasıl görüneceğini görmek için “preview” button ile önizleme yapılabilir.

• Tekrar konsolun ana sayfasına döndüğümüzde oluşturuğumuz mesaj listenin en üstüne eklenmiş olacak.
• Mesajın en sağ tarafındaki üç noktaya tıklayarak “Test” buttonunu seçelim ve test kullanıcısı eklemek için gerekli işlemlerin yapılacağı sayfaya gidelim.

• Test User AAID kısmına, android kodlarımızın içine yazdığımız AAID değeri alma metodundan dönen AAID değerini yazıp “Save” diyerek kendimizi test user olarak kaydedebiliriz.

• Son olarak yine konsolun ana sayfasında oluşturduğumuz mesajın en sağındaki üç noktaya tıklayarak “Publish” seçeneğini seçip, mesajı gönderebiliriz.

Dip Not

Gönderdiğiniz mesajlar anında cihazınıza gelmeyebilir. Mesaj her cihaza belirtilen zaman dilimleri arasında farkı zamanlarda gönderilmektedir. Bir süre bekledikten sonra mesajın gösterilme eventini gerçekleştirdiğinizde mesajlar gözükecektir.

Referanslar

AppMessaging

AAID