// 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"); } }