Changes for page React native integration

Last modified by Developer on 2020/01/03 12:47

From version < 6.3 >

edited by Developer
on 2020/01/02 14:28

To version < 16.1 >

edited by Developer
on 2020/01/03 09:15

< >

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -2,7 +2,7 @@
  {{toc/}}
  {{/box}}
--= Overview =
++= 1. Overview =
  The plugin is located at npmjs repositories [[(npm repositories)>>https://www.npmjs.com/package/react-native-mobigate]]
  This plugin is built for:
@@ -9,7 +9,7 @@
  * Mobigate SDK version 1.0.4
--= Adding SDK to the project =
++= 2. Adding SDK to the project =
  **First, install library from the repository with**
@@ -60,7 +60,7 @@
  }
  {{/code}}{{/showhide}}
--= Api methods =
++= 3. Api methods =
  To use any method from the plugin add import:
@@ -68,7 +68,7 @@
  import Mobigate from 'react-native-mobigate'
  {{/code}}
--== SDK initialization ==
++== 3.1 SDK initialization ==
  You must initialize the library before running it. Use //init(apiKey, options, onSuccess, onError)// method for that:
@@ -87,7 +87,7 @@
  | appIdentifier|String| | Application identifier
  |appInstallationSource |String| | App installation source e.g., google-play, organic.
  |email |String | | Set's user email.
--|customUserId |String | | Set custom User Agent.
++|customUserId |String | | You may use your custom userID for marking data. By default we are using device ID and emails for matching. Set it before starting the service using MobigateSDk.Builder method.
  | enableUserFields|Json Array | | Enable custom fields in user data. By default MobienceSDK is gathering all identifiers, which it can read. You can choose one of these field: ["email", "imei", "imsi", "msisdn", "mac", "serial"] DODAĆ LINKA DO CONSTANTS.
  | dataGatherPolicy| Json Object| | Enable custom data gater policy. By default MobienceSDK gather all data it can read and hide notification icon. Check below DataGatherPolicy options for more details.
  | enableIdProfiles|Boolean |false | turns on / off the IDs profiles system.
@@ -100,6 +100,7 @@
  |notificationText|String| | if state = Mobigate.DATA_GATHER_POLICY_DEFAULT you can pass custom foreground service notification text
  {{/showhide}}
++
  When the library is already initialized run it. Use //startSDK(onSuccess, onError)// method for that:
  **Mobigate.startSDK(onSuccess, onError)**
@@ -152,18 +152,84 @@
  {{/code}}
  {{/showhide}}
--== Tracking in app events ==
++== 3.2 Tracking in app events ==
--== Remaining methods ==
++In-App Events provide insight on what is happening in your app. It is recommended to take the time and define the events you would like to measure.
++=== 3.2.1 Overview ===
++An event consists of two fields that you (% style="display:none" %) (%%)can use to describe a user's interaction with your app content:
++(% class="table-bordered table-hover" %)
++|(% style="background-color:powderblue; width:200px" %)**Field name**|(% style="background-color:powderblue; width:200px" %)**Type**|(% style="background-color:powderblue; width:200px" %)**Required**|(% style="background-color:powderblue; width:200px" %)**Description**
++|(% style="width:200px" %)Category|(% style="width:200px" %)String|(% style="width:200px" %)yes|(% style="width:200px" %)Event category
++|(% style="width:200px" %)Parameter|(% style="width:200px" %)String|(% style="width:200px" %)no|(% style="width:200px" %)Event parameter.
++There can be more than one
++You can use any event category or parameter string of your choice. However, react-native-mobigate plugin contains recommended event categories and parameters via String constants (see [[Event categories>>doc:||anchor="H3.2.3Eventcategories"]] and [[Event parameters>>doc:||anchor="H3.2.4Eventparameters"]]).
++=== 3.2.2 Implementation ===
++
++Tracking in-app events is performed by two methods:
++
++**Mobigate.trackEvent(options)**
++
++{{showhide id="2" showmessage="Options" hidemessage="Options"}}
  (% class="table-bordered table-hover" style="border-color:powderblue" %)
  |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description
++|name|String | | Event category name.
++|parameters|Json array| | Array of parameters. Look below on example.
++{{/showhide}}
++
++{{showhide id="3" showmessage="Example" hidemessage="Example"}}
++{{code language="javascript"}}
++  sendTrackEvent = () => {
++    if (Platform.OS === 'android') {
++      Mobigate.trackEvent({
++        name: Mobigate.CATEGORY_PURCHASE,
++        parameters: {
++          [Mobigate.PARAMETER_CONTENT_ID]: 42313532,
++          [Mobigate.PARAMETER_PRICE]: 43.23,
++          [Mobigate.PARAMETER_QUANTITY]: 2,
++          'userCustomParameterName':'simpleName'
++        },
++      })
++    }
++  }
++{{/code}}
++{{/showhide}}
++
++
++**Mobigate.trackAppInstall(timestamp)**
++
++(% class="table-bordered table-hover" style="border-color:powderblue" %)
++|=(% style="background-color:powderblue" %)Parameter|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description
++|timestamp|double|Unix timestamp in milliseconds
++
++{{showhide id="3" showmessage="Example" hidemessage="Example"}}
++{{code language="javascript"}}
++  sendTrackEvent = () => {
++    if (Platform.OS === 'android') {
++      Mobigate.trackAppInstall(1578042916000)
++    }
++  }
++{{/code}}
++{{/showhide}}
++
++=== 3.2.3 Event categories ===
++
++=== 3.2.4 Event parameters ===
++
++== 3.3 Remaining methods ==
++
++
++
++
++
++(% class="table-bordered table-hover" style="border-color:powderblue" %)
++|=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description
  | | | |
--= Constants =
++= 4. Constants =
--= Sample app =
++= 5. Sample app =

Changes for page React native integration

Summary

Details

MobigateSDK Center