added utmMapper and utmHandling

Author: pmeisen

src/Breinify.js

@@ -179,6 +179,38 @@
             return unixTimestamp + "-" + paraLocalDateTime + "-" + paraTimezone;
         },
 
+        handleUtmParameters: function() {
+
+            // get the mapper to be used
+            var mapper = _config.get(ATTR_CONFIG.UTM_MAPPER);
+            if (typeof mapper !== 'function') {
+                return;
+            }
+
+            // see https://en.wikipedia.org/wiki/UTM_parameters
+            var params = BreinifyUtil.loc.params();
+
+            var utmSource = Breinify.UTL.isEmpty(params['utm_source']) ? null : params['utm_source'];
+            var utmMedium = Breinify.UTL.isEmpty(params['utm_medium']) ? null : params['utm_medium'];
+            var utmCampaign = Breinify.UTL.isEmpty(params['utm_campaign']) ? null : params['utm_campaign'];
+            var utmTerm = Breinify.UTL.isEmpty(params['utmTerm']) ? null : params['utm_term'];
+            var utmContent = Breinify.UTL.isEmpty(params['utmContent']) ? null : params['utm_content'];
+
+            // create the data
+            var values = mapper({
+                'utmSource': utmSource,
+                'utmMedium': utmMedium,
+                'utmCampaign': utmCampaign,
+                'utmTerm': utmTerm,
+                'utmContent': utmContent
+            }, user);
+
+            // make sure we have a result and send the activity
+            if ($.isPlainObject(values) && $.isPlainObject(values.user) && $.isPlainObject(values.utmData)) {
+                Breinify.activity(values.user, 'utmData', null, null, values.utmData, null);
+            }
+        },
+
         handleGetParameters: function () {
             var knownParams = {
                 'brec': {
@@ -208,7 +240,7 @@
             }
         },
 
-        handleGetParameter: function(name, value, overrides) {
+        handleGetParameter: function (name, value, overrides) {
 
             // parse it and make sure it was parseable
             var parsedValue = _privates.parseGetParameter(name, value);
@@ -244,7 +276,7 @@
              */
             var user = combinedValue.user;
             var activity = combinedValue.activity;
-            Breinify.activity(user, activity.type, activity.category, activity.description, activity.tags, null, function() {
+            Breinify.activity(user, activity.type, activity.category, activity.description, activity.tags, null, function () {
 
                 // mark it as successfully sent
                 BreinifyUtil.cookie.set(hashId, true);
@@ -287,6 +319,10 @@
         if (_config.get(ATTR_CONFIG.HANDLE_PARAMETERS) === true) {
             _privates.handleGetParameters();
         }
+
+        if (_config.get(ATTR_CONFIG.HANDLE_UTM) === true) {
+            _privates.handleUtmParameters();
+        }
     };
 
     /**

src/BreinifyConfig.js

@@ -91,6 +91,25 @@
             return value === true || value === false;
         }
     });
+    attributes.add('HANDLE_UTM', {
+        name: 'handleUtm',
+        defaultValue: false,
+        validate: function (value) {
+            return value === true || value === false;
+        }
+    });
+    attributes.add('UTM_MAPPER', {
+        name: 'utmMapper',
+        defaultValue: function(utmData, user) {
+            return {
+                'utmData': utmData,
+                'user': user
+            };
+        },
+        validate: function (value) {
+            return value === null || typeof(value) === 'function';
+        }
+    });
     attributes.add('AJAX_TIMEOUT', {
         name: 'timeout',
         defaultValue: 4000,