Versions Compared

Key

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

...

Info

There is no need to enable any module to send data only. It is enough to initialize the SDK.

Info

In order the data that you sent to be loaded to RMC panel correctly, you should use the same reference value (KEY_ID* veya E-Mail) that you use in your RMC account when sending data via mobile channel.

*KEY_ID: It is the ID that you use to make a user unique in your system like CRM id, userId, customerId, accountId.

exVisitorId value can be keyID or E-mail according to your structure.

...

You can send additional information via this method. The example below shows the usage of signUp() method with OM.sys.TokenID and OM.sys.AppID parameters. These parameters are necessary to send push notifications and can be gotten from the RMC panel.

Kotlin

Code Block
languagekotlin
val parameters = HashMap<String, String>()
parameters["OM.sys.TokenID"] = "tokenValue"
parameters["OM.sys.AppID"] = "appAliasValue"
RelatedDigital.signUp(
  context = context,
  exVisitorId = "exVisitorIdValue",
  properties = parameters
)

...

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.sys.TokenID", "tokenValue");
parameters.put("OM.sys.AppID", "appAliasValue");
RelatedDigital.signUp(
  context,
  "exVisitorIdValue",
  parameters
);

Login

You can call login() method with or without additional information like signUp() method.

Kotlin

Code Block
languagekotlin
RelatedDigital.login(
  context = context,
  exVisitorId = "exVisitorIdValue"
)

...

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.sys.TokenID", "tokenValue");
parameters.put("OM.sys.AppID", "appAliasValue");
parameters.put("OM.vseg1", "seg1Value");
parameters.put("OM.vseg2", "seg2Value");
parameters.put("OM.vseg3", "seg3Value");
parameters.put("OM.vseg4", "seg4Value");
parameters.put("OM.vseg5", "seg5Value");
parameters.put("OM.bd", "1995-09-02");
parameters.put("OM.gn", "m");
parameters.put("OM.loc", "istanbul");
RelatedDigital.login(
  context,
  "exVisitorIdValue",
  parameters
);

Page View

You can use the customEvent() method below to send the page name that the user is currently viewing.

...

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
RelatedDigital.customEvent(
  context,
  "Frequently Asked Questions",
  parameters
);

Product View

You can use customEvent() method below when the user views a product in your application.

...

Adding an Item to the Cart

You can call the customEvent() method below when the user adds an item into the cart(basket).

...

Code Block
languagejava
HashMap<String, String> parameters = new HashMap<String, String>();
parameters.put("OM.pbid", "Basket ID");
parameters.put("OM.pb", "Product1Code;Product2Code");
parameters.put("OM.pu", "Product1Quantity;Product2Quantity");
parameters.put("OM.ppr", "Product1Price*Product1Quantity;Product2Price*Product2Quantity");
RelatedDigital.customEvent(
  context,
  "Cart",
  parameters
);

Purchase

You can use the customEvent() method below when the user make a purchase in your application.

...

Category View

You can use the customEvent() method below when the user views a category page in your application.

...

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

You can use the customEvent() method below when the user makes a search in your application.

...

Banner Click

You can use the customEvent() method when the user clicks on a banner in your application.

...

Favorilere Ekleme

You can use the customEvent() method below when the user adds an item to his/her favorites.

...

Info

You should send "OM.pfu" as “1” when an item is added to the favorites; whereas you should send it as “-1” when an item is removed from the favorites.

...

Favorilerden Çıkarma

You can use customEvent() method below when the user removes an item from his/her favorites.

...

Info

You should send "OM.pfu" as “1” when an item is added to the favorites; whereas you should send it as “-1” when an item is removed from the favorites.

...

App Tracker feature is for sending the list of the application applications that were installed from Google Play Store, Amazon App Store and Huawei App Gallery and are still installed in the device of the user. You can call the

sendTheListOfAppsInstalled() method below. It is up to you to determine how often you will call it and where in your code you will call it. (Example, in the launcher activity and once in a week).

...

Android provides 2 options to access the list of the application applications installed in the device.

1-) You can write the package names of the applications that you are interested in into AndroidManifest.xml file as below:

...

Info

In the second option, Google Play Store may expect you to explain why you need this permission.

https://developer.android.com/training/basics/intents/package-visibility

First option does not require any permission.

After applying one of the 2 options above it is enough to call

RelatedDigital.sendTheListOfAppsInstalled( context = context )

Sending Location Permission Status

...

Info

This information is sent with “OM.locpermit” and can have one of the 3 values below.

"always" : The permission is granted even when the app is closed(background).

"appopen" : The permission is granted only when the app is open.

"none" : The permission is not granted at all.

...