Track the amount and device type of builds and livesync operations (#2690)

* Track the amount and device type of builds and livesync operations

In order to unsderstand the workflow of our users, we need to track how many builds they are executing, how many livesync operations, etc. We also need to know if the operation is for device or emulator (iOSSimulator).
This will allow us to focus the development and provide better features in the future.

* Track information for deploy and for device OS

Track information for deploy operations. Introduce new method in platformService, that tracks the action.
Track the device OS version as well.

* Track Android only for build operations

Track only Android platform for build operation. We do not need to track Android.emulator and Android.device for build operations as they are both the same actions.

Author: rosen-vladimirov

lib/definitions/platform.d.ts

@@ -131,7 +131,7 @@ interface IPlatformService {
 	 * @param {{isForDevice: boolean}} settings Defines if the searched artifact should be for simulator.
 	 * @returns {void}
 	 */
-	copyLastOutput(platform: string, targetPath: string, settings: {isForDevice: boolean}): void;
+	copyLastOutput(platform: string, targetPath: string, settings: { isForDevice: boolean }): void;
 
 	lastOutputPath(platform: string, settings: { isForDevice: boolean }): string;
 
@@ -150,6 +150,38 @@ interface IPlatformService {
 	 * @returns {IFuture<void>}
 	 */
 	trackProjectType(): IFuture<void>;
+
+	/**
+	 * Sends information to analytics for specific platform related action, for example Build, LiveSync, etc.
+	 * @param {ITrackPlatformAction} actionData The data describing current action.
+	 * @returns {IFuture<void>}
+	 */
+	trackActionForPlatform(actionData: ITrackPlatformAction): IFuture<void>;
+}
+
+/**
+ * Describes information that will be tracked for specific action related for platforms - build, livesync, etc.
+ */
+interface ITrackPlatformAction {
+	/**
+	 * Name of the action.
+	 */
+	action: string;
+
+	/**
+	 * Platform for which the action will be executed.
+	 */
+	platform: string;
+
+	/**
+	 * Defines if the action is for device or emulator.
+	 */
+	isForDevice: boolean;
+
+	/**
+	 * Defines the OS version of the device for which the action will be executed.
+	 */
+	deviceOsVersion?: string;
 }
 
 interface IPlatformData {

lib/services/livesync/platform-livesync-service.ts

@@ -39,6 +39,8 @@ export abstract class PlatformLiveSyncServiceBase implements IPlatformLiveSyncSe
 			let canExecute = this.getCanExecuteAction(platform, appIdentifier);
 			let action = (device: Mobile.IDevice): IFuture<void> => {
 				return (() => {
+					this.$platformService.trackActionForPlatform({ action: "LiveSync", platform, isForDevice: !device.isEmulator, deviceOsVersion: device.deviceInfo.version }).wait();
+
 					let deviceAppData = this.$deviceAppDataFactory.create(appIdentifier, this.$mobileHelper.normalizePlatformName(platform), device);
 					let localToDevicePaths: Mobile.ILocalToDevicePathData[] = null;
 					if (this.shouldTransferAllFiles(platform, deviceAppData)) {

lib/services/platform-service.ts

@@ -392,11 +392,30 @@ export class PlatformService implements IPlatformService {
 		}).future<void>()();
 	}
 
+	public trackActionForPlatform(actionData: ITrackPlatformAction): IFuture<void> {
+		return (() => {
+			const normalizePlatformName = this.$mobileHelper.normalizePlatformName(actionData.platform);
+			let featureValue = normalizePlatformName;
+			if (actionData.isForDevice !== null) {
+				const deviceType = actionData.isForDevice ? "device" : "emulator";
+				featureValue += `.${deviceType}`;
+			}
+
+			this.$analyticsService.track(actionData.action, featureValue).wait();
+
+			if (actionData.deviceOsVersion) {
+				this.$analyticsService.track(`Device OS version`, `${normalizePlatformName}_${actionData.deviceOsVersion}`).wait();
+			}
+		}).future<void>()();
+	}
+
 	public buildPlatform(platform: string, buildConfig?: IBuildConfig): IFuture<void> {
 		return (() => {
 			this.$logger.out("Building project...");
 
 			this.trackProjectType().wait();
+			const isForDevice = this.$mobileHelper.isAndroidPlatform(platform) ? null : (this.$options.forDevice || (buildConfig && buildConfig.buildForDevice));
+			this.trackActionForPlatform({ action: "Build", platform, isForDevice }).wait();
 
 			let platformData = this.$platformsData.getPlatformData(platform);
 			platformData.platformProjectService.buildProject(platformData.projectRoot, buildConfig).wait();
@@ -464,6 +483,8 @@ export class PlatformService implements IPlatformService {
 					} else {
 						this.$logger.out("Skipping install.");
 					}
+
+					this.trackActionForPlatform({ action: "Deploy", platform: device.deviceInfo.platform, isForDevice: !device.isEmulator, deviceOsVersion: device.deviceInfo.version }).wait();
 				}).future<void>()();
 			};
 			this.$devicesService.execute(action, this.getCanExecuteAction(platform)).wait();

test/stubs.ts

@@ -679,6 +679,10 @@ export class PlatformServiceStub implements IPlatformService {
 	public trackProjectType(): IFuture<void> {
 		return Future.fromResult();
 	}
+
+	public trackActionForPlatform(actionData: ITrackPlatformAction): IFuture<void> {
+		return Future.fromResult();
+	}
 }
 
 export class EmulatorPlatformService implements IEmulatorPlatformService {