Wiki source code of React native integration
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
2.1 | 1 | {{box cssClass="floatinginfobox" title="**Page Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | = Overview = | ||
| |
4.1 | 6 | |
| |
3.1 | 7 | The plugin is located at npmjs repositories [[(npm repositories)>>https://www.npmjs.com/package/react-native-mobigate]] |
| |
4.1 | 8 | This plugin is built for: |
| 9 | |||
| 10 | * Mobigate SDK version 1.0.4 | ||
| 11 | |||
| |
2.1 | 12 | = Adding SDK to the project = |
| 13 | |||
| |
4.1 | 14 | **First, install library from the repository with** |
| |
2.1 | 15 | |
| |
4.1 | 16 | {{code language=""}} |
| 17 | yarn add react-native-mobigate | ||
| 18 | {{/code}} | ||
| 19 | |||
| 20 | or | ||
| 21 | |||
| 22 | {{code language=""}} | ||
| 23 | npm install react-native-mobigate --save | ||
| 24 | {{/code}} | ||
| 25 | |||
| 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}} | ||
| |
5.2 | 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 |
| |
4.1 | 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}} | ||
| |
5.1 | 40 | * Add to: android/app/build.gradle |
| |
4.1 | 41 | |
| 42 | {{code language="groovy"}} | ||
| 43 | dependencies { | ||
| 44 | implementation project(':react-native-mobigate') | ||
| 45 | } | ||
| 46 | {{/code}} | ||
| |
5.1 | 47 | * Add the MobigatePackage class to your list of exported packages into: android/app/src/main/.../MainApplication.java |
| |
4.1 | 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 | |||
| |
2.1 | 63 | = Api methods = |
| 64 | |||
| |
5.2 | 65 | To use any method from the plugin add import: |
| 66 | |||
| 67 | {{code language="javascript"}} | ||
| 68 | import Mobigate from 'react-native-mobigate' | ||
| 69 | {{/code}} | ||
| 70 | |||
| |
2.1 | 71 | == SDK initialization == |
| 72 | |||
| |
5.2 | 73 | You must initialize the library before running it. Use //init(apiKey, options, onSuccess, onError)// method for that: |
| 74 | |||
| 75 | **Mobigate.init(apiKey, options, onSuccess, onError)** | ||
| 76 | |||
| 77 | (% 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 | ||
| |
5.4 | 80 | |options|Json Object|SDK configuration |
| |
5.2 | 81 | |onSuccess|Function|returns callback object |
| 82 | |onError|Function|returns callback object | ||
| 83 | |||
| |
5.4 | 84 | Options |
| |
5.2 | 85 | |
| 86 | (% class="table-bordered table-hover" style="border-color:powderblue" %) | ||
| |
5.4 | 87 | |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description |
| 88 | | appIdentifier|String| | Application identifier | ||
| 89 | |appInstallationSource |String| | App installation source e.g., google-play, organic | ||
| 90 | |email |String | | Set's user email | ||
| 91 | |customUserId |String | | Set custom User Agent | ||
| 92 | | 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 | ||
| 93 | | dataGatherPolicy| Json Object| | Enable custom data gater policy. By default MobienceSDK gather all data it can read and hide notification icon.You can choose one of these states: "BLOCK_DATA_BG","HIDE_TRAY","DEFAULT" DODAĆ LINKA DO CONSTANTS| | | | ||
| 94 | | enableIdProfiles|Boolean |false | turns on / off the IDs profiles system | ||
| |
5.2 | 95 | |
| |
5.4 | 96 | DataGatherPolicy options |
| 97 | |||
| 98 | (% class="table-bordered table-hover" style="border-color:powderblue" %) | ||
| 99 | |=(% style="background-color:powderblue" %)Name|=(% style="background-color:powderblue" %)Type|=(% style="background-color:powderblue" %)Default|=(% style="background-color:powderblue" %)Description | ||
| 100 | | monitorState|String| | Application identifier | ||
| 101 | |notificationText|String| | App installation source e.g., google-play, organic | ||
| 102 | |||
| |
2.1 | 103 | == Tracking in app events == |
| 104 | |||
| 105 | == Remaining methods == | ||
| 106 | |||
| 107 | = Constants = | ||
| 108 | |||
| 109 | = Sample app = |