Minimalistic analytics library used by Dart Server and try.dartlang.org

dart/pkg/microlytics/lib/microlytics.dart

+// Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+library microlytics;
+
+import 'channels.dart';
+
+/// Very limited implementation of an API to report usage to Google Analytics.
+/// No Personally Identifiable Information must ever be passed to this class.
+class AnalyticsLogger {
+  final Channel _channel;
+  final String _clientID;
+  final String _analyticsID;
+  final String _appName;
+  final String _appVersion;
+  final String _messagePrefix; //Computed prefix for analytics messages
+
+  /// Create a new logger
+  /// [channel] represents how this is going to be sent, this would typically
+  /// be a [RateLimitingBufferedChannel] wrapping either a [HttpRequestChannel]
+  /// or a [HttpClientChannel].
+  /// [clientID] is a version 4 UUID associated with the site or app.
+  /// [appName] is an application name.
+  /// [appVersion] is a verion string.
+  AnalyticsLogger(Channel channel, String clientID, String analyticsID,
+      String appName, String appVersion)
+      : this._channel = channel,
+      this._clientID = clientID,
+      this._analyticsID = analyticsID,
+      this._appName = appName,
+      this._appVersion = appVersion,
+      this._messagePrefix =
+        "v=1"
+        "&tid=$analyticsID"
+        "&cid=$clientID"
+        "&an=$appName"
+        "&av=$appVersion";
+
+  void logAnonymousTiming(String category, String variable, int ms) {
+    category = Uri.encodeComponent(category);
+    variable = Uri.encodeComponent(variable);
+    _channel.sendData(
+        "${this._messagePrefix}"
+        "&t=timing"
+        "&utc=$category"
+        "&utv=$variable"
+        "&utt=$ms");
+  }
+
+  void logAnonymousEvent(String category, String event) {
+    category = Uri.encodeComponent(category);
+    event = Uri.encodeComponent(event);
+    _channel.sendData(
+        "${this._messagePrefix}"
+        "&t=event"
+        "&ec=$category"
+        "&ea=$event");
+  }
+}
+