In-App Notification Modülü

1 Modülün Etkinleştirilmesi
2 Uygulama-İçi Mesajlar
3 Favori Özellik Aksiyonu
4 Story Manager
5 App Banner
6 Öneriler Aksiyonu
7 Mail Üyelik Formu
8 Çarkıfelek (Spin To Win)
9 Kazı Kazan (Scratch To Win)
10 Hediye Yağmuru (Gift Rain)
11 Ürün Durum Bilgisi
12 Kulakçık
13 Örnek Uygulama

Modülün Etkinleştirilmesi

Burada açıklandığı gibi etkinleştirilmelidir.

Uygulama-İçi Mesajlar

Kullanıcınıza uygulama-içi bir mesaj göstermek için öncelikle RMC panelinden bir target aksiyon tanımlamanız ve gerekli alanları doldurmanız gerekmektedir. Ardından aşağıdaki gibi bu target aksiyonu tetikleyebilir ve kullanıcınıza oluşturduğunuz formu uygulamanız aracılığıyla gösterebilirsiniz.

Kotlin

val parameters = HashMap<String, String>()
RelatedDigital.customEvent(
  context = context,
  pageName = "Uygulama-İçi Mesaj",
  properties = parameters,
  parent = activity
)

Java

HashMap<String, String> parameters = new HashMap<String, String>();
RelatedDigital.customEvent(
  context,
  "Uygulama-İçi Mesaj",
  parameters,
  activity
);

Uygulama-içi mesaj göstermek için yukarıdaki gibi customEvent metodunu çağırırken parent parametresi null olmamalıdır. parent parametresine bir Activity değeri verilmezse mesaj görünmeyecektir.

Eğer RMC panelde oluşturduğunuz forma bir kural tanımladıysanız bu kuralın da customEvent metodu içerisindeki properties parametresi aracılığıyla girilmesi gerekmektedir. Örnek:

parameters["OM.inapptype"] = "full_screen_image"

parameters.put("OM.inapptype", "full_screen_image");

Tıklanmanın Yakalanması

Kullanıcınıza gösterilen uygulama-içi mesaj ekranında kullanıcı, yönlendirmenin olduğu öğeye tıkladığında, alınacak aksiyonu kendiniz yönetmek isterseniz aşağıdaki gibi bir callback tanımlaması yapmanız ve bu callback i setInAppButtonInterface metoduna iletmeniz gerekmektedir.

Kotlin

val buttonCallback: InAppButtonInterface = object : InAppButtonInterface {
  override fun onPress(link: String?) {
    //Tıklama sonrası çalıştırılacak kodu buraya yazınız.
  }
}
RelatedDigital.setInAppButtonInterface(buttonCallback)

val parameters = HashMap<String, String>()
RelatedDigital.customEvent(
  context = context,
  pageName = "Uygulama-İçi Mesaj",
  properties = parameters,
  parent = activity
)

Java

Her tıklama sonrası, SDK girilen callback i çağırır ve tanımlanan callback i kaldırır. Bu yüzden callback kullanmak isteğiniz her aksiyondan önce yeni bir callback tanımlaması yapıp setInAppButtonInterface metodu aracılığıyla SDK ya iletmeniz gerekmektedir. Daha sonra customEvent metoduyla ilgili aksiyonu tetikleyebilirsiniz.

Özel Font Kullanımı

Uygulama-içi mesajlarda özel font kullanımı için ilk olarak projenizin res klasörü altında font dosyası oluşturunuz(yoksa).
Oluşturduğunuz klasörün içerisine istediğiniz fontları ekleyebilirsiniz.
Son olarak arayüzden uzantısız bir şekilde kullanmak istediğiniz fontun adını giriniz.

Uygulama-İçi Mesaj Tasarımları

Pop-up - Görsel, Başlık, Yazı & Buton	Mini - İkon & Yazı	Tam Ekran Görsel

Pop-up - Görsel, Başlık, Yazı & Buton	Mini - İkon & Yazı	Tam Ekran Görsel

Tam Ekran Görsel ve Buton	Pop-up - Görsel, Başlık, Yazı ve Buton	Pop-up Anket

Pop-up - Yazı ve Butonlu NPS	Native Alert & Action Sheet	1-10 Puanlama NPS

Yıldızlı anket & ikinci pop-up	Yarım Ekran Görsel	Carousel

Favori Özellik Aksiyonu

RMC panel üzerindeki target aksiyonlarından tanımladığınız favori değişkenlerinizi aşağıdaki gibi mobil uygulama üzerinden alıp kullanabilirsiniz.

Kotlin

Java

Story Manager

Uygulamanızın layout unda dilediğiniz bir alana StoryRecyclerView ı yerleştiriniz.

StoryItemClickListener tanımlayarak her bir story’e tıklandığında yapmak istediğiniz yönlendirme veya alınacak aksiyonu tanımlayınız.

Ardından StoryRecyclerView ın setStoryAction veya setStoryActionId methodunu çağırarak storyItemClickListenerobjesini methoda ekleyiniz.

Kotlin

Java

ID ile

Kotlin

Java

Eğer bir şeylerin ters gitmesi ve story aksiyonun gösterilememesi durumunda layout dosyanıza eklediğiniz StoryRecyclerView dan dolayı ekranda ilgili alanın boş kalmasına karşı önlem almak isterseniz story aksiyonunu aşağıdaki gibi setStoryActionWithRequestCallback veya setStoryActionIdWithRequestCallback metotlarını kullanarak tetikleyebilirsiniz.

Kotlin

Java

ID ile

Kotlin

Java

App Banner

Uygulamanızın istediğiniz bir layout dosyasında istediğiniz bir yere BannerRecyclerView ı yerleştiriniz. Örnek xml :

Daha sonra ilgili program dosyasında (Java veya Kotlin) BannerRecyclerView objesine erişip requestBannerCarouselAction() methodunun çağırılması gereklidir. Bu method bir zorunlu (context: Context), 3 opsiyonel parametre(properties: HashMap<String, String>?, bannerRequestListener: BannerRequestListener?, bannerItemClickListener: BannerItemClickListener?) almaktadır.

properties parametresi sorguya eklemek istediğiniz ekstra query parametreleri içindir.

bannerRequestListener parametresi eğer sorgu sonucunda bir şeyler ters gider ve sunuculardan bilgi alınamazsa bunun size bildirimlesi içindir. Böylece layoutunuza eklediğiniz BannerRecyclerView in visibility sini View.GONE veya View.INVISIBLE yaparak ilgili alanın boş görünmesini engelleyebilirsiniz.

bannerItemClickListener parametresi kullanıcının herhangi bir banner a tıklaması sonucu SDK’nın otomatik yönlendirmesi yerine kendiniz yönlendirme yapmak istiyorsanız kullanabileceğiniz bir parametredir.

Tüm parametreleri içeren örnek bir kullanım aşağıdaki gibidir.

Kotlin

Java

Öneriler Aksiyonu

Öneriler aksiyonunu uygulamanızda aşağıdaki gibi tetikleyebilirsiniz.

Kotlin

Java

Ayrıca, filtreleri ve ek parametreleri de getRecommendations metodu aracılığıyla kullanabilirsiniz.

Kotlin

Java

Öneriler özelliğinin tıklamalarının panele yansıması için, aşağıdaki metot, tıklanan ürünün "qs" değeri ile çağırılmalıdır.

Kotlin

Java

Mail Üyelik Formu

RMC panel üzerinden oluşturduğunuz mail üyelik formu aksiyonunu aşağıdaki gibi tetikleyebilirsiniz.

Kotlin

Java

Çarkıfelek (Spin To Win)

RMC panel üzerinden oluşturduğunuz çarkıfelek aksiyonunu aşağıdaki gibi tetikleyebilirsiniz.

Kotlin

Java

Çarkıfelek Yarım Görünüm	Çarkıfelek Tam Görünüm

Çarkıfelek Yarım Görünüm	Çarkıfelek Tam Görünüm

Aşağıdaki kodu kullanarak kazanılan çarkıfelek dilimindeki linki yakalayabilir ve kullanıcıyı istediğiniz sayfaya yönlendirebilirsiniz. Kodu istediğiniz bir activity içerisine eklemeniz yeterlidir.

NOT: Bu receiver sdkmızın ekli olduğu tüm uygulamalarda Çarkıfelek aksiyonunu dinler. Sorun yaşamamak adına lütfen gelen linkte önce kendi urlinizi doğrulayıp yönlendirme yapınç

Kazı Kazan (Scratch To Win)

RMC panel üzerinden oluşturduğunuz kazı-kazan aksiyonunu aşağıdaki gibi tetikleyebilirsiniz.

Kotlin

Java

Hediye Yağmuru (Gift Rain)

RMC panel üzerinden oluşturduğunuz kazı-kazan aksiyonunu aşağıdaki gibi tetikleyebilirsiniz.

Kotlin

Java

Ürün Durum Bilgisi

RMC panel üzerinden oluşturduğunuz ürüm durum bilgisi aksiyonunu aşağıdaki gibi tetikleyebilirsiniz.

Kotlin

Java

Kulakçık

RMC panel üzerinden oluşturduğunuz kulakçık aksiyonunu aşağıdaki gibi tetikleyebilirsiniz.

Kotlin

Java

Örnek Uygulama

RelatedDigital Demo Uygulaması