mixpanel-browser 2.46.0 → 2.48.0

package/doc/readme.io/javascript-full-api-reference.md

@@ -262,7 +262,7 @@ mixpanel.library_name.track(...);
 | Argument | Type | Description |
 | ------------- | ------------- | ----- |
 | **token** | <span class="mp-arg-type">String</span></br></span><span class="mp-arg-required">required</span> | Your Mixpanel API token |
-| **config** | <span class="mp-arg-type">Object</span></br></span><span class="mp-arg-optional">optional</span> | A dictionary of config options to override. <a href="https://github.com/mixpanel/mixpanel-js/blob/8b2e1f7b/src/mixpanel-core.js#L87-L110">See a list of default config options</a>. |
+| **config** | <span class="mp-arg-type">Object</span></br></span><span class="mp-arg-optional">optional</span> | A dictionary of config options to override. <a href="https://github.com/mixpanel/mixpanel-js/blob/v2.46.0/src/mixpanel-core.js#L88-L127">See a list of default config options</a>. |
 | **name** | <span class="mp-arg-type">String</span></br></span><span class="mp-arg-optional">optional</span> | The name for the new mixpanel instance that you want created |
 
 
@@ -523,10 +523,20 @@ The default config is:
   // secure, meaning they will only be transmitted over https
   secure_cookie: false
 
+  // disables enriching user profiles with first touch marketing data
+  skip_first_touch_marketing: false
+
   // the amount of time track_links will
   // wait for Mixpanel's servers to respond
   track_links_timeout: 300
 
+  // adds any UTM parameters and click IDs present on the page to any events fired
+  track_marketing: true
+
+  // enables automatic page view tracking using default page view events through
+  // the track_pageview() method
+  track_pageview: false
+
   // if you set upgrade to be true, the library will check for
   // a cookie from our old js library and import super
   // properties from it, then the old cookie is deleted
@@ -684,6 +694,26 @@ If you pass a function in as the properties argument, the  function will receive
 | **properties** | <span class="mp-arg-type">Object or Function</span></br></span><span class="mp-arg-optional">optional</span> | A properties object or function that returns a dictionary of properties when passed a DOMElement |
 
 
+___
+## mixpanel.track_pageview
+Track a default Mixpanel page view event, which includes extra default event properties to  improve page view data. The <code>config.track_pageview</code> option for <a href="#mixpanelinit">mixpanel.init()</a>  may be turned on for tracking page loads automatically.
+
+
+
+
+| Argument | Type | Description |
+| ------------- | ------------- | ----- |
+| **properties** | <span class="mp-arg-type">Object</span></br></span><span class="mp-arg-optional">optional</span> | An optional set of additional properties to send with the page view event |
+| **options** | <span class="mp-arg-type">Object</span></br></span><span class="mp-arg-optional">optional</span> | Page view tracking options |
+| **options.event_name** | <span class="mp-arg-type">String</span></br></span><span class="mp-arg-optional">optional</span> | <ul>
+<li>Alternate name for the tracking event</li>
+</ul> |
+#### Returns:
+| Type | Description |
+| ----- | ------------- |
+| <span class="mp-arg-type">Boolean or Object</span> | If the tracking request was successfully initiated/queued, an object with the tracking payload sent to the API server is returned; otherwise false. |
+
+
 ___
 ## mixpanel.track_with_groups
 Track an event with specific groups.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mixpanel-browser",
-  "version": "2.46.0",
+  "version": "2.48.0",
   "description": "The official Mixpanel JavaScript browser client library",
   "main": "dist/mixpanel.cjs.js",
   "directories": {

package/src/config.js

@@ -1,6 +1,6 @@
 var Config = {
     DEBUG: false,
-    LIB_VERSION: '2.46.0'
+    LIB_VERSION: '2.48.0'
 };
 
 export default Config;

package/src/mixpanel-core.js

@@ -81,11 +81,18 @@ if (navigator['sendBeacon']) {
     };
 }
 
+var DEFAULT_API_ROUTES = {
+    'track': 'track/',
+    'engage': 'engage/',
+    'groups': 'groups/'
+};
+
 /*
  * Module-level globals
  */
 var DEFAULT_CONFIG = {
     'api_host':                          'https://api-js.mixpanel.com',
+    'api_routes':                        DEFAULT_API_ROUTES,
     'api_method':                        'POST',
     'api_transport':                     'XHR',
     'api_payload_format':                PAYLOAD_TYPE_BASE64,
@@ -99,6 +106,9 @@ var DEFAULT_CONFIG = {
     'cookie_domain':                     '',
     'cookie_name':                       '',
     'loaded':                            NOOP_FUNC,
+    'track_marketing':                   true,
+    'track_pageview':                    false,
+    'skip_first_touch_marketing':        false,
     'store_google':                      true,
     'save_referrer':                     true,
     'test':                              false,
@@ -165,6 +175,25 @@ var create_mplib = function(token, config, name) {
     instance['people'] = new MixpanelPeople();
     instance['people']._init(instance);
 
+    if (!instance.get_config('skip_first_touch_marketing')) {
+        // We need null UTM params in the object because
+        // UTM parameters act as a tuple. If any UTM param
+        // is present, then we set all UTM params including
+        // empty ones together
+        var utm_params = _.info.campaignParams(null);
+        var initial_utm_params = {};
+        var has_utm = false;
+        _.each(utm_params, function(utm_value, utm_key) {
+            initial_utm_params['initial_' + utm_key] = utm_value;
+            if (utm_value) {
+                has_utm = true;
+            }
+        });
+        if (has_utm) {
+            instance['people'].set_once(initial_utm_params);
+        }
+    }
+
     // if any instance on the page has debug = true, we set the
     // global debug to be true
     Config.DEBUG = Config.DEBUG || instance.get_config('debug');
@@ -196,7 +225,7 @@ var create_mplib = function(token, config, name) {
  *     mixpanel.library_name.track(...);
  *
  * @param {String} token   Your Mixpanel API token
- * @param {Object} [config]  A dictionary of config options to override. <a href="https://github.com/mixpanel/mixpanel-js/blob/8b2e1f7b/src/mixpanel-core.js#L87-L110">See a list of default config options</a>.
+ * @param {Object} [config]  A dictionary of config options to override. <a href="https://github.com/mixpanel/mixpanel-js/blob/v2.46.0/src/mixpanel-core.js#L88-L127">See a list of default config options</a>.
  * @param {String} [name]    The name for the new mixpanel instance that you want created
  */
 MixpanelLib.prototype.init = function (token, config, name) {
@@ -234,7 +263,7 @@ MixpanelLib.prototype._init = function(token, config, name) {
     // default to JSON payload for standard mixpanel.com API hosts
     if (!('api_payload_format' in config)) {
         var api_host = config['api_host'] || DEFAULT_CONFIG['api_host'];
-        if (api_host.match(/\.mixpanel\.com$/)) {
+        if (api_host.match(/\.mixpanel\.com/)) {
             variable_features['api_payload_format'] = PAYLOAD_TYPE_JSON;
         }
     }
@@ -262,6 +291,10 @@ MixpanelLib.prototype._init = function(token, config, name) {
         if (!_.localStorage.is_supported(true) || !USE_XHR) {
             this._batch_requests = false;
             console.log('Turning off Mixpanel request-queueing; needs XHR and localStorage support');
+            _.each(this.get_batcher_configs(), function(batcher_config) {
+                console.log('Clearing batch queue ' + batcher_config.queue_key);
+                _.localStorage.remove(batcher_config.queue_key);
+            });
         } else {
             this.init_batchers();
             if (sendBeacon && window.addEventListener) {
@@ -309,6 +342,10 @@ MixpanelLib.prototype._init = function(token, config, name) {
             '$device_id': uuid
         }, '');
     }
+
+    if (this.get_config('track_pageview')) {
+        this.track_pageview();
+    }
 };
 
 // Private methods
@@ -322,7 +359,7 @@ MixpanelLib.prototype._loaded = function() {
 MixpanelLib.prototype._set_default_superprops = function() {
     this['persistence'].update_search_keyword(document.referrer);
     if (this.get_config('store_google')) {
-        this['persistence'].update_campaign_params();
+        this.register(_.info.campaignParams(), {persistent: false});
     }
     if (this.get_config('save_referrer')) {
         this['persistence'].update_referrer_info(document.referrer);
@@ -605,12 +642,22 @@ MixpanelLib.prototype.are_batchers_initialized = function() {
     return !!this.request_batchers.events;
 };
 
+MixpanelLib.prototype.get_batcher_configs = function() {
+    var queue_prefix = '__mpq_' + this.get_config('token');
+    var api_routes = this.get_config('api_routes');
+    this._batcher_configs = this._batcher_configs || {
+        events: {type: 'events', endpoint: '/' + api_routes['track'], queue_key: queue_prefix + '_ev'},
+        people: {type: 'people', endpoint: '/' + api_routes['engage'], queue_key: queue_prefix + '_pp'},
+        groups: {type: 'groups', endpoint: '/' + api_routes['groups'], queue_key: queue_prefix + '_gr'}
+    };
+    return this._batcher_configs;
+};
+
 MixpanelLib.prototype.init_batchers = function() {
-    var token = this.get_config('token');
     if (!this.are_batchers_initialized()) {
         var batcher_for = _.bind(function(attrs) {
             return new RequestBatcher(
-                '__mpq_' + token + attrs.queue_suffix,
+                attrs.queue_key,
                 {
                     libConfig: this['config'],
                     sendRequestFunc: _.bind(function(data, options, cb) {
@@ -629,10 +676,11 @@ MixpanelLib.prototype.init_batchers = function() {
                 }
             );
         }, this);
+        var batcher_configs = this.get_batcher_configs();
         this.request_batchers = {
-            events: batcher_for({type: 'events', endpoint: '/track/', queue_suffix: '_ev'}),
-            people: batcher_for({type: 'people', endpoint: '/engage/', queue_suffix: '_pp'}),
-            groups: batcher_for({type: 'groups', endpoint: '/groups/', queue_suffix: '_gr'})
+            events: batcher_for(batcher_configs.events),
+            people: batcher_for(batcher_configs.people),
+            groups: batcher_for(batcher_configs.groups)
         };
     }
     if (this.get_config('batch_autostart')) {
@@ -641,6 +689,7 @@ MixpanelLib.prototype.init_batchers = function() {
 };
 
 MixpanelLib.prototype.start_batch_senders = function() {
+    this._batchers_were_started = true;
     if (this.are_batchers_initialized()) {
         this._batch_requests = true;
         _.each(this.request_batchers, function(batcher) {
@@ -792,7 +841,7 @@ MixpanelLib.prototype.track = addOptOutCheckMixpanelLib(function(event_name, pro
     }
 
     // set defaults
-    properties = properties || {};
+    properties = _.extend({}, properties);
     properties['token'] = this.get_config('token');
 
     // set $duration if time_event was previously called for this event
@@ -804,6 +853,10 @@ MixpanelLib.prototype.track = addOptOutCheckMixpanelLib(function(event_name, pro
 
     this._set_default_superprops();
 
+    var marketing_properties = this.get_config('track_marketing')
+        ? _.info.marketingParams()
+        : {};
+
     // note: extend writes to the first object, so lets make sure we
     // don't write to the persistence properties object and info
     // properties object by passing in a new object
@@ -812,6 +865,7 @@ MixpanelLib.prototype.track = addOptOutCheckMixpanelLib(function(event_name, pro
     properties = _.extend(
         {},
         _.info.properties(),
+        marketing_properties,
         this['persistence'].properties(),
         this.unpersisted_superprops,
         properties
@@ -833,7 +887,7 @@ MixpanelLib.prototype.track = addOptOutCheckMixpanelLib(function(event_name, pro
     var ret = this._track_or_batch({
         type: 'events',
         data: data,
-        endpoint: this.get_config('api_host') + '/track/',
+        endpoint: this.get_config('api_host') + '/' + this.get_config('api_routes')['track'],
         batcher: this.request_batchers.events,
         should_send_immediately: should_send_immediately,
         send_request_options: options
@@ -879,13 +933,14 @@ MixpanelLib.prototype.set_group = addOptOutCheckMixpanelLib(function(group_key,
  */
 MixpanelLib.prototype.add_group = addOptOutCheckMixpanelLib(function(group_key, group_id, callback) {
     var old_values = this.get_property(group_key);
+    var prop = {};
     if (old_values === undefined) {
-        var prop = {};
         prop[group_key] = [group_id];
         this.register(prop);
     } else {
         if (old_values.indexOf(group_id) === -1) {
             old_values.push(group_id);
+            prop[group_key] = old_values;
             this.register(prop);
         }
     }
@@ -972,17 +1027,54 @@ MixpanelLib.prototype.get_group = function (group_key, group_id) {
 };
 
 /**
- * Track mp_page_view event. This is now ignored by the server.
+ * Track a default Mixpanel page view event, which includes extra default event properties to
+ * improve page view data. The `config.track_pageview` option for <a href="#mixpanelinit">mixpanel.init()</a>
+ * may be turned on for tracking page loads automatically.
  *
- * @param {String} [page] The url of the page to record. If you don't include this, it defaults to the current url.
- * @deprecated
+ * ### Usage
+ *
+ *     // track a default $mp_web_page_view event
+ *     mixpanel.track_pageview();
+ *
+ *     // track a page view event with additional event properties
+ *     mixpanel.track_pageview({'ab_test_variant': 'card-layout-b'});
+ *
+ *     // example approach to track page views on different page types as event properties
+ *     mixpanel.track_pageview({'page': 'pricing'});
+ *     mixpanel.track_pageview({'page': 'homepage'});
+ *
+ *     // UNCOMMON: Tracking a page view event with a custom event_name option. NOT expected to be used for
+ *     // individual pages on the same site or product. Use cases for custom event_name may be page
+ *     // views on different products or internal applications that are considered completely separate
+ *     mixpanel.track_pageview({'page': 'customer-search'}, {'event_name': '[internal] Admin Page View'});
+ *
+ * @param {Object} [properties] An optional set of additional properties to send with the page view event
+ * @param {Object} [options] Page view tracking options
+ * @param {String} [options.event_name] - Alternate name for the tracking event
+ * @returns {Boolean|Object} If the tracking request was successfully initiated/queued, an object
+ * with the tracking payload sent to the API server is returned; otherwise false.
  */
-MixpanelLib.prototype.track_pageview = function(page) {
-    if (_.isUndefined(page)) {
-        page = document.location.href;
+MixpanelLib.prototype.track_pageview = addOptOutCheckMixpanelLib(function(properties, options) {
+    if (typeof properties !== 'object') {
+        properties = {};
     }
-    this.track('mp_page_view', _.info.pageviewInfo(page));
-};
+    options = options || {};
+    var event_name = options['event_name'] || '$mp_web_page_view';
+
+    var default_page_properties = _.extend(
+        _.info.mpPageViewProperties(),
+        _.info.campaignParams(),
+        _.info.clickParams()
+    );
+
+    var event_properties = _.extend(
+        {},
+        default_page_properties,
+        properties
+    );
+
+    return this.track(event_name, event_properties);
+});
 
 /**
  * Track clicks on a set of document elements. Selector must be a
@@ -1393,6 +1485,16 @@ MixpanelLib.prototype.name_tag = function(name_tag) {
  * The default config is:
  *
  *     {
+ *       // host for requests (customizable for e.g. a local proxy)
+ *       api_host: 'https://api-js.mixpanel.com',
+ *
+ *       // endpoints for different types of requests
+ *       api_routes: {
+ *         track: 'track/',
+ *         engage: 'engage/',
+ *         groups: 'groups/',
+ *       }
+ *
  *       // HTTP method for tracking requests
  *       api_method: 'POST'
  *
@@ -1478,10 +1580,20 @@ MixpanelLib.prototype.name_tag = function(name_tag) {
  *       // secure, meaning they will only be transmitted over https
  *       secure_cookie: false
  *
+ *       // disables enriching user profiles with first touch marketing data
+ *       skip_first_touch_marketing: false
+ *
  *       // the amount of time track_links will
  *       // wait for Mixpanel's servers to respond
  *       track_links_timeout: 300
  *
+ *       // adds any UTM parameters and click IDs present on the page to any events fired
+ *       track_marketing: true
+ *
+ *       // enables automatic page view tracking using default page view events through
+ *       // the track_pageview() method
+ *       track_pageview: false
+ *
  *       // if you set upgrade to be true, the library will check for
  *       // a cookie from our old js library and import super
  *       // properties from it, then the old cookie is deleted
@@ -1566,7 +1678,7 @@ MixpanelLib.prototype._run_hook = function(hook_name) {
  * @param {String} property_name The name of the super property you want to retrieve
  */
 MixpanelLib.prototype.get_property = function(property_name) {
-    return this['persistence']['props'][property_name];
+    return this['persistence'].load_prop([property_name]);
 };
 
 MixpanelLib.prototype.toString = function() {
@@ -1639,9 +1751,13 @@ MixpanelLib.prototype._gdpr_update_persistence = function(options) {
     }
 
     if (disabled) {
-        _.each(this.request_batchers, function(batcher) {
-            batcher.clear();
-        });
+        this.stop_batch_senders();
+    } else {
+        // only start batchers after opt-in if they have previously been started
+        // in order to avoid unintentionally starting up batching for the first time
+        if (this._batchers_were_started) {
+            this.start_batch_senders();
+        }
     }
 };
 
@@ -1843,37 +1959,38 @@ MixpanelLib.prototype.report_error = function(msg, err) {
 // EXPORTS (for closure compiler)
 
 // MixpanelLib Exports
-MixpanelLib.prototype['init']                               = MixpanelLib.prototype.init;
-MixpanelLib.prototype['reset']                              = MixpanelLib.prototype.reset;
-MixpanelLib.prototype['disable']                            = MixpanelLib.prototype.disable;
-MixpanelLib.prototype['time_event']                         = MixpanelLib.prototype.time_event;
-MixpanelLib.prototype['track']                              = MixpanelLib.prototype.track;
-MixpanelLib.prototype['track_links']                        = MixpanelLib.prototype.track_links;
-MixpanelLib.prototype['track_forms']                        = MixpanelLib.prototype.track_forms;
-MixpanelLib.prototype['track_pageview']                     = MixpanelLib.prototype.track_pageview;
-MixpanelLib.prototype['register']                           = MixpanelLib.prototype.register;
-MixpanelLib.prototype['register_once']                      = MixpanelLib.prototype.register_once;
-MixpanelLib.prototype['unregister']                         = MixpanelLib.prototype.unregister;
-MixpanelLib.prototype['identify']                           = MixpanelLib.prototype.identify;
-MixpanelLib.prototype['alias']                              = MixpanelLib.prototype.alias;
-MixpanelLib.prototype['name_tag']                           = MixpanelLib.prototype.name_tag;
-MixpanelLib.prototype['set_config']                         = MixpanelLib.prototype.set_config;
-MixpanelLib.prototype['get_config']                         = MixpanelLib.prototype.get_config;
-MixpanelLib.prototype['get_property']                       = MixpanelLib.prototype.get_property;
-MixpanelLib.prototype['get_distinct_id']                    = MixpanelLib.prototype.get_distinct_id;
-MixpanelLib.prototype['toString']                           = MixpanelLib.prototype.toString;
-MixpanelLib.prototype['opt_out_tracking']                   = MixpanelLib.prototype.opt_out_tracking;
-MixpanelLib.prototype['opt_in_tracking']                    = MixpanelLib.prototype.opt_in_tracking;
-MixpanelLib.prototype['has_opted_out_tracking']             = MixpanelLib.prototype.has_opted_out_tracking;
-MixpanelLib.prototype['has_opted_in_tracking']              = MixpanelLib.prototype.has_opted_in_tracking;
-MixpanelLib.prototype['clear_opt_in_out_tracking']          = MixpanelLib.prototype.clear_opt_in_out_tracking;
-MixpanelLib.prototype['get_group']                          = MixpanelLib.prototype.get_group;
-MixpanelLib.prototype['set_group']                          = MixpanelLib.prototype.set_group;
-MixpanelLib.prototype['add_group']                          = MixpanelLib.prototype.add_group;
-MixpanelLib.prototype['remove_group']                       = MixpanelLib.prototype.remove_group;
-MixpanelLib.prototype['track_with_groups']                  = MixpanelLib.prototype.track_with_groups;
-MixpanelLib.prototype['start_batch_senders']                = MixpanelLib.prototype.start_batch_senders;
-MixpanelLib.prototype['stop_batch_senders']                 = MixpanelLib.prototype.stop_batch_senders;
+MixpanelLib.prototype['init']                      = MixpanelLib.prototype.init;
+MixpanelLib.prototype['reset']                     = MixpanelLib.prototype.reset;
+MixpanelLib.prototype['disable']                   = MixpanelLib.prototype.disable;
+MixpanelLib.prototype['time_event']                = MixpanelLib.prototype.time_event;
+MixpanelLib.prototype['track']                     = MixpanelLib.prototype.track;
+MixpanelLib.prototype['track_links']               = MixpanelLib.prototype.track_links;
+MixpanelLib.prototype['track_forms']               = MixpanelLib.prototype.track_forms;
+MixpanelLib.prototype['track_pageview']            = MixpanelLib.prototype.track_pageview;
+MixpanelLib.prototype['register']                  = MixpanelLib.prototype.register;
+MixpanelLib.prototype['register_once']             = MixpanelLib.prototype.register_once;
+MixpanelLib.prototype['unregister']                = MixpanelLib.prototype.unregister;
+MixpanelLib.prototype['identify']                  = MixpanelLib.prototype.identify;
+MixpanelLib.prototype['alias']                     = MixpanelLib.prototype.alias;
+MixpanelLib.prototype['name_tag']                  = MixpanelLib.prototype.name_tag;
+MixpanelLib.prototype['set_config']                = MixpanelLib.prototype.set_config;
+MixpanelLib.prototype['get_config']                = MixpanelLib.prototype.get_config;
+MixpanelLib.prototype['get_property']              = MixpanelLib.prototype.get_property;
+MixpanelLib.prototype['get_distinct_id']           = MixpanelLib.prototype.get_distinct_id;
+MixpanelLib.prototype['toString']                  = MixpanelLib.prototype.toString;
+MixpanelLib.prototype['opt_out_tracking']          = MixpanelLib.prototype.opt_out_tracking;
+MixpanelLib.prototype['opt_in_tracking']           = MixpanelLib.prototype.opt_in_tracking;
+MixpanelLib.prototype['has_opted_out_tracking']    = MixpanelLib.prototype.has_opted_out_tracking;
+MixpanelLib.prototype['has_opted_in_tracking']     = MixpanelLib.prototype.has_opted_in_tracking;
+MixpanelLib.prototype['clear_opt_in_out_tracking'] = MixpanelLib.prototype.clear_opt_in_out_tracking;
+MixpanelLib.prototype['get_group']                 = MixpanelLib.prototype.get_group;
+MixpanelLib.prototype['set_group']                 = MixpanelLib.prototype.set_group;
+MixpanelLib.prototype['add_group']                 = MixpanelLib.prototype.add_group;
+MixpanelLib.prototype['remove_group']              = MixpanelLib.prototype.remove_group;
+MixpanelLib.prototype['track_with_groups']         = MixpanelLib.prototype.track_with_groups;
+MixpanelLib.prototype['start_batch_senders']       = MixpanelLib.prototype.start_batch_senders;
+MixpanelLib.prototype['stop_batch_senders']        = MixpanelLib.prototype.stop_batch_senders;
+MixpanelLib.prototype['DEFAULT_API_ROUTES']        = DEFAULT_API_ROUTES;
 
 // MixpanelPersistence Exports
 MixpanelPersistence.prototype['properties']            = MixpanelPersistence.prototype.properties;

package/src/mixpanel-group.js

@@ -146,7 +146,7 @@ MixpanelGroup.prototype._send_request = function(data, callback) {
     return this._mixpanel._track_or_batch({
         type: 'groups',
         data: date_encoded_data,
-        endpoint: this._get_config('api_host') + '/groups/',
+        endpoint: this._get_config('api_host') + '/' +  this._get_config('api_routes')['groups'],
         batcher: this._mixpanel.request_batchers.groups
     }, callback);
 };

package/src/mixpanel-people.js

@@ -348,7 +348,7 @@ MixpanelPeople.prototype._send_request = function(data, callback) {
     return this._mixpanel._track_or_batch({
         type: 'people',
         data: date_encoded_data,
-        endpoint: this._get_config('api_host') + '/engage/',
+        endpoint: this._get_config('api_host') + '/' +  this._get_config('api_routes')['engage'],
         batcher: this._mixpanel.request_batchers.people
     }, callback);
 };
@@ -384,11 +384,12 @@ MixpanelPeople.prototype._enqueue = function(data) {
 
 MixpanelPeople.prototype._flush_one_queue = function(action, action_method, callback, queue_to_params_fn) {
     var _this = this;
-    var queued_data = _.extend({}, this._mixpanel['persistence']._get_queue(action));
+    var queued_data = _.extend({}, this._mixpanel['persistence'].load_queue(action));
     var action_params = queued_data;
 
     if (!_.isUndefined(queued_data) && _.isObject(queued_data) && !_.isEmptyObject(queued_data)) {
         _this._mixpanel['persistence']._pop_from_people_queue(action, queued_data);
+        _this._mixpanel['persistence'].save();
         if (queue_to_params_fn) {
             action_params = queue_to_params_fn(queued_data);
         }
@@ -410,8 +411,6 @@ MixpanelPeople.prototype._flush = function(
     _set_callback, _add_callback, _append_callback, _set_once_callback, _union_callback, _unset_callback, _remove_callback
 ) {
     var _this = this;
-    var $append_queue = this._mixpanel['persistence']._get_queue(APPEND_ACTION);
-    var $remove_queue = this._mixpanel['persistence']._get_queue(REMOVE_ACTION);
 
     this._flush_one_queue(SET_ACTION, this.set, _set_callback);
     this._flush_one_queue(SET_ONCE_ACTION, this.set_once, _set_once_callback);
@@ -421,6 +420,7 @@ MixpanelPeople.prototype._flush = function(
 
     // we have to fire off each $append individually since there is
     // no concat method server side
+    var $append_queue = this._mixpanel['persistence'].load_queue(APPEND_ACTION);
     if (!_.isUndefined($append_queue) && _.isArray($append_queue) && $append_queue.length) {
         var $append_item;
         var append_callback = function(response, data) {
@@ -432,16 +432,17 @@ MixpanelPeople.prototype._flush = function(
             }
         };
         for (var i = $append_queue.length - 1; i >= 0; i--) {
+            $append_queue = this._mixpanel['persistence'].load_queue(APPEND_ACTION);
             $append_item = $append_queue.pop();
+            _this._mixpanel['persistence'].save();
             if (!_.isEmptyObject($append_item)) {
                 _this.append($append_item, append_callback);
             }
         }
-        // Save the shortened append queue
-        _this._mixpanel['persistence'].save();
     }
 
     // same for $remove
+    var $remove_queue = this._mixpanel['persistence'].load_queue(REMOVE_ACTION);
     if (!_.isUndefined($remove_queue) && _.isArray($remove_queue) && $remove_queue.length) {
         var $remove_item;
         var remove_callback = function(response, data) {
@@ -453,12 +454,13 @@ MixpanelPeople.prototype._flush = function(
             }
         };
         for (var j = $remove_queue.length - 1; j >= 0; j--) {
+            $remove_queue = this._mixpanel['persistence'].load_queue(REMOVE_ACTION);
             $remove_item = $remove_queue.pop();
+            _this._mixpanel['persistence'].save();
             if (!_.isEmptyObject($remove_item)) {
                 _this.remove($remove_item, remove_callback);
             }
         }
-        _this._mixpanel['persistence'].save();
     }
 };