Changes for page Flutter integration
Last modified by Developer on 2020/03/19 15:21
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -28,32 +28,26 @@ 28 28 29 29 To use any method from the plugin add import: 30 30 31 -{{code language=" javascript"}}32 -import Mobigatefrom 'react-native-mobigate'31 +{{code language="dart"}} 32 +import 'package:flutter_mobigate/flutter_mobigate.dart'; 33 33 {{/code}} 34 34 35 -== 3.1 SDK initialization == 35 +== 3.1 MobigateSDK class initialization == 36 36 37 - You must initializethelibrarybefore running it.Use//init(apiKey, options,onSuccess,onError)//method for that:37 +Initialize class with //MobigateSDK(MobigateOptions options)// 38 38 39 - **Mobigate.init(apiKey,options, onSuccess,onError)**39 +//MobigateOptions(apiKey,{appIdentifier, appInstallationSource,email,cusUserId,enableUserFields,dataGatherPolicy,notificationText,enableIdProfiles})// 40 40 41 +{{showhide id="2" showmessage="MobigateOptions" hidemessage="MobigateOptions"}} 41 41 (% class="table-bordered table-hover" style="border-color:powderblue" %) 42 -|=(% style="background-color:powderblue" %)Parameter|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 43 -|apiKey|String|Api key provided by your business partner 44 -|options|Json Object|SDK configuration 45 -|onSuccess|Function|returns callback object 46 -|onError|Function|returns callback object 47 - 48 -{{showhide id="2" showmessage="Options" hidemessage="Options"}} 49 -(% class="table-bordered table-hover" style="border-color:powderblue" %) 50 50 |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description 51 51 | appIdentifier|String| | Application identifier 52 52 |appInstallationSource |String| | App installation source e.g., google-play, organic. 53 53 |email |String | | Set's user email. 54 -|cus tomUserId |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.47 +|cusUserId |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. 55 55 | 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"] see [[plugin user field constants>>https://wiki.spicymobile.pl/wiki/mobigatesdk/view/Main/sdkintegration/reactnativeintegration/#H4.1Userfieldconstants]]. 56 56 | 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. 50 +| notificationText|String | | if state = Mobigate.DATA_GATHER_POLICY_DEFAULT you can pass custom foreground service notification text. 57 57 | enableIdProfiles|Boolean |false | turns on / off the IDs profiles system. 58 58 {{/showhide}} 59 59 ... ... @@ -61,62 +61,40 @@ 61 61 (% class="table-bordered table-hover" style="border-color:powderblue" %) 62 62 |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description 63 63 | monitorState|String| | Possible monitor states: [[plugin constants>>https://wiki.spicymobile.pl/wiki/mobigatesdk/view/Main/sdkintegration/reactnativeintegration/#H4.2Datagatherpolicyconstants]]. More info about gathering data [[here>>https://wiki.spicymobile.pl/wiki/mobigatesdk/view/Main/mobigatesdkintegrationforandroiddevelopers/#H5.8Datagatherpolicy]] 64 -|notificationText|String| | if state = Mobigate.DATA_GATHER_POLICY_DEFAULT you can pass custom foreground service notification text 65 65 {{/showhide}} 66 66 60 +{{showhide id="3" showmessage="Example" hidemessage="Example"}} 61 +{{code language="dart"}} 62 + MobigateSDK mobigateInstance = MobigateSDK(MobigateOptions( 63 + "V0K6jhiIfem6CRWHYZ59Nmj3oFBBKbJsnSsWfR2JNq7ktblOUXwbJoBQTpWnw2uSwW76gpiu2kun50jweTY69B" 64 + )); 65 +{{/code}} 66 +{{/showhide}} 67 67 68 - Whenthelibraryis already initialized run it. Use //startSDK(onSuccess,onError)// method for that:68 +== 3.2 SDK initialization == 69 69 70 - **Mobigate.startSDK(onSuccess,onError)**70 +You must initialize the library before running it. Use //Future<String> init// method for that: 71 71 72 +**mobigateInstance.init()** 73 + 74 +Return: 75 + 72 72 (% class="table-bordered table-hover" style="border-color:powderblue" %) 73 -|=(% style="background-color:powderblue" %) Parameter|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description74 -| onSuccess|Function|returns callbackobject75 -| onError|Function|returnscallbackobject77 +|=(% style="background-color:powderblue" %)Message|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 78 +|success|String|returns success message 79 +|error|String|returns error message 76 76 77 -{{showhide id="3" showmessage="Example" hidemessage="Example"}} 78 -{{code language="javascript"}} 79 - initLibrary = () => { 80 - if (Platform.OS === 'android') { 81 - Mobigate.init("V0K6jhiIfem6CRWHYZ59Nmj3oFBBKbJsnSsWfR2JNq7ktblOUXwbJoBQTpWnw2uSwW76gpiu2kun50jweTY69B", 82 - { 83 - /*custom options, check docs for more details 84 - appIdentifier: 'customUserAppIdentifier', 85 - appInstallationSource: "customAppInstallationSourcexyz", 86 - email: 'testemail@gmail.com', 87 - userAgent: 'customUserAgent', 88 - customUserId: 'customUserId',*/ 89 - }, (success) => { 90 - /* You can configure custom collectors after init 91 - Mobigate.disableAllDataCollector() 92 - Mobigate.configureDataCollectors(true, [Mobigate.DATA_COLLECTOR_APPS_LIST, 93 - Mobigate.DATA_COLLECTOR_BATTERY, 94 - Mobigate.DATA_COLLECTOR_PHONE_INFO])*/ 81 +When the library is already initialized run it. Use //Future<String> startSdk()// method for that: 95 95 96 - Mobigate.startSDK((result) => { 97 - this.setState({ 98 - status: 'started', 99 - }); 83 +**mobigateInstance.startSdk();** 100 100 101 - }, (errorResult) => { 102 - this.setState({ 103 - status: errorResult, 104 - }); 105 - }) 106 - }, (initError) => { 107 - this.setState({ 108 - status: initError, 109 - }); 110 - }) 111 - }else{ 112 - this.setState({ 113 - status: 'Mobigate SDK supports only Android' 114 - }) 115 - } 116 - } 117 -{{/code}} 118 -{{/showhide}} 85 +Return: 119 119 87 +(% class="table-bordered table-hover" style="border-color:powderblue" %) 88 +|=(% style="background-color:powderblue" %)Message|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 89 +|success|String|returns success message 90 +|error|String|returns error message 91 + 120 120 == 3.2 Tracking in app events == 121 121 122 122 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.