Win 10 Inactive toast experiment metrics and storage modifications.

chrome/installer/util/experiment_metrics.h

+// Copyright 2017 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef CHROME_INSTALLER_UTIL_EXPERIMENT_METRICS_H_
+#define CHROME_INSTALLER_UTIL_EXPERIMENT_METRICS_H_
+
+#include <stdint.h>
+
+namespace installer {
+
+// The various metrics reported for the status of the inactive user toast. This
+// struct contains the information necessary to evaluate the efficacy of the
+// toast on Chrome usage.
+struct ExperimentMetrics {
+ public:
+  // The state of this install's participation in the experiment.
+  enum State {
+    kUninitialized = -1,
+
+    // Relaunching setup.exe for a per-user install failed. Will retry on next
+    // update.
+    kRelaunchFailed = 0,
+
+    // No user on console for per-machine install; waiting for invocation at
+    // next logon via Active Setup.
+    kWaitingForUserLogon = 1,
+
+    // Waiting in user context for the setup singleton.
+    kWaitingForSingleton = 2,
+
+    // Timed out waiting for the setup singleton. Will retry on next update.
+    kSingletonWaitTimeout = 3,
+
+    // A group has been assigned. The experiment has moved out of the initial
+    // state at this point. This state is reached under the setup singleton.
+    kGroupAssigned = 4,
+
+    // The user is not participating on account of using a tablet-like device.
+    kIsTabletDevice = 5,
+
+    // Chrome has been run within the last 28 days.
+    kIsActive = 6,
+
+    // The user has not been active on the machine much in the last 28 days.
+    kIsDormant = 7,
+
+    // Deferring presentation until it's okay to show the toast.
+    kDeferringPresentation = 8,
+
+    // Deferral was aborted on account of another process requiring the setup
+    // singleton.
+    kDeferredPresentationAborted = 9,
+
+    // Launching Chrome for presentation.
+    kLaunchingChrome = 10,
+
+    // User selected 'No Thanks' button from UI after toast was shown.
+    kSelectedNoThanks = 11,
+
+    // User selected 'Open Chrome' button from UI after toast was shown but
+    // Chrome crashed after opening.
+    kSelectedOpenChromeAndCrash = 12,
+
+    // User selected 'No Thanks' button from UI after toast was shown and
+    // user successfully opened chrome.
+    kSelectedOpenChromeAndNoCrash = 13,
+
+    // User selected [x] button from display.
+    kSelectedClose = 14,
+
+    // User logged off (gracefully) without interacting with toast.
+    kUserLogOff = 15,
+
+    NUM_STATES
+  };
+
+  // The location of the toast for those clients for which it was presented.
+  enum ToastLocation {
+    // The toast was shown positioned over Chrome's taskbar pin.
+    kOverTaskbarPin = 0,
+
+    // The toast was shown over the notification area.
+    kOverNotificationArea = 1,
+  };
+
+  // Returns true if the install is in any of the states that precede group
+  // assignment.
+  bool InInitialState() const;
+
+  // Returns true if the install is in a terminal state and should no longer
+  // participate in the experiment.
+  bool InTerminalState() const;
+  void SetState(State state);
+
+  // The number of experiment groups (including the  holdback group).
+  static constexpr int kNumGroups = 16;
+
+  // Unix epoch of time from when time bucket for experiment is started.
+  // This will be subtracted from the day the toast was shown to bucket user
+  // into cohorts for analysing retention. (25 May 2017 00:00:00 PST)

[grt (UTC plus 2), 2017/05/31 12:24:09]

PST -> UTC? base::Time is in UTC

[nikunjb, 2017/06/02 05:11:23]

The value is used to create TimeDelta which is tz independent.

This is subtracted from display time before setting metrics.first_toast_offset
(unit is days), so having this aligned with midnight PST when logs are cutoff
means for daily analysis the cohort will be almost ready the next day.
 

[grt (UTC plus 2), 2017/06/02 11:30:45]

Groovy. Since it's an offset from the Unix epoch (which is UTC), I just wanted
to verify that you really wanted midnight PST. It makes sense.

+  static constexpr int64_t kExperimentStartSeconds = 1495695600L;

[grt (UTC plus 2), 2017/05/31 12:24:09]

nit: remove 'L'

[nikunjb, 2017/06/02 05:11:23]

Done.

+
+  // Maximum number of time toast should be displayed (3 bits).
+  static constexpr int kMaxToastCount = 7;
+
+  // Maximum value of first toast offset. (10 bits).
+  static constexpr int kMaxFirstToastOffset = 1023;
+
+  // Maximum value of last used bucket. (7 bits, log scale).
+  static constexpr int kMaxLastUsed = 1825;  // 5 yr in days.
+
+  // Maximum value of user session length. (6 bits, in minutes and log scale).
+  static constexpr int kMaxSessionLength = 40320;  // 28 days in minutes.
+
+  // Maximum value of user session length. (5 bits, in seconds and log scale).
+  static constexpr int kMaxDisplayTime = 604800;  // 7 days in seconds.
+
+  static constexpr int kSessionLengthBits = 6;
+
+  static constexpr int kDisplayTimeBucketBits = 5;
+
+  static constexpr int kLastUsedBucketBits = 7;
+
+  static constexpr int kToastHourBits = 5;
+
+  static constexpr int kFirstToastOffsetBits = 10;
+
+  static constexpr int kToastCountBits = 3;
+
+  static constexpr int kToastLocationBits = 1;
+
+  static constexpr int kStateBits = 4;
+
+  static constexpr int kGroupBits = 4;
+
+  // The group to which this install has been assigned.
+  int group = 0;
+
+  State state = kUninitialized;
+  ToastLocation toast_location = kOverTaskbarPin;
+
+  // The number of times the toast has been presented.
+  int toast_count = 0;
+
+  // The number of days that have passed since 2017-05-20 on the first day the

[grt (UTC plus 2), 2017/05/31 12:24:09]

20 -> 25

[nikunjb, 2017/06/02 05:11:23]

Done.

+  // toast was presented.
+  int first_toast_offset = 0;
+
+  // The local (wall clock) hour in which the toast was presented.
+  int toast_hour = 0;
+
+  // Days since the last time Chrome was used in the range [1-1825) in a
+  // 128-bucket log scale.
+  int last_used_bucket = 0;
+
+  // Time delta (in seconds) between presentation and action in the range
+  // [1-604800) in a 32-bucket log scale.
+  int display_time_bucket = 0;
+
+  // Time delta (in minutes) between user session start and presentation in the
+  // range [1-40320) in a 64-bucket log scale.
+  int session_length_bucket = 0;
+};
+
+}  // namespace installer
+
+#endif  // CHROME_INSTALLER_UTIL_EXPERIMENT_METRICS_H_