Bu sayfada:
Vislabs, IOS uygulamalarından veri toplamak için eventleri kullanır. Geliştiricinin, SDK tarafından sağlanan yöntemleri uygulaması gerekir. customEvent, kullanıcı hareketlerini izlemek için genel bir yöntemdir. customEvent 2 parametre alır: pageName ve properties.
pageName : Uygulamanızın mevcut sayfası. Etkinliğiniz bir sayfa görünümüyle ilgili değilse, yapılan hareketle ilgili bir değer iletmelisiniz. Boş bir dize geçirirseniz, etkinlik geçersiz sayılır ve iptal edilir.
properties : Etkinlikle ilgili anahtar/değer çiftlerinden oluşan bir koleksiyon. Etkinliğiniz sayfa adı dışında ek veriye sahip değilse, boş bir göndermek kabul edilebilir.
SDK'da, customEvent dışında, veri toplamak için 2 yöntem daha vardır: oturum açma ve kaydolma. CustomEvent yönteminde olduğu gibi, oturum açma ve kaydolma yöntemleri de bir zorunlu ve isteğe bağlı bir parametre alır. İlk parametre, kullanıcıyı benzersiz olarak tanımlayan ve boş bırakılamayan exVisitorId'dir. İkinci parametre özellikleri isteğe bağlıdır.
Mobil kanaldan gelen datalarınızın RMC'ye yüklenebilmesi için, aktif RMC hesabınızda kullanmış olduğunuz referans değeriniz ne ise (KEY_ID* veya E-Mail vb.) mobil kanaldan gelen dataların da bu referans ile gelmesine dikkat ediniz."
*KEY_ID: Uygulama sahibi tarafından müşterisinin tekilleştirilmesi için kullanılan id değerleridir. Bunlar CRM id, userid, customerid, accountid gibi farklı isimlerle ifade ediliyor olabilir.
exVisitorId yapınıza göre keyID veya E-Posta olabilir.
En yaygın olaylardan bazıları:
Kaydolma
Visilabs.callAPI().signUp(exVisitorId: "userId")
Ayrıca, kullanıcı kaydolduğunda isteğe bağlı parametre özelliklerine ek bilgi aktarabilirsiniz. Aşağıdaki örnek, OM.sys.TokenID ve OM.sys.AppID parametrelerini içeren özelliklerle signUp yönteminin çağrılmasını gösterir. OM.sys.TokenID ve OM.sys.AppID push bildirimleri göndermek için gereklidir ve OM.sys.AppID parametresi RMC web panelinden alınabilir.
var properties = [String:String]() properties["OM.sys.TokenID"] = "F7C5231053E6EC543B8930FB440752E2FE41B2CFC2AA8F4E9C4843D347E6A847" // Token ID to use for push messages properties["OM.sys.AppID"] = "VisilabsIOSExample" //App ID to use for push messages Visilabs.callAPI().signUp(exVisitorId: "userId", properties: properties)
Oturum Açma
Visilabs.callAPI().login(exVisitorId: "userId")
Kaydolma yöntemi gibi oturum açma yöntemi de isteğe bağlı parametre özellikleriyle veya bunlar olmadan çağrılabilir.
var properties = [String:String]() properties["OM.sys.TokenID"] = "F7C5231053E6EC543B8930FB440752E2FE41B2CFC2AA8F4E9C4843D347E6A847" // Token ID to use for push messages properties["OM.sys.AppID"] = "VisilabsIOSExample" //App ID to use for push messages Visilabs.callAPI().login(exVisitorId: "userId", properties: properties)
Ayrıca, propertiese kullanıcı segmenti parametreleri ekleyebilirsiniz.
var properties = [String:String]() properties["OM.vseg1"] = "seg1val" // Visitor Segment 1 properties["OM.vseg2"] = "seg2val" // Visitor Segment 2 properties["OM.vseg3"] = "seg3val" // Visitor Segment 3 properties["OM.vseg4"] = "seg4val" // Visitor Segment 4 properties["OM.vseg5"] = "seg5val" // Visitor Segment 5 properties["OM.bd"] = "1995-09-02" // Birthday properties["OM.gn"] = "m" // Gender properties["OM.loc"] = "Artvin" // Location Visilabs.callAPI().login(exVisitorId: "userId", properties: properties)
Sayfa Görüntüleme
Ziyaretçinin o anda görüntülemekte olduğu sayfa adını kaydetmek için aşağıdaki customEvent yöntemi uygulamasını kullanın. Propertiese fazladan parametreler ekleyebilir veya boş bırakabilirsiniz.
Visilabs.callAPI().customEvent("Frequently Asked Questions", properties: [String:String]())
Ürün Görüntüleme
Kullanıcı mobil uygulamada bir ürün görüntülediğinde aşağıdaki customEvent uygulamasını kullanın.
var properties = [String:String]() properties["OM.pv"] = "12345" // Product Code properties["OM.pn"] = "USB Charger" // Product Name properties["OM.ppr"] = 125.49" // Product Price properties["OM.pv.1"] = "Sample Brand" // Product Brand properties["OM.inv"] = "5" // Number of items in stock Visilabs.callAPI().customEvent("Product View", properties: properties)
Sepete Ekleme
Kullanıcı sepete ürün eklediğinde veya ürün çıkardığında aşağıdaki customEvent uygulamasını kullanın. Sepette bulunan son üründe kullanıcı tarafından silindiğinde OM.pb, OM.pu ve OM.ppr parametrelerini boş string olarak göndermelisiniz.
var properties = [String:String]() properties["OM.pbid"] = "bid-12345678" // Basket ID properties["OM.pb"] = "12345;23456" // Product1 Code;Product2 Code properties["OM.pu"] = "3;1" // Product1 Quantity;Product2 Quantity properties["OM.ppr"] = "376.47;23.50" // Product1 Price*Product1 Quantity;Product2 Price*Product2 Quantity Visilabs.callAPI().customEvent("Cart", properties: properties)
Satın Alma
Kullanıcı bir veya daha fazla öğe satın aldığında aşağıdaki customEvent uygulamasını kullanın.
var properties = [String:String]() properties["OM.tid"] = "oid-12345678" // Order ID/Transaction ID properties["OM.pp"] = "12345;23456" // Product1 Code;Product2 Code properties["OM.pu"] = "3;1" // Product1 Quantity;Product2 Quantity properties["OM.ppr"] = "376.47;23.50" // Product1 Price*Product1 Quantity;Product2 Price*Product2 Quantity Visilabs.callAPI().customEvent("Purchase", properties: properties)
Kategori Görüntüleme
Kullanıcı bir kategori listesi sayfasını görüntülediğinde, aşağıdaki customEvent uygulamasını kullanın.
var properties = [String:String]() properties["OM.clist"] = "c-14" // Category Code/Category ID Visilabs.callAPI().customEvent("Category View", properties: properties)
Arama
Mobil uygulamanın bir arama işlevi varsa, aşağıdaki customEvent uygulamasını kullanın.
var properties = [String:String]() properties["OM.OSS"] = "USB" // Search Keyword properties["OM.OSSR"] = "61" // Number of Search Results Visilabs.callAPI().customEvent("In App Search", properties: properties)
Banner Tıklaması
Aşağıdaki customEvent uygulamasını kullanarak banner tıklama verilerini izleyebilirsiniz.
var properties = [String:String]() properties["OM.OSB"] = "b-666" // Banner Name/Banner Code Visilabs.callAPI().customEvent("Banner Click", properties: properties)
Favorilere Ekleme
Kullanıcı favorilerine bir ürün eklediğinde, aşağıdaki customEvent uygulamasını kullanın.
var properties = [String:String]() properties["OM.pf"] = "12345" // Product Code properties["OM.pfu"] = "1" properties["OM.ppr"] = 125.49" // Product Price Visilabs.callAPI().customEvent("/om_evt.gif", properties: properties)
Favorilerden Çıkarma
Kullanıcı favorilerinden bir ürün çıkardığında, aşağıdaki customEvent uygulamasını kullanın.
var properties = [String:String]() properties["OM.pf"] = "12345" // Product Code properties["OM.pfu"] = "-1" properties["OM.ppr"] = 125.49" // Product Price Visilabs.callAPI().customEvent("/om_evt.gif", properties: properties)
Kampanya Parametresi Yollama
Bir push mesajına tıklayarak uygulamayı başlattıktan sonra, aşağıdaki customEvent uygulamasını kullanın.
var properties = [String:String]() properties["utm_source"] = "euromsg" // utm_source value in the payload of push notification properties["utm_medium"] = "push" // utm_medium value in the payload of push notification properties["utm_campaign"] = "euromsg campaign" // utm_campaign value in the payload of push notification Visilabs.callAPI().sendCampaignParameters(properties: properties)
Push Mesajı Token Kaydetme
Visilabs'ın kullanıcılara push mesajları göndermek için token alması gerekiyor. APNS tarafından oluşturulan belirteç değeri, OM.sys.TokenID anahtarının değeri olacaktır. OM.sys.AppID'nin değeri RMC yönetim paneli tarafından elde edilebilir. Https://intelligence.relateddigital.com/a02/index#/Push/AppList bağlantısını takip edin ve ilgili push uygulamasını seçin. Uygulama App Alias değeri OM.sys.AppID'ye denk gelir. Sorun yaşarsanız lütfen RMC destek ekibiyle iletişime geçin.
var properties = [String:String]() properties["OM.sys.TokenID"] = "F7C5231053E6EC543B8930FB440752E2FE41B2CFC2AA8F4E9C4843D347E6A847" // Token ID to use for push messages properties["OM.sys.AppID"] = "VisilabsIOSExample" //App ID to use for push messages Visilabs.callAPI().customEvent("RegisterToken", properties: properties)