user_experiment.h revision 868fa2fe829687343ffae624259930155e16dbd8
1// Copyright 2013 The Chromium Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style license that can be 3// found in the LICENSE file. 4// 5// This files declares a class that contains methods and data to conduct 6// for user expeirments. 7 8#ifndef CHROME_INSTALLER_UTIL_USER_EXPERIMENT_H_ 9#define CHROME_INSTALLER_UTIL_USER_EXPERIMENT_H_ 10 11#include "base/strings/string16.h" 12#include "chrome/installer/util/util_constants.h" 13 14class CommandLine; 15 16namespace base { 17class FilePath; 18} 19 20namespace installer { 21 22class Product; 23 24// Flags to control what to show in the UserExperiment dialog. 25enum ToastUiFlags { 26 kToastUiUninstall = 1 << 0, // Uninstall radio button. 27 kToastUiDontBugMeAsButton = 1 << 1, // This is a button, not a radio button. 28 kToastUiWhyLink = 1 << 2, // Has the 'why I am seeing this' link. 29 kToastUiMakeDefault = 1 << 3, // Has the 'make it default' checkbox. 30}; 31 32// A struct for communicating what a UserExperiment contains. In these 33// experiments we show toasts to the user if they are inactive for a certain 34// amount of time. 35struct ExperimentDetails { 36 string16 prefix; // The experiment code prefix for this experiment, 37 // also known as the 'TV' part in 'TV80'. 38 int flavor; // The flavor index for this experiment. 39 int heading; // The heading resource ID to use for this experiment. 40 int flags; // See ToastUIFlags above. 41 int control_group; // Size of the control group (in percentages). Control 42 // group is the group that qualifies for the 43 // experiment but does not participate. 44}; 45 46// Creates the experiment details for a given language-brand combo. 47// If |flavor| is -1, then a flavor will be selected at random. |experiment| 48// is the struct you want to write the experiment information to. 49// Returns false if no experiment details could be gathered. 50bool CreateExperimentDetails(int flavor, ExperimentDetails* experiment); 51 52// After an install or upgrade the user might qualify to participate in an 53// experiment. This function determines if the user qualifies and if so it 54// sets the wheels in motion or in simple cases does the experiment itself. 55void LaunchBrowserUserExperiment(const CommandLine& base_command, 56 InstallStatus status, 57 bool system_level); 58 59// The user has qualified for the inactive user toast experiment and this 60// function just performs it. 61void InactiveUserToastExperiment(int flavor, 62 const string16& experiment_group, 63 const Product& product, 64 const base::FilePath& application_path); 65 66} // namespace installer 67 68#endif // CHROME_INSTALLER_UTIL_USER_EXPERIMENT_H_ 69