Add push / registration methods; update readme and typescript defs; add tvOS support, update iOS and Android SDK; make podspec package.json driven; add fine grained in-app message control; add opt in / out tracking; add autolinking information; Expose iOS params that can be passed on Mixpanel instance initalization: trackCrashes, automaticPushTracking, launchOptions; add Changelog (davide-scalzo#180)

* Update Android SDK to 5.6.0

* Lock iOS podspec to 3.4.4

* Updater package

* Update Readme

* Change implementation to api within gradle build

* Update iOS Mixpanel to 3.4.5

* Lock iOS podspec to 3.4.5

* Update npm version

* Update gitignore - add prefs and vsc project

* Update index.d.ts - add clearSuperProperties

* Add support for clearing a single registration id on Android

* Udpate index.d.ts

* [iOS] Pass deviceToken as string to `removePushDeviceToken` as it's convinient way to de-register iOS device

* Update readme

* Update npm version

* Update README.md

* [Android] Retrieves current Firebase Cloud Messaging token

* Update readme.md and index.d.ts

* [Android] Add getPushRegistrationId

* Add missing definition

* Update README.md

* Update definitions and error messages

* Update Android SDK to 5.6.3

* Update iOS podspec to 3.4.7

* Update npm version

* Update dependencies version

* [iOS] Podspec should take velues from package.json

* Added support for tvOS

* Add append method; update readme.md

* Update Mixpanel.h

* Added fine grained in-app message control

* Add Opting Out / In

The later versions of Mixpanel have the ability to opt in/out of collecting data for GDPR purposes. This adds support for those as well as updating the Mixpanel library.

* Update version

* Update doc

* Add information about Autolinking

* Add missing Platform import

* Update readme; add changelog

* Expose iOS params that can be passed on Mixpanel instance initalization: trackCrashes, automaticPushTracking, launchOptions

* Fix typo

Author: lorenc-tomasz

.gitignore

@@ -34,3 +34,5 @@ local.properties
 #
 node_modules/
 npm-debug.log
+*.prefs
+android/.project

CHANGELOG.md

@@ -0,0 +1,22 @@
+# 1.1.10
+
+- Fix typo
+
+# 1.1.9
+
+- Expose iOS params that can be passed on Mixpanel instance initalization: trackCrashes, automaticPushTracking, launchOptions
+- Update Typescript defs and readme
+
+# 1.1.8
+
+- Add support for AppleTV
+- Add information about Autolinking from RN >= 0.60
+- Update podspec to be package.json driven
+- Add fine grained in-app message control
+- Update iOS SDK to 3.5.0
+- Update Android SDK to 5.6.5
+- Add opt in / opt out tracking option
+- Add push / registration methods
+- Update README
+- Update Typescript defs
+- Fix crash on clearPushRegistrationId

README.md

@@ -24,6 +24,12 @@ From version 1.1.2 module uses Mixpanel SDK >= 5.6.0 that requires FCM
 - Allow sub-classes to override push notifications payload and Support when more than one push provider is used [more info here](https://github.com/mixpanel/mixpanel-android/releases/tag/v5.5.1)
 
 
+# Autolinking and RN >= 0.60
+
+Autolinking should work out of the box.
+
+Remember to do: pod install.
+
 # Manual Installation
 
 ## Installation iOS ##
@@ -81,12 +87,48 @@ public class MainActivity extends ReactActivity {
 # Usage
 
 ```js
-//Require the module
+// Require the module
 var Mixpanel = require('react-native-mixpanel');
 
-//Init Mixpanel SDK with your project token
+// Init Mixpanel SDK with your project token
+//  @param apiToken - your project token
 Mixpanel.sharedInstanceWithToken(YOUR_PROJECT_TOKEN);
 
+// You can also opt out tracking by default (GDPR)
+//  @param apiToken - your project token
+//  @param optOutTrackingByDefault - whether or not to be opted out from tracking by default (default value: false)
+Mixpanel.sharedInstanceWithToken(YOUR_PROJECT_TOKEN, false);
+
+// You can also disable trackCrashes
+//  @param apiToken - your project token
+//  @param optOutTrackingByDefault - whether or not to be opted out from tracking by default (default value: false)
+//  @param trackCrashes (iOS only!) - whether or not to track crashes in Mixpanel. may want to disable if you're seeing  issues with your crash reporting for either signals or exceptions (default value: true)
+Mixpanel.sharedInstanceWithToken(YOUR_PROJECT_TOKEN, false, true);
+
+// You can also disable automaticPushTracking
+//  @param apiToken - your project token
+//  @param optOutTrackingByDefault - whether or not to be opted out from tracking by default (default value: false)
+//  @param trackCrashes (iOS only!) - whether or not to track crashes in Mixpanel. may want to disable if you're seeing  issues with your crash reporting for either signals or exceptions (default value: true)
+//  @param automaticPushTracking (iOS only!) - whether or not to automatically track pushes sent from Mixpanel (default value: true)
+Mixpanel.sharedInstanceWithToken(YOUR_PROJECT_TOKEN, false, true, true);
+
+// You can also pass launchOptions
+//  @param apiToken - your project token
+//  @param optOutTrackingByDefault - whether or not to be opted out from tracking by default (default value: false)
+//  @param trackCrashes (iOS only!) - whether or not to track crashes in Mixpanel. may want to disable if you're seeing  issues with your crash reporting for either signals or exceptions (default value: true)
+//  @param automaticPushTracking (iOS only!) - whether or not to automatically track pushes sent from Mixpanel (default value: true)
+//  @param launchOptions (iOS only!) - your application delegate's launchOptions (default value: null)
+Mixpanel.sharedInstanceWithToken(YOUR_PROJECT_TOKEN, false, true, true, null);
+
+// Opt in tracking.
+// Use this method to opt in an already opted out user from tracking. People updates and track calls will be sent to Mixpanel after using this method.
+Mixpanel.optInTracking();
+
+//  Opt out tracking.
+
+//  This method is used to opt out tracking. This causes all events and people request no longer to be sent back to the Mixpanel server.
+Mixpanel.optOutTracking();
+
 //Send and event name with no properties
 Mixpanel.track("Event name");
 
@@ -126,19 +168,78 @@ Mixpanel.trackChargeWithProperties(399, {"product": "ACME Wearable tech"});
 // increment property
 Mixpanel.increment("Login Count", 1);
 
+// Append array to a list property
+Mixpanel.append("Lines", ["Simple", "Dashed"]);
+
+// Merge array to a list property, excluding duplicate values
+Mixpanel.union("Lines", ["Dashed", "Custom"]);
+
+// Android
+// Retrieves current Firebase Cloud Messaging token.
+// Should only be called after identify(String) has been called.
+Mixpanel.getPushRegistrationId();
+
 // send push notifications token to Mixpanel
 // Android
 Mixpanel.setPushRegistrationId("GCM/FCM push token");
 
-//tell Mixpanel which user record in People Analytics should receive the messages when they are sent from the Mixpanel app,
-//make sure you call this right after you call `identify`
+// Android
+// tell Mixpanel which user record in People Analytics should receive the messages when they are sent from the Mixpanel app,
+// make sure you call this right after you call `identify`
+// Deprecated. 
+// in 5.5.0. Google Cloud Messaging (GCM) is now deprecated by Google. To enable end-to-end Firebase Cloud Messaging (FCM) from Mixpanel you only need to add the following to your application manifest XML file:
+
+ 
+//  <service
+//        android:name="com.mixpanel.android.mpmetrics.MixpanelFCMMessagingService"
+//        android:enabled="true"
+//        android:exported="false">
+//        <intent-filter>
+//            <action android:name="com.google.firebase.MESSAGING_EVENT"/>
+//        </intent-filter>
+//  </service>
+ 
+ 
+
+// Make sure you have a valid google-services.json file in your project and firebase messaging is included as a dependency. Example:
+
+ 
+//  buildscript {
+//       ...
+//       dependencies {
+//           classpath 'com.google.gms:google-services:4.1.0'
+//           ...
+//       }
+//  }
+
+//  dependencies {
+//      implementation 'com.google.firebase:firebase-messaging:17.3.4'
+//      implementation 'com.mixpanel.android:mixpanel-android:5.5.0'
+//  }
+
+//  apply plugin: 'com.google.gms.google-services'
+
+// We recommend you update your Server Key on mixpanel.com from your Firebase console. Legacy server keys are still supported.
 Mixpanel.initPushHandling(YOUR_12_DIGIT_GOOGLE_SENDER_ID);
 
-//unregister a device for push notifications
-Mixpanel.clearPushRegistrationId();
+// Allows to clear super properites
+Mixpabel.clearSuperProperties();
+
+// Android
+// Unregister an android device for push notifications
+// With token it will clear a single Firebase Cloud Messaging token from Mixpanel.
+// Without token it will clear all current Firebase Cloud Messaging tokens from Mixpanel.
+Mixpanel.clearPushRegistrationId(token?: string); 
+
+// iOS
+Mixpanel.addPushDeviceToken("APNS push token");
+
+// iOS - unregister iOS device, pushDeviceToken = APNS push token
+Mixpanel.removePushDeviceToken(pushDeviceToken: string); 
 
 // iOS
-Mixpanel.addPushDeviceToken("APNS push token")
+// Unregister the given device to receive push notifications.
+Mixpanel.removeAllPushDeviceTokens();
 
 // Mixpanel reset method (warning: it will also generate a new unique id and call the identify method with it. Thus, the user will not be anonymous in Mixpanel.)
 Mixpanel.reset();
@@ -148,5 +249,31 @@ Mixpanel.reset();
 Mixpanel.getDistinctId(function(id){})
 ```
 
+## Displaying in-app messages ##
+
+By default, in-app messages are shown to users when the app starts and a message is available to display
+This behaviour can be disabled by default, and explicitally triggered at a later time (e.g. after your loading sequence)
+
+For iOS, in your app delegate, add the following line:
+
+```
+// In application:didFinishLaunchingWithOptions:
+Mixpanel *mixpanel = [Mixpanel sharedInstanceWithToken:YOUR_MIXPANEL_TOKEN];
+// Turn this off so the message doesn't pop up automatically.
+mixpanel.showNotificationOnActive = NO;
+```
+
+For Android, add the following to your app mainifest in the `<application>` tag:
+
+```
+<meta-data android:name="com.mixpanel.android.MPConfig.AutoShowMixpanelUpdates" android:value="false" />
+```
+
+You can then call the following in your react native application:
+
+```
+Mixpanel.showInAppMessageIfAvailable();
+```
+
 ## Notes ##
 For more info please have a look at the [official Mixpanel reference](https://mixpanel.com/help/reference/ios) for iOS

RNMixpanel.xcodeproj/project.pbxproj

@@ -38,6 +38,7 @@
 
 /* Begin PBXFileReference section */
 		5EAEEA411F0555B100C6FED8 /* libRNMixpanel-tvOS.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = "libRNMixpanel-tvOS.a"; sourceTree = BUILT_PRODUCTS_DIR; };
+		E78DD5BC2364BED0009197B6 /* MixpanelPeople.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = MixpanelPeople.h; sourceTree = "<group>"; };
 		FDC64AF01BF1690D0044C1B4 /* libRNMixpanel.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libRNMixpanel.a; sourceTree = BUILT_PRODUCTS_DIR; };
 		FDC64AF31BF1690D0044C1B4 /* RNMixpanel.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = RNMixpanel.h; sourceTree = "<group>"; };
 		FDC64AF51BF1690D0044C1B4 /* RNMixpanel.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = RNMixpanel.m; sourceTree = "<group>"; };
@@ -86,6 +87,7 @@
 		FDC64AF21BF1690D0044C1B4 /* RNMixpanel */ = {
 			isa = PBXGroup;
 			children = (
+				E78DD5BC2364BED0009197B6 /* MixpanelPeople.h */,
 				FDDAC2A11BF2B66500E70D3C /* Mixpanel.h */,
 				FDC64AF31BF1690D0044C1B4 /* RNMixpanel.h */,
 				FDC64AF51BF1690D0044C1B4 /* RNMixpanel.m */,
@@ -153,6 +155,7 @@
 			developmentRegion = English;
 			hasScannedForEncodings = 0;
 			knownRegions = (
+				English,
 				en,
 			);
 			mainGroup = FDC64AE71BF1690D0044C1B4;