Android - Veri Gönderimi

Bu sayfada:

1 Üye Ol
2 Giriş Yap
3 Sayfa Görüntüleme
4 Ürün Görüntüleme
5 Sepet İşlemleri
6 Satın Alma
7 Kategori Görüntüleme
8 Arama
9 Banner Tıklama
10 Favori İşlemleri
11 Kampanya Parametresi Yollama(UTM)
12 Lokasyon Durum Bilgisini Yollama
13 Push Mesajı Token Kaydetme

Visilabs, Android 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 parameters.

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.
parameters : Etkinlikle ilgili anahtar/değer çiftlerinden oluşan bir koleksiyon. Etkinliğiniz sayfa adı dışında ek veriye sahip değilse, boş 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.

exVisitorId yapınıza göre keyID veya E-Posta olabilir.

Not: Eğer aşağıdaki varsayılan eventler haricinde bir custom event gönderecekseniz parametrenin OM. ile başladığından emin olunuz. Örnek kullanım OM.xyz

En yaygın olaylardan bazıları:

Üye Ol

Visilabs.CallAPI().signUp(exVisitorId: "userId/Email", getActivity())

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.

HashMap<String, String> parameters = new HashMap<>();
parameters.put("OM.sys.TokenID", token);
parameters.put("OM.sys.AppID", AppAlias); //RMC Panelden Alınacak
Visilabs.callAPI().signUp(exVisitorId: "userId/Email", parameters, getActivity())

Giriş Yap

Kaydolma yöntemi gibi oturum açma yöntemi de isteğe bağlı parametre özellikleriyle veya bunlar olmadan çağrılabilir.

Visilabs.callAPI().login(exVisitorId: "userId/Email")

HashMap<String, String> parameters = new HashMap<>();
parameters.put("OM.sys.TokenID", token);
parameters.put("OM.sys.AppID", AppAlias); //RMC Panelden Alınacak
Visilabs.callAPI().login(exVisitorId: "userId/Email", parameters, getActivity())

Ayrıca, parametersa kullanıcı segmenti parametreleri ekleyebilirsiniz.

HashMap<String, String> parameters = new HashMap<>();
parameters.put("OM.vseg1", "seg1val") // Visitor Segment 1
parameters.put("OM.vseg2", "seg2val") // Visitor Segment 2
parameters.put("OM.vseg3", "seg3val") // Visitor Segment 3
parameters.put("OM.vseg4", "seg4val") // Visitor Segment 4
parameters.put("OM.vseg5", "seg5val") // Visitor Segment 5
parameters.put("OM.bd", "1995-09-02") // Doğum Günü
parameters.put("OM.gn", "m") // Cinsiyet
parameters.put("OM.loc", "Artvin") // Lokasyon
Visilabs.callAPI().login(exVisitorId: "userId", parameters, getActivity())

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. Properties'e fazladan parametreler ekleyebilir veya boş bırakabilirsiniz.

HashMap<String, String> parameters = new HashMap<>();
Visilabs.callAPI().customEvent("Frequently Asked Questions", parameters, getActivity())

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

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.pv","Product Code");
parameters.put("OM.pn","Product Name");
parameters.put("OM.ppr","Product Price");
parameters.put("OM.pv.1","Product Brand");
parameters.put("OM.inv","Number of items in stock");

Visilabs.CallAPI().customEvent("Product View", parameters, getActivity());

Sepet İşlemleri

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.

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.

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.pbid","Basket ID");
parameters.put("OM.pb","Product1 Code;Product2 Code");
parameters.put("OM.pu","Product1 Quantity;Product2 Quantity");
parameters.put("OM.ppr","Product1 Price*Product1 Quantity;Product2 Price*Product2 Quantity");
parameters.put("OM.basketType","BasketPage");
Visilabs.CallAPI().customEvent("Cart", parameters, getActivity());

Satın Alma

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

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.tid","Transaction ID");
parameters.put("OM.pp","Product1 Code;Product2 Code");
parameters.put("OM.pu","Product1 Quantity;Product2 Quantity");
parameters.put("OM.ppr","Product1 Price*Product1 Quantity;Product2 Price*Product2 Quantity");

Visilabs.CallAPI().customEvent("Product Purchase", parameters, getActivity());

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.

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.clist","Category Code/Category ID");

Visilabs.CallAPI().customEvent("Category View", parameters, getActivity());

Arama

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

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.OSS","Search Keyword");
parameters.put("OM.OSSR","Number of search results");

Visilabs.CallAPI().customEvent("In App Search", parameters, getActivity());

Banner Tıklama

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

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.OSB","Banner Name/Banner Code");

Visilabs.CallAPI().customEvent("Banner Click", parameters, getActivity());

Favori İşlemleri

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

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.pf","Product Code");
parameters.put("OM.pfu","1"); 
parameters.put("OM.pfr","Product Price");

Visilabs.CallAPI().customEvent("/om_evt.gif", parameters, getActivity());

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

HashMap<String, String> parameters= new HashMap<String, String>();
parameters.put("OM.pf","Product Code");
parameters.put("OM.pfu","-1"); 
parameters.put("OM.pfr","Product Price");

Visilabs.CallAPI().customEvent("/om_evt.gif", parameters, getActivity());

Kampanya Parametresi Yollama(UTM)

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

HashMap<String, String> properties = new HashMap<>();
properties.put("utm_campaign","euromsg campaign");
properties.put("utm_source","euromsg");
properties.put("utm_medium","push");
Visilabs.CallAPI().sendCampaignParameters(properties, getActivity());

Lokasyon Durum Bilgisini 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.

Visilabs.CallAPI().sendLocationPermission();

Bu bilgi OM.locpermit parametresiyle beraber gönderilir ve 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.

Push Mesajı Token Kaydetme

Visilabs'ın kullanıcılara push mesajları göndermek için token alması gerekiyor. Firebase/Huawei 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.

Aşağıdaki parametreleri yukarıda verilen eventlerin içinde gönderebilirsiniz. Birer örnekleri Oturum Açma ve Kaydolma adımlarında gösterilmiştir.

parameters.put("OM.sys.TokenID", token);
parameters.put("OM.sys.AppID", AppAlias); //RMC Panelden Alınacak

Related Marketing Cloud Knowledge Base TR