feat: added disable tracking for gdpr

README.md

@@ -265,6 +265,9 @@ _Questions? [Contact us](https://support.branch.io/support/tickets/new)_
     // for development and debugging only
     Branch.setDebug(true);
 
+    // for GDPR compliance (can be called at anytime)
+    Branch.disabledTracking(false);
+
     // for better Android matching
     Branch.setCookieBasedMatching("cordova.app.link");
 

src/android/io/branch/BranchSDK.java

@@ -112,6 +112,8 @@ public boolean execute(String action, JSONArray args, CallbackContext callbackCo
             if (args.length() == 1) {
                 cordova.getActivity().runOnUiThread(r);
             }
+        } else if (action.equals("disableTracking")) {
+            cordova.getActivity().runOnUiThread(r);
             return true;
         } else if (action.equals("initSession")) {
             cordova.getActivity().runOnUiThread(r);
@@ -591,6 +593,18 @@ private void setDebug(boolean isEnable, CallbackContext callbackContext)
         }
 
         callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, /* send boolean: false as the data */ isEnable));
+    /**
+     * <p>Disables tracking for GDPR compliance.</p>
+     * <p>Can flag at any time.</p>
+     * <p>Limits all Branch network requests and forces long link generation.</p>
+     *
+     * @param isEnable        A {@link Boolean} value to enable/disable debugging mode for the app.
+     * @param callbackContext A callback to execute at the end of this method
+     */
+    private void disableTracking(boolean isEnable, CallbackContext callbackContext) {
+        this.activity = this.cordova.getActivity();
+        Branch.getAutoInstance(this.activity.getApplicationContext()).disableTracking(isEnable);
+        callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, isEnable));
     }
 
     /**
@@ -1257,6 +1271,8 @@ public void run() {
             try {
                 if (this.action.equals("setDebug")) {
                     setDebug(this.args.getBoolean(0), this.callbackContext);
+                } else if (this.action.equals("disableTracking")) {
+                    disableTracking(this.args.getBoolean(0), this.callbackContext);
                 } else if (this.action.equals("initSession")) {
                     initSession(this.callbackContext);
                 } else if (this.action.equals("setRequestMetadata")) {

src/branch.js

@@ -49,10 +49,10 @@ Branch.prototype.disableGlobalListenersWarnings = function() {
   disableGlobalListenersWarnings = true;
 };
 
-Branch.prototype.setTrackingDisabled = function(isDisabled) {
-  var value = typeof isDisabled === "boolean" ? isDisabled : false;
+Branch.prototype.disableTracking = function(isEnabled) {
+  var value = typeof isEnabled === "boolean" ? isEnabled : false;
   this.trackingDisabled = value;
-  return execute("setTrackingDisabled", [value]);
+  return execute("disableTracking", [value]);
 };
 
 let runOnce = true;

src/ios/BranchSDK.h

@@ -28,7 +28,7 @@
 // BranchSDK Basic Methods
 - (void)initSession:(CDVInvokedUrlCommand*)command;
 - (void)setMixpanelToken:(CDVInvokedUrlCommand*)command;
-- (void)setTrackingDisabled:(CDVInvokedUrlCommand*)command;
+- (void)disableTracking:(CDVInvokedUrlCommand*)command;
 - (void)setDebug:(CDVInvokedUrlCommand*)command;
 - (void)getAutoInstance:(CDVInvokedUrlCommand*)command;
 - (void)getLatestReferringParams:(CDVInvokedUrlCommand*)command;

src/ios/BranchSDK.m

@@ -126,7 +126,7 @@ - (void)setRequestMetadata:(CDVInvokedUrlCommand*)command
 
 }
 
-- (void)setTrackingDisabled:(CDVInvokedUrlCommand*)command
+- (void)disableTracking:(CDVInvokedUrlCommand*)command
 {
 
   bool enabled = [[command.arguments objectAtIndex:0] boolValue] == YES;

testbed/www/js/index.js

@@ -10,7 +10,7 @@ const BranchInit = isDebug => {
   console.log("Trigger BranchInit()");
 
   // for GDPR compliance (can be called at anytime )
-  Branch.setTrackingDisabled(false);
+  Branch.disabledTracking(false);
 
   // for development and debugging only
   Branch.setDebug(isDebug);