Changes for page Flutter integration
Last modified by Developer on 2020/03/19 15:21
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -4,50 +4,92 @@ 4 4 5 5 = 1. Overview = 6 6 7 -The plugin is located at p ubrepositories [[(pubrepositories)>>https://pub.dev/packages/flutter_mobigate]]7 +The plugin is located at npmjs repositories [[(npm repositories)>>https://www.npmjs.com/package/react-native-mobigate]] 8 8 This plugin is built for: 9 9 10 -* Mobigate SDK version 1.0. 610 +* Mobigate SDK version 1.0.4 11 11 12 12 = 2. Adding SDK to the project = 13 13 14 -**First, add thistoyourpackage'spubspec.yamlfile**14 +**First, install library from the repository with** 15 15 16 16 {{code language=""}} 17 -dependencies: 18 - flutter_mobigate: ^1.0.2 17 +yarn add react-native-mobigate 19 19 {{/code}} 20 20 21 - **Install packages from the command line**20 +or 22 22 23 23 {{code language=""}} 24 - $flutter pubget23 +npm install react-native-mobigate --save 25 25 {{/code}} 26 26 26 +**Link newly added plugin** 27 + 28 +* **React Native >= 0.60** 29 +Starting from React Native 0.60, [[autolinking>>https://github.com/react-native-community/cli/blob/master/docs/autolinking.md]] makes the installation process simpler 30 + 31 +* **React Native <= 0.59** 32 +** Mostly automatic installation: 33 +{{code language=""}}react-native link react-native-mobigate{{/code}} 34 +** Manual installation:{{showhide id="1" showmessage="Manually link the library on Android" hidemessage="Manually link the library on Android"}}* Add to: android/settings.gradle 35 + 36 +{{code language="groovy"}} 37 +include ':react-native-mobigate' 38 +project(':react-native-mobigate').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-mobigate/android') 39 +{{/code}} 40 +* Add to: android/app/build.gradle 41 + 42 +{{code language="groovy"}} 43 +dependencies { 44 +implementation project(':react-native-mobigate') 45 +} 46 +{{/code}} 47 +* Add the MobigatePackage class to your list of exported packages into: android/app/src/main/.../MainApplication.java 48 + 49 +{{code language="java"}} 50 +... 51 +import pl.spicymobile.reactmobigate.MobigatePackage; 52 + 53 + 54 +@Override 55 +protected List<ReactPackage> getPackages() { 56 + return Arrays.<ReactPackage>asList( 57 + new MainReactPackage(), 58 + new MobigatePackage() 59 + ); 60 +} 61 +{{/code}}{{/showhide}} 62 + 27 27 = 3. Api methods = 28 28 29 29 To use any method from the plugin add import: 30 30 31 -{{code language=" dart"}}32 -import 'package:flutter_mobigate/flutter_mobigate.dart';67 +{{code language="javascript"}} 68 +import Mobigate from 'react-native-mobigate' 33 33 {{/code}} 34 34 35 -== 3.1 MobigateSDKclassinitialization ==71 +== 3.1 SDK initialization == 36 36 37 - Initializeclasswith//MobigateSDK(MobigateOptions options)//73 +You must initialize the library before running it. Use //init(apiKey, options, onSuccess, onError)// method for that: 38 38 39 - //MobigateOptions(apiKey,{appIdentifier, appInstallationSource,email,cusUserId,enableUserFields,dataGatherPolicy,notificationText,enableIdProfiles})//75 +**Mobigate.init(apiKey, options, onSuccess, onError)** 40 40 41 -{{showhide id="2" showmessage="MobigateOptions" hidemessage="MobigateOptions"}} 42 42 (% class="table-bordered table-hover" style="border-color:powderblue" %) 78 +|=(% style="background-color:powderblue" %)Parameter|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 79 +|apiKey|String|Api key provided by your business partner 80 +|options|Json Object|SDK configuration 81 +|onSuccess|Function|returns callback object 82 +|onError|Function|returns callback object 83 + 84 +{{showhide id="2" showmessage="Options" hidemessage="Options"}} 85 +(% class="table-bordered table-hover" style="border-color:powderblue" %) 43 43 |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description 44 44 | appIdentifier|String| | Application identifier 45 45 |appInstallationSource |String| | App installation source e.g., google-play, organic. 46 46 |email |String | | Set's user email. 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. 90 +|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. 48 48 | 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]]. 49 49 | 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. 51 51 | enableIdProfiles|Boolean |false | turns on / off the IDs profiles system. 52 52 {{/showhide}} 53 53 ... ... @@ -55,45 +55,67 @@ 55 55 (% class="table-bordered table-hover" style="border-color:powderblue" %) 56 56 |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description 57 57 | 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]] 100 +|notificationText|String| | if state = Mobigate.DATA_GATHER_POLICY_DEFAULT you can pass custom foreground service notification text 58 58 {{/showhide}} 59 59 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 - ==3.2SDKinitialization==104 +When the library is already initialized run it. Use //startSDK(onSuccess, onError)// method for that: 69 69 70 - You must initialize the library before runningit.Use //Future<String> init// methodforthat:106 +**Mobigate.startSDK(onSuccess, onError)** 71 71 72 -**mobigateInstance.init()** 73 - 74 -Return: 75 - 76 76 (% class="table-bordered table-hover" style="border-color:powderblue" %) 77 -|=(% style="background-color:powderblue" %) Message|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description78 -| success|String|returnssuccessmessage79 -| error|String|returnserrormessage109 +|=(% style="background-color:powderblue" %)Parameter|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 110 +|onSuccess|Function|returns callback object 111 +|onError|Function|returns callback object 80 80 81 -When the library is already initialized run it. Use //Future<String> startSdk()// method for that: 113 +{{showhide id="3" showmessage="Example" hidemessage="Example"}} 114 +{{code language="javascript"}} 115 + initLibrary = () => { 116 + if (Platform.OS === 'android') { 117 + Mobigate.init("V0K6jhiIfem6CRWHYZ59Nmj3oFBBKbJsnSsWfR2JNq7ktblOUXwbJoBQTpWnw2uSwW76gpiu2kun50jweTY69B", 118 + { 119 + /*custom options, check docs for more details 120 + appIdentifier: 'customUserAppIdentifier', 121 + appInstallationSource: "customAppInstallationSourcexyz", 122 + email: 'testemail@gmail.com', 123 + userAgent: 'customUserAgent', 124 + customUserId: 'customUserId',*/ 125 + }, (success) => { 126 + /* You can configure custom collectors after init 127 + Mobigate.disableAllDataCollector() 128 + Mobigate.configureDataCollectors(true, [Mobigate.DATA_COLLECTOR_APPS_LIST, 129 + Mobigate.DATA_COLLECTOR_BATTERY, 130 + Mobigate.DATA_COLLECTOR_PHONE_INFO])*/ 82 82 83 -**mobigateInstance.startSdk();** 132 + Mobigate.startSDK((result) => { 133 + this.setState({ 134 + status: 'started', 135 + }); 84 84 85 -Return: 137 + }, (errorResult) => { 138 + this.setState({ 139 + status: errorResult, 140 + }); 141 + }) 142 + }, (initError) => { 143 + this.setState({ 144 + status: initError, 145 + }); 146 + }) 147 + }else{ 148 + this.setState({ 149 + status: 'Mobigate SDK supports only Android' 150 + }) 151 + } 152 + } 153 +{{/code}} 154 +{{/showhide}} 86 86 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 156 +== 3.2 Tracking in app events == 91 91 92 -== 3.3 Tracking in app events == 93 - 94 94 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. 95 95 96 -=== 3. 3.1 Overview ===160 +=== 3.2.1 Overview === 97 97 98 98 An event consists of two fields that you (% style="display:none" %) (%%)can use to describe a user's interaction with your app content: 99 99 ... ... @@ -103,31 +103,41 @@ 103 103 |(% style="width:200px" %)Parameter|(% style="width:200px" %)String|(% style="width:200px" %)no|(% style="width:200px" %)Event parameter. 104 104 There can be more than one 105 105 106 -You can use any event category or parameter string of your choice. However, flutter_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"]]).170 +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"]]). 107 107 108 -=== 3. 3.2 Implementation ===172 +=== 3.2.2 Implementation === 109 109 110 110 Tracking in-app events is performed by two methods: 111 111 112 -** voidtrackEvent(Category category)**176 +**Mobigate.trackEvent(options)** 113 113 178 +{{showhide id="2" showmessage="Options" hidemessage="Options" effect="slide" effectduration="0.3"}} 114 114 (% class="table-bordered table-hover" style="border-color:powderblue" %) 115 -|=(% style="background-color:powderblue" %)Parameter|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 116 -|Category|Category class |Category class built with help of CategoryBuilder 180 +|=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description 181 +|name|String | | Event category name. 182 +|parameters|Json array| | Array of parameters. Look below on example. 183 +{{/showhide}} 117 117 118 118 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 119 -{{code language="dart"}} 120 -mobigateInstance.trackEvent((CategoryBuilder(EventCategory.BEGIN_TRIAL) 121 - ..setParameter(EventParameter.CITY, "Warsaw") 122 - ..setParameter(EventParameter.CONTENT_ID, 523456) 123 - ..setParameter(EventParameter.COUPON_CODE, 97636572) 124 - ..setParameter(EventParameter.CUSTOMER_SEGMENT, [1, 2, 4])) 125 - .build()); 186 +{{code language="javascript"}} 187 + sendTrackEvent = () => { 188 + if (Platform.OS === 'android') { 189 + Mobigate.trackEvent({ 190 + name: Mobigate.CATEGORY_PURCHASE, 191 + parameters: { 192 + [Mobigate.PARAMETER_CONTENT_ID]: 42313532, 193 + [Mobigate.PARAMETER_PRICE]: 43.23, 194 + [Mobigate.PARAMETER_QUANTITY]: 2, 195 + 'userCustomParameterName':'simpleName' 196 + }, 197 + }) 198 + } 199 + } 126 126 {{/code}} 127 127 {{/showhide}} 128 128 129 129 130 -** voidtrackAppInstall(inttimestamp)**204 +**Mobigate.trackAppInstall(timestamp)** 131 131 132 132 (% class="table-bordered table-hover" style="border-color:powderblue" %) 133 133 |=(% style="background-color:powderblue" %)Parameter|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description ... ... @@ -143,7 +143,7 @@ 143 143 {{/code}} 144 144 {{/showhide}} 145 145 146 -=== 3. 3.3 Event categories ===220 +=== 3.2.3 Event categories === 147 147 148 148 The following section describes the recommended structure of each event category. In-app events categories are defined as part of plugin String constants. 149 149 ... ... @@ -316,7 +316,7 @@ 316 316 **Recommended parameters:** CONTENT_ID 317 317 {{/showhide}} 318 318 319 -=== 3. 3.4 Event parameters ===393 +=== 3.2.4 Event parameters === 320 320 321 321 In addition each category that is passed with event may have optional parameters defined as part of the plugin constants, or custom defined as String. Below is a list of recommended parameters. 322 322 ... ... @@ -398,14 +398,14 @@ 398 398 399 399 {{/showhide}} 400 400 401 -== 3. 4Remaining methods ==475 +== 3.3 Remaining methods == 402 402 403 -** voidsetCollectAll()**477 +**Mobigate.setCollectAll()** 404 404 This method enables all data collectors. By default all data collectors are enabled. 405 405 406 406 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 407 -{{code language=" dart"}}408 - mobigateInstance.setCollectAll();481 +{{code language="javascript"}} 482 +Mobigate.disableAllDataCollector() 409 409 {{/code}} 410 410 {{/showhide}} 411 411 ... ... @@ -412,21 +412,19 @@ 412 412 (% style="color:powderblue" %) 413 413 ---- 414 414 415 -** voidconfigureDataCollectors(boolenable,List<int>collectors)**489 +**Mobigate.configureDataCollectors(enable, collectors)** 416 416 Enable or disable DataCollector by array collectors input 417 417 418 418 (% class="table-bordered table-hover" style="border-color:powderblue" %) 419 419 |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 420 -|enable|boolean|true if enable, false if disable 421 -|collectors|array of [[data collector const>>doc:||anchor="H4.3Datacollectorsconstants"]]|e.g.,[Mobigate.DATA_COLLECTOR_BATTERY, DATA_COLLECTOR_GEOLOCATION] 494 +|enable|boolean|true if enable, false if disable| 495 +|collectors|array of [[data collector const>>doc:||anchor="H4.3Datacollectorsconstants"]]|e.g.,[Mobigate.DATA_COLLECTOR_BATTERY, DATA_COLLECTOR_GEOLOCATION]| 422 422 423 423 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 424 -{{code language="dart"}} 425 -mobigateInstance.configureDataCollectors(true, [ 426 - DataCollector.APPS_LIST, 427 - DataCollector.APPS_USAGE, 428 - DataCollector.BROWSER 429 - ]); 498 +{{code language="javascript"}} 499 +Mobigate.configureDataCollectors(true, [Mobigate.DATA_COLLECTOR_APPS_LIST, 500 + Mobigate.DATA_COLLECTOR_BATTERY, 501 + Mobigate.DATA_COLLECTOR_PHONE_INFO]) 430 430 {{/code}} 431 431 {{/showhide}} 432 432 ... ... @@ -433,12 +433,12 @@ 433 433 (% style="color:powderblue" %) 434 434 ---- 435 435 436 -** voiddisableAllDataCollector()**508 +**Mobigate.disableAllDataCollector()** 437 437 Disable all data collectors 438 438 439 439 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 440 -{{code language=" dart"}}441 - mobigateInstance.disableAllDataCollector();512 +{{code language="javascript"}} 513 +Mobigate.disableAllDataCollector() 442 442 {{/code}} 443 443 {{/showhide}} 444 444 ... ... @@ -445,16 +445,16 @@ 445 445 (% style="color:powderblue" %) 446 446 ---- 447 447 448 -** voidsetEmail(Stringemail)**520 +**Mobigate.setEmail(email)** 449 449 Set user's email 450 450 451 451 (% class="table-bordered table-hover" style="border-color:powderblue" %) 452 452 |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 453 -|email |String |user's email address 525 +|email |String |user's email address | 454 454 455 455 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 456 -{{code language=" dart"}}457 - mobigateInstance.setEmail('test@spicymobile.pl');528 +{{code language="javascript"}} 529 +Mobigate.setEmail('emailExample@spicymobile.pl') 458 458 {{/code}} 459 459 {{/showhide}} 460 460 ... ... @@ -461,12 +461,21 @@ 461 461 (% style="color:powderblue" %) 462 462 ---- 463 463 464 -** Future<String> getEmail()**465 -Get previously set user email . Return email on success, error otherwise.536 +**Mobigate.getEmail(onSuccess, onError)** 537 +Get previously set user email 466 466 539 +(% class="table-bordered table-hover" style="border-color:powderblue" %) 540 +|=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 541 +|onSuccess |Function |returns callback object 542 +|onError |Function |returns callback object 543 + 467 467 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 468 -{{code language="dart"}} 469 -final String email = await mobigateInstance.getEmail(); 545 +{{code language="javascript"}} 546 +Mobigate.getEmail((success) => { 547 + console.log("user email: " + success) 548 + }, (error) => { 549 + console.log(error) 550 + }) 470 470 {{/code}} 471 471 {{/showhide}} 472 472 ... ... @@ -473,7 +473,7 @@ 473 473 (% style="color:powderblue" %) 474 474 ---- 475 475 476 -** voidsetFbToken(String token)**557 +**Mobigate.setFbToken(token)** 477 477 Set fb token for social network collector 478 478 479 479 (% class="table-bordered table-hover" style="border-color:powderblue" %) ... ... @@ -481,20 +481,49 @@ 481 481 |token |string |facebook token 482 482 483 483 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 484 -{{code language=" dart"}}485 - mobigateInstance.setFbToken('dsf87esy789fys9dfu08sds54s6547c8s8doc4');565 +{{code language="javascript"}} 566 +Mobigate.setFbToken('9dsf87ds98978das98d7893u12rj808d0j09012jd012') 486 486 {{/code}} 487 487 {{/showhide}} 488 488 570 +((( 571 +(% class="showhidebutton" %) 572 +((( 573 +{{html clean="false"}} 574 +<a href="javascript:void(0)" id="showhidebuttontext3" data-show-duration="0" data-show-effect="toggle" data-show-message="Example" data-hide-message="Example">Example</a> 575 +{{/html}} 576 +))) 577 + 578 +(% class="showhidecontent" id="showhidecontent3" style="display: none;" %) 579 +((( 580 +((( 581 +{{code language="javascript"}} 582 +Mobigate.setFbToken('9dsf87ds98978das98d7893u12rj808d0j09012jd012') 583 +{{/code}} 584 +))) 585 +))) 586 +))) 587 + 588 + 589 + 489 489 (% style="color:powderblue" %) 490 490 ---- 491 491 492 -** Future<String> getSDKInfo()**493 -Getting information about the library . Return on success sdk info string, error otherwise.593 +**Mobigate.getSDKInfo(onSuccess, onError)** 594 +Getting information about the library 494 494 596 +(% class="table-bordered table-hover" style="border-color:powderblue" %) 597 +|=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 598 +|onSuccess |Function |returns callback object 599 +|onError |Function |returns callback object 600 + 495 495 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 496 -{{code language="dart"}} 497 -final String sdkInfo = await mobigateInstance.getSDKInfo(); 602 +{{code language="javascript"}} 603 +Mobigate.getSDKInfo((success) => { 604 + console.log("sdk info: " + success) 605 + }, (error) => { 606 + console.log(error) 607 + }) 498 498 {{/code}} 499 499 {{/showhide}} 500 500 ... ... @@ -501,12 +501,21 @@ 501 501 (% style="color:powderblue" %) 502 502 ---- 503 503 504 -** Future<String> getSDKUniqueIdentifier()**505 -Return unique SDK identificator . Return on success sdk unique identifier, error otherwise.614 +**Mobigate.getSDKUniqueIdentifier(onSuccess, onError)** 615 +Return unique SDK identificator 506 506 617 +(% class="table-bordered table-hover" style="border-color:powderblue" %) 618 +|=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 619 +|onSuccess |Function |returns callback object 620 +|onError |Function |returns callback object 621 + 507 507 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 508 -{{code language="dart"}} 509 -final String sdkUniqueIdentifier = await mobigateInstance.getSDKUniqueIdentifier(); 623 +{{code language="javascript"}} 624 +Mobigate.getSDKUniqueIdentifier((success) => { 625 + console.log("UUID: " + success) 626 + }, (error) => { 627 + console.log(error) 628 + }) 510 510 {{/code}} 511 511 {{/showhide}} 512 512 ... ... @@ -513,12 +513,22 @@ 513 513 (% style="color:powderblue" %) 514 514 ---- 515 515 516 -** Future<List<int>>getIDsProfiles()**635 +**Mobigate.getIDsProfiles(onSuccess, onError)** 517 517 Method returns IDs profiles. List of IDs profiles in the application memory is updated (synchronized with the server) at specified intervals. To enable functionality, use the 'enableIDsProfiles (boolean enable)' method. Returns the identifiers of IDs profiles (ex. 5,9,20), returns '0' if list of user IDs profiles is empty, returns 'null' if the system has not yet communicated 518 518 638 + 639 +(% class="table-bordered table-hover" style="border-color:powderblue" %) 640 +|=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 641 +|onSuccess |Function |returns callback object 642 +|onError |Function |returns callback object 643 + 519 519 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 520 -{{code language="dart"}} 521 -final List<int> idsProfiles = await mobigateInstance.getIDsProfiles(); 645 +{{code language="javascript"}} 646 +Mobigate.getIDsProfiles((success) => { 647 + console.log("Profiles: " + success) 648 + }, (error) => { 649 + console.log(error) 650 + }) 522 522 {{/code}} 523 523 {{/showhide}} 524 524 ... ... @@ -525,12 +525,21 @@ 525 525 (% style="color:powderblue" %) 526 526 ---- 527 527 528 -** Future<Map<String, int>>getAdOceanTargeting()**657 +**Mobigate.getAdOceanTargeting(onSuccess, onError)** 529 529 Getting numerical variables, that can be used for ads targeting. Method must be called from separate thread. Return 3 different identifiers of a user, encoded into a map of AdOcean numerical variables 530 530 660 +(% class="table-bordered table-hover" style="border-color:powderblue" %) 661 +|=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Description 662 +|onSuccess |Function |returns callback object 663 +|onError |Function |returns callback object 664 + 531 531 {{showhide id="3" showmessage="Example" hidemessage="Example"}} 532 -{{code language="dart"}} 533 -final Map<String,int> adOceanTargeting = await mobigateInstance.getAdOceanTargeting(); 666 +{{code language="javascript"}} 667 +Mobigate.getAdOceanTargeting((success) => { 668 + console.log("Adocean targeting: " + success) 669 + }, (error) => { 670 + console.log(error) 671 + }) 534 534 {{/code}} 535 535 {{/showhide}} 536 536 ... ... @@ -542,55 +542,55 @@ 542 542 543 543 Used to set custom user fields inside //Mobigate.init()// method: 544 544 545 -* UserField.USER_FIELD_EMAIL546 -* UserField.USER_FIELD_IMSI547 -* UserField.USER_FIELD_IMEI548 -* UserField.USER_FIELD_SERIAL683 +* Mobigate.USER_FIELD_EMAIL 684 +* Mobigate.USER_FIELD_IMSI 685 +* Mobigate.USER_FIELD_IMEI 686 +* Mobigate.USER_FIELD_SERIAL 549 549 550 550 == 4.2 Data gather policy constants == 551 551 552 552 Used to set how the library collects data: 553 553 554 -* Mo nitorState.DATA_GATHER_POLICY_DEFAULT555 -* Mo nitorState.DATA_GATHER_POLICY_HIDE_TRAY556 -* Mo nitorState.DATA_GATHER_POLICY_BLOCK_DATA_BG692 +* Mobigate.DATA_GATHER_POLICY_DEFAULT 693 +* Mobigate.DATA_GATHER_POLICY_HIDE_TRAY 694 +* Mobigate.DATA_GATHER_POLICY_BLOCK_DATA_BG 557 557 558 558 == 4.3 Data collectors constants == 559 559 560 560 Used to set which data the library should collect: 561 561 562 -* DataCollector.APPS_LIST563 -* DataCollector.DATA_COLLECTOR_APPS_USAGE564 -* DataCollector.BATTERY565 -* DataCollector.BROWSER566 -* DataCollector.CALENDAR_EVENTS567 -* DataCollector.CPU_PROCESS568 -* DataCollector.DICTIONARY569 -* DataCollector.GEOLOCATION570 -* DataCollector.HEADSET_PLUG571 -* DataCollector.MEDIA_FILES572 -* DataCollector.MEMORY_USEAGE573 -* DataCollector.NETWORK_CONNECTION574 -* DataCollector.NETWORK_USEAGE575 -* DataCollector.PACKAGE_CHANGE576 -* DataCollector.PHONE_INFO577 -* DataCollector.ROAMING578 -* DataCollector.SCREEN_ORIENTED579 -* DataCollector.SIGNAL_STRENGTH580 -* DataCollector.PROFILE_MODE581 -* DataCollector.WIFI_DATA_CONNECTION582 -* DataCollector.PERMISSION_COLLECTOR583 -* DataCollector.NFC_COLLECTOR584 -* DataCollector.BLUETOOTH_COLLECTOR585 -* DataCollector.BLUETOOTH_DEVICES_COLLECTOR586 -* DataCollector.MOVEMENT_COLLECTOR587 -* DataCollector.FACEBOOK_NETWORK_COLLECTOR588 -* DataCollector.ROOT_COLLECTOR700 +* Mobigate.DATA_COLLECTOR_APPS_LIST 701 +* Mobigate.DATA_COLLECTOR_APPS_USAGE 702 +* Mobigate.DATA_COLLECTOR_BATTERY 703 +* Mobigate.DATA_COLLECTOR_BROWSER 704 +* Mobigate.DATA_COLLECTOR_CALENDAR_EVENTS 705 +* Mobigate.DATA_COLLECTOR_CPU_PROCESS 706 +* Mobigate.DATA_COLLECTOR_DICTIONARY 707 +* Mobigate.DATA_COLLECTOR_GEOLOCATION 708 +* Mobigate.DATA_COLLECTOR_HEADSET_PLUG 709 +* Mobigate.DATA_COLLECTOR_MEDIA_FILES 710 +* Mobigate.DATA_COLLECTOR_MEMORY_USEAGE 711 +* Mobigate.DATA_COLLECTOR_NETWORK_CONNECTION 712 +* Mobigate.DATA_COLLECTOR_NETWORK_USEAGE 713 +* Mobigate.DATA_COLLECTOR_PACKAGE_CHANGE 714 +* Mobigate.DATA_COLLECTOR_PHONE_INFO 715 +* Mobigate.DATA_COLLECTOR_ROAMING 716 +* Mobigate.DATA_COLLECTOR_SCREEN_ORIENTED 717 +* Mobigate.DATA_COLLECTOR_SIGNAL_STRENGTH 718 +* Mobigate.DATA_COLLECTOR_PROFILE_MODE 719 +* Mobigate.DATA_COLLECTOR_WIFI_DATA_CONNECTION 720 +* Mobigate.DATA_COLLECTOR_PERMISSION_COLLECTOR 721 +* Mobigate.DATA_COLLECTOR_NFC_COLLECTOR 722 +* Mobigate.DATA_COLLECTOR_BLUETOOTH_COLLECTOR 723 +* Mobigate.DATA_COLLECTOR_BLUETOOTH_DEVICES_COLLECTOR 724 +* Mobigate.DATA_COLLECTOR_MOVEMENT_COLLECTOR 725 +* Mobigate.DATA_COLLECTOR_FACEBOOK_NETWORK_COLLECTOR 726 +* Mobigate.DATA_COLLECTOR_ROOT_COLLECTOR 589 589 590 590 == 4.4 Category and parameter constants == 591 591 592 -Instead of using defined [[categories>>doc:||anchor="H3. 3.3Eventcategories"]] or [[parameters>>doc:||anchor="H3.3.4Eventparameters"]] in the form of text, you can use constants defined in the plugin. All you have to do isuseEventCategory orEventParameterclasse.g.,EventCategory.LEVEL_ACCOMPLISHED,EventCategory.PURCHASE,EventParameter.PRICE,EventParameter.LEVEL.730 +Instead of using defined [[categories>>doc:||anchor="H3.2.3Eventcategories"]] or [[parameters>>doc:||anchor="H3.2.4Eventparameters"]] in the form of text, you can use constants defined in the plugin. All you have to do is add the prefix "CATEGORY_" or "PARAMETER_" to the category name or parameter e.g., Mobigate.CATEGORY_LEVEL_ACCOMPLISHED, Mobigate.CATEGORY_PURCHASE, Mobigate.PARAMETER_PRICE, Mobigate.PARAMETER_LEVEL. 593 593 594 594 = 5. Sample app = 595 595 596 -The sample application is located in the github repository [[here>>https://github.com/mobigatesdk/ flutter_mobigate]] in //example// folder.734 +The sample application is located in the github repository [[here>>https://github.com/mobigatesdk/react-native-mobigate]] in //example// folder.