Versions Compared

Old Version 7

changes.mady.by.user emre.eken

Saved on

compared with

New Version 8

changes.mady.by.user emre.eken

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel7

...

Info

Veri Gönderimi için herhangi bir modülün etkinleştirilmesine gerek yoktur. SDK’nın init edilmesi yeterlidir.

Info

Mobil kanaldan gelen verilerinizin 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 verilerin de 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.

Kaydolma

Kotlin

Code Block
languagekotlin
RelatedDigital.signUp(
  context = context,
  exVisitorId = "exVisitorIdDeğeri"
)

Java

Code Block
languagejava
RelatedDigital.signUp(
  context,
  "exVisitorIdDeğeri"
);
Info

exVisitorId parametresi ile RMC panelinde kullanıcıyı tekilleştirmek için kullandığınız özellik gönderilmelidir. Örneğin, email

Bu metod aracılığıyla ek bilgiler göndermek de mümkündür. Aşağıdaki örnek, OM.sys.TokenID ve OM.sys.AppID parametrelerini içeren özelliklerle signUp metodunun ç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.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.sys.TokenID"] = "tokenDeğeri"
parameters["OM.sys.AppID"] = "appAliasDeğeri"
RelatedDigital.signUp(
  context = context,
  exVisitorId = "exVisitorIdDeğeri",
  properties = parameters
  )

Oturum Açma

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

Java

exVisitorId parametresi ile RMC panelinde kullanıcıyı tekilleştirmek için kullandığınız özellik gönderilmelidir. Örneğin, email
Code Block
Info
languagekotlin
RelatedDigital.login(
  context = context,
  exVisitorId = "exVisitorIdDeğeri"
  )
java
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.sys.TokenID", "tokenDeğeri");
parameters.put("OM.sys.AppID", "appAliasDeğeri");
RelatedDigital.signUp(
  context,
  "exVisitorIdDeğeri",
  parameters
);

Oturum Açma

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

Kotlin

Code Block
languagekotlin
val parametersRelatedDigital.login(
  context = HashMap<Stringcontext, String>()
parameters["OM.sys.TokenID"] = "tokenDeğeri"
parameters["OM.sys.AppID"] exVisitorId = "appAliasDeğeriexVisitorIdDeğeri"
)

Java

Code Block
languagejava
RelatedDigital.login(
  context = context,
  exVisitorId = "exVisitorIdDeğeri",
  properties = parameters
  )

Ayrıca, kullanıcıyı segmentlemenizi sağlayacak parametreleri de ekleyebilirsiniz.


);
Info

exVisitorId parametresi ile RMC panelinde kullanıcıyı tekilleştirmek için kullandığınız özellik gönderilmelidir. Örneğin, email

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.sys.TokenID"] = "tokenDeğeri"
parameters["OM.sys.AppID"] = "appAliasDeğeri"
parameters["OM.vseg1"] = "seg1Değeri"
parameters["OM.vseg2"] = "seg2Değeri"
parameters["OM.vseg3"]RelatedDigital.login(
  context = context,
  exVisitorId = "seg3Değeri"
parameters["OM.vseg4"] = "seg4Değeri"
parameters["OM.vseg5"] = "seg5Değeri"
parameters["OM.bd"] = "1995-09-02"
parameters["OM.gn"] = "m"
parameters["OM.loc"] = "istanbul"
RelatedDigital.login(
  context =exVisitorIdDeğeri",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.sys.TokenID", "tokenDeğeri");
parameters.put("OM.sys.AppID", "appAliasDeğeri");
RelatedDigital.login(
  context,
  exVisitorId = "exVisitorIdDeğeri",
  properties = parameters
 
)

Sayfa Görüntüleme

...

;

Ayrıca, kullanıcıyı segmentlemenizi sağlayacak parametreleri de ekleyebilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
RelatedDigital.customEvent(
  context = context,
  pageNameparameters["OM.sys.TokenID"] = "tokenDeğeri"
parameters["OM.sys.AppID"] = "appAliasDeğeri"
parameters["OM.vseg1"] = "Sıkça Sorulan Sorular",
  properties = parameters
  )

Ürün Görüntüleme

Kullanıcının uygulamanızda bir ürün görüntülediği bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Code Block
languagekotlin
val parameters = HashMap<String, String>()
seg1Değeri"
parameters["OM.vseg2"] = "seg2Değeri"
parameters["OM.vseg3"] = "seg3Değeri"
parameters["OM.vseg4"] = "seg4Değeri"
parameters["OM.pvvseg5"] = "Product Code" //Ürün Koduseg5Değeri"
parameters["OM.pnbd"] = "Product Name1995-09-02"
//Ürün İsmi
parameters["OM.pprgn"] = "Product Price" //Ürün Fiyatı
m"
parameters["OM.pv.1loc"] = "Product Brand" //Ürün markası
parameters["OM.inv"] = "Number of items in stock" //Stokta kaç tane kaldığı
RelatedDigital.customEvent(
  context = context,
  pageName = "Product View",
  properties = parameters
  )

Sepete Ekleme

Kullanıcının sepete ürün eklemesi veya çıkarması bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Info

Sepette bulunan son üründe kullanıcı tarafından silindiğinde OM.pb, OM.pu ve OM.ppr parametrelerini boş string olarak göndermelisiniz. Örnek,

parameters["OM.pb"] = ""

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.pbid"] = "Basket ID" //Sepet ID si
parameters["OM.pb"] = "Product1Code;Product2Code" //Ürün1Kodu;Ürün2Kodu
parameters["OM.pu"] = "Product1Quantity;Product2Quantity" //Ürün1Miktarı;Ürün2Miktarı
parameters["OM.ppr"] = "Product1Price*Product1Quantity;Product2Price*Product2Quantity" //Ürün1Fiyatı*Ürün1Miktarı;Ürün2Fiyatı*Ürün2Miktarı
RelatedDigital.customEvent(
  context = context,
  pageName = "Cart",
  properties = parameters
  )

Satın Alma

Kullanıcının bir ürün satın alması bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

istanbul"
RelatedDigital.login(
  context = context,
  exVisitorId = "exVisitorIdDeğeri",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.sys.TokenID", "tokenDeğeri");
parameters.put("OM.sys.AppID", "appAliasDeğeri");
parameters.put("OM.vseg1", "seg1Değeri");
parameters.put("OM.vseg2", "seg2Değeri");
parameters.put("OM.vseg3", "seg3Değeri");
parameters.put("OM.vseg4", "seg4Değeri");
parameters.put("OM.vseg5", "seg5Değeri");
parameters.put("OM.bd", "1995-09-02");
parameters.put("OM.gn", "m");
parameters.put("OM.loc", "istanbul");
RelatedDigital.login(
  context,
  "exVisitorIdDeğeri",
  parameters
);

Sayfa Görüntüleme

Kullanıcının o anda görüntülemekte olduğu sayfa adını göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz. properties’e fazladan parametreler ekleyebilir veya boş bırakabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.tid"] = "Transaction ID" //İşlem ID'si
parameters["OM.pp"]RelatedDigital.customEvent(
  context = context,
  pageName = "Product1Code;Product2Code" //Ürün1Kodu;Ürün2Kodu
parameters["OM.pu"] = "Product1Quantity;Product2Quantity" //Ürün1Miktarı;Ürün2Miktarı
parameters["OM.ppr"] = "Product1Price*Product1Quantity;Product2Price*Product2Quantity" //Ürün1Fiyatı*Ürün1Miktarı;Ürün2Fiyatı*Ürün2MiktarıSıkça Sorulan Sorular",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
RelatedDigital.customEvent(
  context = context,
  pageName"Sıkça =Sorulan Sorular"Product Purchase",
  properties = parameters
  )

...

parameters
);

Ürün Görüntüleme

Kullanıcının uygulamanızda bir kategori sayfasını görüntülemesi ürün görüntülediği bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.clistpv"] = "CategoryProduct Code/Category ID" //KategoriÜrün Kodu/Kategori ID'si
RelatedDigital.customEvent(
  context = context,
  pageName = "Category View",
  properties = parameters
  )

Arama

Kullanıcının uygulamanızda yaptığı arama bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.OSS"] = "Text Searched" //Aranan Metin
parameters["OM.OSSR"] = "Number of Results" //Sonuç Sayısı
RelatedDigital.customEvent(
  context = context,
  pageName = "Search",
  properties = parameters
  )

Banner Tıklaması

Kullanıcının uygulamanızdaki bir banner a tıklaması bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.OSB"] = "Banner Name/Banner Code" //Banner İsmi/Banner Kodu
parameters["OM.pn"] = "Product Name" //Ürün İsmi
parameters["OM.ppr"] = "Product Price" //Ürün Fiyatı
parameters["OM.pv.1"] = "Product Brand" //Ürün markası
parameters["OM.inv"] = "Number of items in stock" //Stokta kaç tane kaldığı
RelatedDigital.customEvent(
  context = context,
  pageName = "Product View",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.pv", "Product Code"); //Ürün Kodu
parameters.put("OM.pn", "Product Name"); //Ürün İsmi
parameters.put("OM.ppr", "Product Price"); //Ürün Fiyatı
parameters.put("OM.pv.1", "Product Brand"); //Ürün markası
parameters.put("OM.inv", "Number of items in stock"); //Stokta kaç tane kaldığı
RelatedDigital.customEvent(
  context = context,

 pageName = "BannerProduct ClickView",
  properties = parameters
  )

Favorilere Ekleme

...

 parameters
);

Sepete Ekleme

Kullanıcının sepete ürün eklemesi veya çıkarması bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Info

Sepette bulunan son üründe kullanıcı tarafından silindiğinde OM.pb, OM.pu ve OM.ppr parametrelerini boş string olarak göndermelisiniz. Örnek,

parameters["OM.pb"] = ""

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.pbid"] = "Basket ID" //Sepet ID si
parameters["OM.pb"] = "Product1Code;Product2Code" //Ürün1Kodu;Ürün2Kodu
parameters["OM.pu"] = "Product1Quantity;Product2Quantity" //Ürün1Miktarı;Ürün2Miktarı
parameters["OM.ppr"] = "Product1Price*Product1Quantity;Product2Price*Product2Quantity" //Ürün1Fiyatı*Ürün1Miktarı;Ürün2Fiyatı*Ürün2Miktarı
RelatedDigital.customEvent(
  context = context,
  pageName = "Cart",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.pbid", "Basket ID"); //Sepet ID si
parameters.put("OM.pb", "Product1Code;Product2Code"); //Ürün1Kodu;Ürün2Kodu
parameters.put("OM.pu", "Product1Quantity;Product2Quantity"); //Ürün1Miktarı;Ürün2Miktarı
parameters.put("OM.ppr", "Product1Price*Product1Quantity;Product2Price*Product2Quantity"); //Ürün1Fiyatı*Ürün1Miktarı;Ürün2Fiyatı*Ürün2Miktarı
RelatedDigital.customEvent(
  context,
  "Cart",
  parameters
);

Satın Alma

Kullanıcının bir ürün satın alması bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.tid"] = "Transaction ID" //İşlem ID'si
parameters["OM.pp"] = "Product1Code;Product2Code" //Ürün1Kodu;Ürün2Kodu
parameters["OM.pu"] = "Product1Quantity;Product2Quantity" //Ürün1Miktarı;Ürün2Miktarı
parameters["OM.ppr"] = "Product1Price*Product1Quantity;Product2Price*Product2Quantity" //Ürün1Fiyatı*Ürün1Miktarı;Ürün2Fiyatı*Ürün2Miktarı
RelatedDigital.customEvent(
  context = context,
  pageName = "Product Purchase",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.tid", "Transaction ID"); //İşlem ID'si
parameters.put("OM.pp", "Product1Code;Product2Code"); //Ürün1Kodu;Ürün2Kodu
parameters.put("OM.pu", "Product1Quantity;Product2Quantity"); //Ürün1Miktarı;Ürün2Miktarı
parameters.put("OM.ppr", "Product1Price*Product1Quantity;Product2Price*Product2Quantity"); //Ürün1Fiyatı*Ürün1Miktarı;Ürün2Fiyatı*Ürün2Miktarı
RelatedDigital.customEvent(
  context,
  Product Purchase",
  parameters
);

Kategori Görüntüleme

Kullanıcının bir kategori sayfasını görüntülemesi bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.clist"] = "Category Code/Category ID" //Kategori Kodu/Kategori ID'si
RelatedDigital.customEvent(
  context = context,
  pageName = "Category View",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.clist", "Category Code/Category ID"); //Kategori Kodu/Kategori ID'si
RelatedDigital.customEvent(
  context,
  "Category View",
  parameters
);

Arama

Kullanıcının uygulamanızda yaptığı arama bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.OSS"] = "Text Searched" //Aranan Metin
parameters["OM.OSSR"] = "Number of Results" //Sonuç Sayısı
RelatedDigital.customEvent(
  context = context,
  pageName = "Search",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.OSS", "Text Searched"); //Aranan Metin
parameters.put("OM.OSSR", "Number of Results"); //Sonuç Sayısı
RelatedDigital.customEvent(
  context,
  "Search",
  parameters
);

Banner Tıklaması

Kullanıcının uygulamanızdaki bir banner a tıklaması bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.OSB"] = "Banner Name/Banner Code" //Banner İsmi/Banner Kodu
RelatedDigital.customEvent(
  context = context,
  pageName = "Banner Click",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.OSB", "Banner Name/Banner Code"); //Banner İsmi/Banner Kodu
RelatedDigital.customEvent(
  context,
  "Banner Click",
  parameters
);

Favorilere Ekleme

Kullanıcının favorilerine ürün eklemesi bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.pf"] = "Product Code" //Ürün Kodu
parameters["OM.pfu"] = "1"
parameters["OM.pfr"] = "Product Price" //Ürün Fiyatı
RelatedDigital.customEvent(
  context = context,
  pageName = "/om_evt.gif",
  properties = parameters
)

Java

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.pf", "Product Code"); //Ürün Kodu
parameters.put("OM.pfu", "1"); //Ürün Kodu
parameters.put("OM.pfr", "Product Price"); //Ürün Fiyatı
RelatedDigital.customEvent(
  context,
  "/om_evt.gif",
  parameters
);
Info

Favorilere ürün eklendiğinde "OM.pfu" değeri “1”; çıkarıldığında ise “-1” gönderilmelidir.

Info

Favorilere ürün eklendiğinde veya çıkarıldığında pageName parametresi "/om_evt.gif" şeklinde gönderilmelidir.

Favorilerden Çıkarma

Kullanıcının favorilerinden ürün çıkarması bilgisini göndermek için aşağıdaki customEvent metodunu kullanabilirsiniz.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.pf"] = "Product Code" //Ürün Kodu
parameters["OM.pfu"] = "-1"
parameters["OM.pfr"] = "Product Price" //Ürün Fiyatı
RelatedDigital.customEvent(
  context = context,
  pageName = "/om_evt.gif",
  properties = parameters
  )
Info

Favorilere ürün eklendiğinde "OM.pfu" değeri “1”; çıkarıldığında ise “-1” gönderilmelidir.

Info

Favorilere ürün eklendiğinde veya çıkarıldığında pageName parametresi "/om_evt.gif" şeklinde gönderilmelidir.

Favorilerden Çıkarma

...

Java
val
 Code Block
languagekotlin
java
HashMap<String, String> parameters = new HashMap<String, String>();
parameters[.put("OM.pf"], = "Product Code"); //Ürün Kodu
parameters[.put("OM.pfu"] =, "-1"); parameters[//Ürün Kodu
parameters.put("OM.pfr"], = "Product Price"); //Ürün Fiyatı
RelatedDigital.customEvent(
 
context = context,
 
pageName = "/om_evt.gif",
  properties = parameters
  );
 Info
Favorilere ürün eklendiğinde "OM.pfu" değeri “1”; çıkarıldığında ise “-1” gönderilmelidir.
...
Uygulama Takibi özelliği kullanıcının cihazındaki Google Play Store, Amazon App Store ve Huawei App Gallery' den yüklenmiş (ve hala yüklü durumda olan) uygulamaların listesini göndermek içindir. Aşağıdaki sendTheListOfAppsInstalled metodunu uygulamanızın isteğinizin yerinden ve istediğiniz zaman aralığıyla çağırabilirsiniz (Örneğin, launcher activity içerisinden haftada bir).
Kotlin
 Code Block
RelatedDigital.sendTheListOfAppsInstalled(
  context = context
)
Java
 Code Block
languagejava
RelatedDigital.sendTheListOfAppsInstalled(
  context
);
Android, cihazda yüklü uygulamaların listesine erişmek için 2 seçenek sunmaktadır:
...
Kullanıcının lokasyon izin durumu bilgisini göndermek için aşağıdaki sendLocationPermission metodunu kullanabilirsiniz.
Kotlin
 Code Block
languagekotlin
RelatedDigital.sendLocationPermission(
  context = = context
)
Java
 Code Block
languagejava
RelatedDigital.sendLocationPermission(
  context
);
 Info
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.
...
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.
Kotlin
 Code Block
languagekotlin
parameters["OM.sys.TokenID"] = "tokenDeğeri"
parameters["OM.sys.AppID"] = "appAliasDeğeri" // RMC panelden alınacaktır
Java
 Code Block
languagejava
parameters.put("OM.sys.TokenID", "tokenDeğeri");
parameters.put("OM.sys.AppID", "appAliasDeğeri"); // RMC panelden alınacaktır
...