Added setter methods for version, namespace, app ID, and IP address (snowplow#242)

Author: fblundun

core/lib/core.js

@@ -155,6 +155,33 @@ function trackerCore(base64, callback) {
 			payloadPairs = payload.isJson(dict) ? dict : {};
 		},
 
+		/**
+		 * Set the tracker version
+		 *
+		 * @param string version
+		 */
+		setTrackerVersion: function (version) {
+			addPayloadPair('tv', version)
+		},
+
+		/**
+		 * Set the tracker namespace
+		 *
+		 * @param string name
+		 */
+		setTrackerNamespace: function (name) {
+			addPayloadPair('tna', name);
+		},
+
+		/**
+		 * Set the application ID
+		 *
+		 * @param string appId
+		 */
+		setAppId: function (appId) {
+			addPayloadPair('aid', appId)
+		},
+
 		/**
 		 * Set the platform
 		 *
@@ -220,6 +247,15 @@ function trackerCore(base64, callback) {
 			addPayloadPair('lang', lang);
 		},
 
+		/**
+		 * Set the IP address
+		 *
+		 * @param string appId
+		 */
+		setIpAddress: function (ip) {
+			addPayloadPair('ip', ip)
+		},
+
 		trackUnstructEvent: trackUnstructEvent,
 
 		/**

core/tests/core.js

@@ -378,24 +378,32 @@ define([
 
 		"Use setter methods": function () {
 			var tracker = core(false);
+			tracker.setTrackerVersion('js-3.0.0');
+			tracker.setTrackerNamespace('cf1');
+			tracker.setAppId('my-app');
 			tracker.setPlatform('web');
 			tracker.setUserId('jacob');
 			tracker.setScreenResolution(400, 200);
 			tracker.setViewport(500, 800);
 			tracker.setColorDepth(24);
 			tracker.setTimezone('Europe London');
+			tracker.setIpAddress('37.151.33.154');
 			var url = 'http://www.example.com';
 			var page = 'title page';
 			var expected = {
 				e: 'pv',
 				url: url,
 				page: page,
+				tna: 'cf1',
+				tv: 'js-3.0.0',
+				aid: 'my-app',
 				p: 'web',
 				uid: 'jacob',
 				res: '400x200',
 				vp: '500x800',
 				cd: 24,
-				tz: 'Europe London'
+				tz: 'Europe London',
+				ip: '37.151.33.154'
 			};
 
 			compare(tracker.trackPageView(url, page), expected, 'setXXX methods should work correctly');