Veri Gönderimi

1 Eventler
- 1.1 Kaydolma
- 1.2 Oturum Açma
- 1.3 Çıkış Yapma
- 1.4 Sayfa Görüntüleme
- 1.5 Ürün Görüntüleme
- 1.6 Sepet Eventleri
- 1.7 Satın Alma
- 1.8 Kategori Görüntüleme
- 1.9 Arama
- 1.10 Banner Tıklaması
- 1.11 Favoriye Ekleme
- 1.12 Favoriden Çıkarma
- 1.13 Kampanya Parametresi Yollama
- 1.14 Lokasyon Durum Bilgisi Yollama
- 1.15 Push Mesaj Token Kaydetme

Related Digital, iOS uygulamalarından veri toplamak için eventleri kullanmaktadır. Veri gönderirken customEvent metodu 2 parametre almaktadır. Bunlar;

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) 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.

RelatedDigital.signUp(exVisitorId: "KEY_ID veya E-Mail")

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"
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.

RelatedDigital.login(exVisitorId: "KEY_ID veya E-Mail")

Çı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.

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.

Ürün Görüntüleme

Sepet Eventleri

OM.pbid değeri unique bir değer olmalıdır. Her sepet eventinde değişmemelidir.

Sepet eventinde her zaman sepetin son haline gönderilmelidir. Sepette bulunan tüm ürünler bu eventte gönderilmelidir.

Ürünleri noktalı virgül ile ayırmanız gerekmektedir.

Fiyatı gönderirken ürünün tek adet fiyatı * sepete eklenen adet olarak hesaplanmalı. Örneğin ürünün fiyatı 5 TL ve sepete 2 adet eklendiyse 10 olarak gönderilmeli.

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.

Satın Alma

Kullanıcı bir veya daha fazla öğe satın aldığında aşağıdaki customEvent uygulamasını kullanın.

Fiyatı gönderirken ürünün tek adet fiyatı * satın alınan adet olarak hesaplanmalı. Örneğin ürünün fiyatı 5 TL ve 2 adet satın alındıysa 10 olarak gönderilmeli.

Kategori Görüntüleme

Kullanıcı bir kategori sayfasını görüntülediğinde, aşağıdaki customEvent uygulamasını kullanın.

Arama

Mobil uygulamanın bir arama işlevi varsa, aşağıdaki customEvent uygulamasını kullanın.

Banner Tıklaması

Aşağıdaki customEvent uygulamasını kullanarak banner tıklama verilerini izleyebilirsiniz.

Favoriye Ekleme

Kullanıcı favorilerine bir ürün eklediğinde, aşağıdaki customEvent uygulamasını kullanın.

Favoriden Çıkarma

Kullanıcı favorilerinden bir ürün çıkardığında, aşağıdaki customEvent uygulamasını kullanın.

Kampanya Parametresi Yollama

Bir push mesajına tıklayarak uygulamayı başlattıktan sonra, aşağıdaki customEvent uygulamasını kullanın.

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.

Bu bilgi aşağıdaki 3 değerden birini alabilir:

"always" : Lokasyon izni uygulama açıkken ve kapalıyken edinilmiş durumda.

"appopen" : Lokasyon izni yalnızca uygulama açıkken edinilmiş durumda.

"none" : Lokasyon izni edinilmemiş durumda.