...
...
...
...
Table of Contents | ||||
---|---|---|---|---|
|
Related Digital, iOS uygulamalarından veri toplamak için eventleri kullanmaktadır. Veri gönderirken customEvent metodu 2 parametre almaktadır. Bunlar;
...
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) 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.
Eventler
Kaydolma
Bu eventi sadece kullanıcı uygulamanıza kayıt olduğunda göndermelisiniz.
...
Code Block | ||
---|---|---|
| ||
var properties = [String:String]() properties["OM.sys.TokenID"] = "F7C5231053E6EC543B8930FB440752E2FE41B2CFC2AA8F4E9C4843D347E6A847" properties["OM.sys.AppID"] = "RelatedDigitalIOS" //Buraya kendi App Alias değerinizi gireceksiniz RelatedDigital.signUp(exVisitorId: "KEY_ID veya E-Mail", properties: properties) |
Oturum Açma
Bu eventi sadece kullanıcı uygulamanızda oturum açtığında göndermelisiniz.
...
Code Block | ||
---|---|---|
| ||
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
RelatedDigital.login(exVisitorId: "KEY_ID veya E-Mail", properties: properties) |
Çıkış Yapma
Kullanıcı “Çıkış Yap” butonuna bastığında aşağıdaki kodu tetikleyerek tüm gezintiyi anonim yapabilirsiniz. Logout fonksiyonu ile her evente otomatik eklenen OM.exVisitorID bilgisi temizlenip yeni bir CookieID atanacaktır.
Code Block | ||
---|---|---|
| ||
RelatedDigital.logout() |
Sayfa Görüntüleme
Bu eventi herhangi bir event (Ürün Görüntüleme, Kategori, Sepet vb.) göndermediğiniz sayfalarda (Anasayfa, Hesabım vb.) göndermelisiniz. Propertiese fazladan parametreler ekleyebilir veya boş bırakabilirsiniz.
Code Block | ||
---|---|---|
| ||
RelatedDigital.customEvent("SAYFA_ISMI", properties: [String: String]()) |
Ürün Görüntüleme
Code Block | ||
---|---|---|
| ||
properties["OM.pv"] = "12345" //Kullanıcının görüntülediği ürünün kodu properties["OM.pn"] = "ABCDE" //Kullanıcının görüntülediği ürünün adı properties["OM.ppr"] = "123.45" //Kullanıcının görüntülediği ürünün fiyatı properties["OM.pv.1"] = "XYZ" //Kullanıcının görüntülediği ürünün markası properties["OM.inv"] = "10" //Kullanıcının görüntülediği ürünün kalan stok adeti RelatedDigital.customEvent("Product View", properties: properties) |
Sepet Eventleri
OM.pbid değeri unique bir değer olmalıdır. Her sepet eventinde değişmemelidir.
...
Bu eventi kullanıcı sepete ürün eklediğinde, sepetten bir ürün çıkardığında, sepetteki bir ürünü güncellediğinde ve sepet tamamen boşaltıldığında göndermelisiniz. Sepet tamamen boşaltıldığında OM.pbid hariç diğer tüm parametreler boş olacak şekilde göndermelisiniz.
Not: OM.basketType parametresinde value olarak kullanıcının sepet işlemi yaptığı sayfayı gönderin. Sepete ekleme işleminde ve sepet sayfasında aynı event gönderilmektedir. Bu sayfaları ayrıştırmak için OM.basketType parametresinde BasketPage, ProductDetail, CategoryPage vb. şekillerde sepet işleminin yapıldığı sayfayı gönderebilirsiniz.
Code Block | ||
---|---|---|
| ||
properties["OM.pbid"] = "ABCD-1234" //Sepet ID değeri
properties["OM.pb"] = "123;456" // Product1 Code;Product2 Code
properties["OM.pu"] = "2;4" // Product1 Quantity;Product2 Quantity
properties["OM.ppr"] = "10;40"
properties["OM.basketType"] = "BasketPage"
RelatedDigital.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.
...
Code Block | ||
---|---|---|
| ||
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 RelatedDigital.customEvent("Purchase", properties: properties) |
Kategori Görüntüleme
Kullanıcı bir kategori sayfasını görüntülediğinde, aşağıdaki customEvent uygulamasını kullanın.
Code Block | ||
---|---|---|
| ||
properties["OM.clist"] = "123" // Kategori Kodu / IDsi RelatedDigital.customEvent("Category View", properties: properties) |
Arama
Mobil uygulamanın bir arama işlevi varsa, aşağıdaki customEvent uygulamasını kullanın.
Code Block | ||
---|---|---|
| ||
properties["OM.OSS"] = "Telefon" // Search Keyword properties["OM.OSSR"] = "12345" // Number of Search Results RelatedDigital.customEvent("Search", properties: properties) |
Banner Tıklaması
Aşağıdaki customEvent uygulamasını kullanarak banner tıklama verilerini izleyebilirsiniz.
Code Block | ||
---|---|---|
| ||
properties["OM.OSB"] = "123" // Banner Name/Banner Code RelatedDigital.customEvent("Banner Click", properties: properties) |
Favoriye Ekleme
Kullanıcı favorilerine bir ürün eklediğinde, aşağıdaki customEvent uygulamasını kullanın.
Code Block | ||
---|---|---|
| ||
var properties = [String:String]() properties["OM.pf"] = "12345" // Product Code properties["OM.pfu"] = "1" properties["OM.pfr"] = 125.49" // Product Price RelatedDigital.customEvent("/om_evt.gif", properties: properties) |
Favoriden Çıkarma
Kullanıcı favorilerinden bir ürün çıkardığında, aşağıdaki customEvent uygulamasını kullanın.
Code Block | ||
---|---|---|
| ||
var properties = [String:String]() properties["OM.pf"] = "12345" // Product Code properties["OM.pfu"] = "-1" properties["OM.pfr"] = 125.49" // Product Price RelatedDigital.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.
Code Block | ||
---|---|---|
| ||
var properties = [String:String]() properties["utm_source"] = "Related-Digital" // 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"] = "related_digital_campaign" // utm_campaign value in the payload of push notification RelatedDigital.sendCampaignParameters(properties: properties) |
Lokasyon Durum Bilgisi Yollama
Kullanıcılarınızın lokasyon izin durumlarını aşağıdaki gibi sunucuya gönderebilir ve bu bilgiyi daha sonra panelde kullanabilirsiniz.
...
"none" : Lokasyon izni edinilmemiş durumda.
Push Mesaj Token Kaydetme
Code Block | ||
---|---|---|
| ||
var properties = [String:String]() properties["OM.sys.TokenID"] = "F7C5231053E6EC543B8930FB440752E2FE41B2CFC2AA8F4E9C4843D347E6A847" // Token ID to use for push messages properties["OM.sys.AppID"] = "RelatedDigitalIOS" //App ID to use for push messages RelatedDigital.customEvent("RegisterToken", properties: properties) |
...