Versions Compared

Old Version 28

changes.mady.by.user Emrecan Yardımcı

Saved on

compared with

New Version Current

changes.mady.by.user Umut Can Alparslan

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

12 farklı In-App Message tasarımı mevcut:

Pop-up - Görsel, Başlık, Yazı & Buton

Mini - İkon & Yazı

Tam Ekran Görsel

Image ModifiedImage Modified

Image Modified

Tam Ekran Görsel ve Buton

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

Pop-up Anket

Image Modified

Image Modified

Image Modified

Pop-up - Yazı ve Butonlu NPS

Native Alert & Action Sheet

1-10 Puanlama NPS

Image Modified

Image Modified

Image Modified

Yıldızlı Anket & İkinci Popup

Yarım Ekran Görsel

Carousel

Image Modified

Image Modified

Image Modified

Video In-App

Image Modified

Eğer inappler için eklediğiniz linkleri kendiniz yönetmek isterseniz aşağıdaki adımı uygulayabilirsiniz.

...

Code Block
<key>UIAppFonts</key>
	<array>
		<string>FONT_NAME</string>
	</array>

1-10 Puanlama NPS - Inline

1-10 Puanlama NPS - Inline özelliğini kullanmak için, [String: String] özelliğinde npsItemClicked yöntemini içeren bir delegate parametresi ve isteğe bağlı bir VisilabsNpsWithNumbersContainerView nesnesi alan completionHandler
getNpsWithNumbersView yöntemini çağırabilirsiniz.

delegate parametresi, buton tıklamalarını işlemek için kullanılır ve kullanıcı butona tıkladığında tetiklenen npsItemClicked adlı bir yöntem içerir.

completionHandler ise yalnızca belirli ölçütlerle eşleşen bir eylem varsa döndürülen isteğe bağlı olarak VisilabsNpsWithNumbersContainerView nesnesini içerir. Eşleşen bir eylem yoksa, completionHandler sıfır döner.

Code Block
Visilabs.callAPI().getNpsWithNumbersView(properties: props, delegate: self){ npsView in
    DispatchQueue.main.async {
        if let npsView = npsView {
            self.npsView = npsView
            self.npsView = npsView
            self.view.addSubview(npsView)
            npsView.translatesAutoresizingMaskIntoConstraints = false
            npsView.topAnchor.constraint(equalTo: self.npsWithNumbersButton.bottomAnchor, constant: -50).isActive = true
            npsView.widthAnchor.constraint(equalTo: self.view.saferAreaLayoutGuide.widthAnchor).isActive = true
            npsView.heightAnchor.constraint(equalToConstant: 550).isActive = true
        } else {
            print("There is no nps action matching your criteria.")
        }
    }
}
Code Block
extension NpsViewController: VisilabsNpsWithNumbersDelegate {
    func npsItemClicked(npsLink: String?) {
        print(npsLink)
    }
}

Favori Özellikler Aksiyonu

...

Code Block
languageswift
public enum VisilabsFavoriteAttribute: String {
    case ageGroup
    case attr1
    case attr2
    case attr3
    case attr4
    case attr5
    case attr6
    case attr7
    case attr8
    case attr9
    case attr10
    case brand
    case category
    case color
    case gender
    case material
    case title
}

Story Manager

Story Banner ve Story Aksiyonu

Hikaye Aksiyonu, uygulamanız içerisinde iOS cihazlarda görüntülenebilecek “Story” widgetları eklemenize olanak sağlar. getStoryView metodu, UIView altsınıfı olan VisilabsStoryHomeView örneğini döndürür.

Code Block
languageswift
let storyView = Visilabs.callAPI().getStoryView()
view.addSubview(storyView)

Ayrıca Target Aksiyonu ID’sine göre de istediğiniz bir Hikaye Aksiyonunu çağırabilirsiniz.

Code Block
languageswift
let storyView = Visilabs.callAPI().getStoryView(actionId:
67)
view.addSubview(storyView)

Tıklanabilir bir URL eklerseniz, bunu tarayıcıda açmak için framework veya direkt deeplink ile yönetebilirsiniz. Ancak kendi tarafınızda yönetebilmek için VisilabsStoryURLDelegate'e uyan classlara aşağıdaki kodu eklemeniz gereklidir.

Code Block
extension StoryViewController: VisilabsStoryURLDelegate {
    func urlClicked(_ url: URL) {
        //TO DO
    }
}

Bu eklenti sonrasında urlDelegate self ayarlaması yapın.

Code Block
let storyView = Visilabs.callAPI().getStoryView(actionId: 67, urlDelegate: self)
view.addSubview(storyHomeView)

...

Mail Üyelik Formu
RMC panelden in-app message’da olduğu gibi mail üyelik formunu oluşturduktan sonra her customEvent çağırdığınız zaman mail üyelik formu olup olmadığı kontrol edilir ardından mail üyelik formu gösterilir.
...
RMC panelden in-app message’da olduğu gibi çarkıfelek oluşturduktan sonra her customEvent çağırdığınız zaman çarkıfelek olup olmadığı kontrol edilir ardından çarkıfelek gösterilir.
Çarkıfelek Yarım Görünüm
Çarkıfelek Tam Görünüm
Image Modified
Image Modified
Kazı Kazan
RMC panelden in-app message’da olduğu gibi kazı kazan oluşturduktan sonra her customEvent çağırdığınız zaman kazı kazan olup olmadığı kontrol edilir ardından kazı kazan gösterilir.
...
...
RMC Panelde tanımladığınız Ürün Durum Bilgisi aksiyonu Ürün Görüntüleme, Sepete Ekleme ve Favoriye Ekleme/Çıkarma eventlerinde çalışmaktadır. Bu eventlerde ürün idnin gönderildiğinden emin olmalısınız.
...
Geofencing
Uygulamanızda konum hizmetlerini etkinleştirmek için öncelikle aşağıdaki anahtarları Info.plist dosyanıza eklemeniz gerekir.
  • NSLocationAlwaysAndWhenInUseUsageDescription
  • NSLocationWhenInUseUsageDescription
...
App Banner
App Banner aksiyonunu kullanmak için öncelikle uygulamanızda istediğiniz bir alanda UIView oluşturup eklemeniz gerekmektedir. Ardından getBannerView metodunu çağırarak bannerları bu UIView içerisinde gösterebilirsiniz. Aşağıda örnek olarak bir UIView oluşturma ve bu UIView içerisinde bannerları göstermeyi bulabilirsiniz.
 Code Block
languageswift
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>We need access to your location for better user experience.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>We need access to your location for better user experience.</string>
Ayrıca bölgeleri izlemek, bölge listesini yenilemek ve push bildirimlerini almak için Info.plist dosyanızda UIBackgroundModes altına aşağıdaki anahtarları eklemeniz gerekir.
 Code Block
languageswift
<array>let bannerView = UIView()
        bannerView.translatesAutoresizingMaskIntoConstraints = false
        self.view.addSubview(bannerView)
       <string>fetch</string>
    <string>location</string> NSLayoutConstraint.activate([bannerView.topAnchor.constraint(equalTo: self.view.topAnchor,constant:  80),
     <string>remote-notification</string> </array>
Visilabs SDK'yı başlatırken createAPI yönteminin geofenceEnabled parametresini true olarak ayarlamanız gerekir. Ayrıca maxGeofenceCount değerini 20'den daha düşük bir değerle değiştirebilirsiniz. Apple, herhangi bir uygulamanın aynı anda 20'den fazla bölgeyi izlemesini engeller. Visilabs tüm bu yuvaları kullanabilir.
 Code Block
languageswift
import VisilabsIOS  func application(_ application: UIApplication, didFinishLaunchingWithOptions          launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {         VisilabsbannerView.heightAnchor.createAPIconstraint(organizationIdequalToConstant: "YOUR_ORGANIZATION_ID", profileId: "YOUR_PROFILE_ID"80),
                     , dataSource: "YOUR_DATASOURCE", inAppNotificationsEnabled: false, channel: "IOS"         , requestTimeoutInSeconds: 30, geofenceEnabled: true, maxGeofenceCount: 20) bannerView.leadingAnchor.constraint(equalTo: self.view.leadingAnchor),
            return true     }                   bannerView.trailingAnchor.constraint(equalTo: self.view.trailingAnchor)])
        bannerView.backgroundColor = .black
        

Recommendation
Ürün önerileri, SDK’nın recommend metoduyla elde edilir. Ürün önerilerini almak için zoneId, productCode ve complete olan 3 zorunlu argümanı iletmelisiniz.
completion parametresi, bir VisilabsRecommendationResponse örneğini girdi olarak alan ve hiçbir şey döndürmeyen bir kapatma ifadesidir. VisilabsRecommendationResponse'un yapısı aşağıda gösterilmiştir:
 Code Block
languageswift
public class VisilabsRecommendationResponse {     public
var products: [VisilabsProduct]     public var error: VisilabsError? props = [String:String]()
     public var widgetTitle: String props["OM.inapptype"] = "banner_carousel"
        
internal  init(products: [VisilabsProduct], widgetTitle: String = "", error: VisilabsError? = nil Visilabs.getBannerView(properties: props) { banner in
      self.products = products    if let banner = banner self.widgetTitle{
= widgetTitle         self.error = error    banner.delegate }= }

VisilabsProduct sınıfı aşağıdaki özelliklere bakar:
...
Property
...
Type
...
code
...
String
...
title
...
String
...
img
...
String
...
dest_url
...
String
...
brand
...
String
...
price
...
Double
...
dprice
...
Double
...
cur
...
String
...
dcur
...
String
...
freeshipping
...
Bool
...
samedayshipping
...
Bool
...
rating
...
Int
...
comment
...
Int
...
discount
...
Double
...
attr1
...
String
...
attr2
...
String
...
attr3
...
String
...
attr4
...
String
...
attr5
...
String
Completion yönteminde verilen argümanlar için önerilen ürünler mevcutsa, ürün dizisini işlemeniz gerekir.
 Code Block
languageswift
Visilabs.callAPI().recommend(zoneID: "6", productCode: "pc", filters: []){ response inself
            if let error = responsebanner.errortranslatesAutoresizingMaskIntoConstraints = {false
        print(error)     }else{   bannerView.addSubview(banner)
     print("Recommended Products")         for product
in response.products{             print("product code: \(product.code) title: \(product.title)")NSLayoutConstraint.activate([banner.topAnchor.constraint(equalTo: bannerView.topAnchor),
                }     } } 
Recommend metodu için bir dizi filtre de iletebilirsiniz. Örneğin, aşağıdaki uygulama yalnızca başlıkta laptop içeren ürünleri döndürür.
 Code Block
languageswift
var filters = [VisilabsRecommendationFilter]() let filter = VisilabsRecommendationFilter(attribute: .PRODUCTNAME, filterType: .like, value: "laptop") filters.append(filter) var properties = [String: String]() properties["key"] = "value" Visilabsbanner.callAPI()bottomAnchor.recommendconstraint(zoneIDequalTo: "6", productCode: "pc", filters: filters, properties: properties){ response inbannerView.bottomAnchor),
                  if let error = response.error{         print(error)     }else{         print("Widget Title: \(response.widgetTitle)")banner.leadingAnchor.constraint(equalTo: bannerView.leadingAnchor),
                 print("Recommended Products")         for product in response.products{             print("product code: \(product.code) title: \(product.title)" banner.trailingAnchor.constraint(equalTo: bannerView.trailingAnchor)])
            }

       } }

Recommendation Click Raporları
Widgetta bulunan ürünlere tıklama sonrası panelde raporları görüntüleyebilmek için aşağıdaki kodu recommend metodu içerisinde çağırmanız gerekmektedir.
 Code Block
languageswift
Visilabs.callAPI().trackRecommendationClick(qs: product.qs)
Dilerseniz properties parametresi ile ekstra query parametreleri gönderebilirsiniz. Eğer kullanmak istemezseniz properties parametresini properties: [String:String] olarak değiştirebilirsiniz.
Kullanıcılarınız bannera click işlemini gerçekleştirdiğinde deeplinklerin sizin tarafınızdan handle edilip yönlendirme yapılması gerekmektedir. Bunun için ilgili class’a BannerDelegate’i eklemelisiniz.
 Code Block
class ViewController: UIViewController, BannerDelegate
Ardından aşağıdaki fonksiyonu ekleyerek kendinize göre düzenleyebilirsiniz.
 Code Block
func bannerItemClickListener(url: String) {
        print(url)
}
Ürün Durum Bilgisi
RMC Panelde tanımladığınız Ürün Durum Bilgisi aksiyonu Ürün Görüntüleme, Sepete Ekleme ve Favoriye Ekleme/Çıkarma eventlerinde çalışmaktadır. Bu eventlerde ürün idnin gönderildiğinden emin olmalısınız.
...