Merge 114608, 115692 to 963 (M17) branch.

chrome/browser/ui/webui/sync_promo/sync_promo_trial.h

+// Copyright (c) 2011 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_BROWSER_UI_WEBUI_SYNC_PROMO_SYNC_PROMO_TRIAL_H_
+#define CHROME_BROWSER_UI_WEBUI_SYNC_PROMO_SYNC_PROMO_TRIAL_H_
+
+#include "base/basictypes.h"
+
+class Profile;
+
+// These helpers manage the Sync Promo field trial.
+//
+// The sync promo experiment involves changing the message body in the sign in
+// promo (see SyncPromoHandler) to see if that has any effect on sign in.
+namespace sync_promo_trial {
+  enum Group {
+    // "Get your bookmarks, history, and settings on all your devices."
+    // This is also the default message group.
+    PROMO_MSG_A = 0,
+
+    // "Back up your bookmarks, history, and settings to the web."
+    PROMO_MSG_B,
+
+    // "Sync your personalized browser features between all your devices."
+    PROMO_MSG_C,
+
+    // "You'll be automatically signed into to your favorite Google services."
+    PROMO_MSG_D,
+
+    // Bounding max value needed for UMA histogram macro.
+    PROMO_MSG_MAX,
+  };
+
+  enum SyncPromoEnabledBrandUMABuckets {
+    WITH_SYNC_PROMO_WITH_DEFAULT_APPS = 0,
+    WITH_SYNC_PROMO_WITHOUT_DEFAULT_APPS,
+    WITHOUT_SYNC_PROMO_WITHOUT_DEFAULT_APPS_A,
+    WITHOUT_SYNC_PROMO_WITHOUT_DEFAULT_APPS_B,
+    SYNC_PROMO_AND_DEFAULT_APPS_BOUNDARY,
+  };
+
+  // Activate the field trial. Before this call, all calls to GetGroup will
+  // return PROMO_MSG_A. *** MUST NOT BE CALLED MORE THAN ONCE. ***
+  void Activate();
+
+  // Returns true iff the experiment has been set up and is active. If this
+  // is false, the caller should not record stats for this experiment.
+  bool IsExperimentActive();
+
+  // If the user has been tagged with a brand code at install time that
+  // determines if they should see the sync promo or not.
+  bool IsPartOfBrandTrialToEnable();
+
+  // Return the field trial group this client belongs to.
+  Group GetGroup();
+
+  // Return the UMA bucket
+  int GetSyncPromoBrandUMABucketFromGroup();
+
+  // Return the resource ID for the Sync Promo message body associated with this
+  // client.
+  int GetMessageBodyResID();
+
+  // Record the appropriate UMA stat for when a user sees the sync promo
+  // message.
+  void RecordUserSawMessage();
+
+  // Record that a user was shown the promo when tagged with an experimental
+  // brand code.
+  void RecordUserShownPromoWithTrialBrand(bool is_at_startup, Profile* profile);
+
+  // Record the appropriate UMA stat for when a user successfully signs in to
+  // GAIA.
+  void RecordUserSignedIn();
+
+  // Record that a user signed in while tagged with a brand code currently being
+  // used in a field trial.
+  void RecordUserSignedInWithTrialBrand(bool is_at_startup, Profile* profile);
+
+  // If we've been tagged with any of the experimental brands to show the sync
+  // promo.
+  bool ShouldShowAtStartupBasedOnBrand();
+}
+
+#endif  // CHROME_BROWSER_UI_WEBUI_SYNC_PROMO_SYNC_PROMO_TRIAL_H_