src/chrome/common/variations/variation_ids.h

   1 // Copyright 2014 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 #ifndef CHROME_COMMON_VARIATIONS_VARIATION_IDS_H_
   6 #define CHROME_COMMON_VARIATIONS_VARIATION_IDS_H_
   7
   8 namespace chrome_variations {
   9
  10 // A list of Chrome Variation IDs. These IDs are associated with FieldTrials
  11 // for re-identification and analysis on Google servers.
  12 // These enums are to be used with the experiments_helper ID associoation API.
  13 //
  14 // The IDs are defined as part of an enum to prevent re-use. When adding your
  15 // own IDs, please respect the reserved IDs of other groups, as well as the
  16 // global range of permitted values.
  17 //
  18 // When you want to create a FieldTrial that needs to be recognized by Google
  19 // properties, reserve an ID by declaring them below. Please start with the name
  20 // of the FieldTrial followed a short description.
  21 //
  22 // Ex:
  23 // // Name: Instant-Field-Trial
  24 // // The Omnibox Instant Trial.
  25 // INSTANT_TRIAL_ID_ON  = 3300123,
  26 // INSTANT_TRIAL_ID_OFF = 3300124,
  27 //
  28 // If you programatically generate FieldTrials, you can still use a loop to
  29 // create your IDs. Just be sure to reserve the range of IDs here with a clear
  30 // comment.
  31 //
  32 // Ex:
  33 // // Name: UMA-Uniformity-Trial-5-Percent
  34 // // Range: 330000 - 3300019
  35 // // The 5% Uniformity Trial. This is a reserved range.
  36 // UNIFORMITY_TRIAL_5_PERCENT_ID_BASE = 330000,
  37 // UNIFORMITY_TRIAL_5_PERCENT_ID_LIMIT =
  38 //     UNIFORMITY_TRIAL_5_PERCENT_ID_BASE + 20,
  39 //
  40 // Anything within the range of a uint32 should be castable to an ID, but
  41 // please ensure that they are within the range of the min and max values.
  42 enum ReservedVariationID {
  43   // The smallest possible Chrome Variation ID in the reserved range. The
  44   // first 10,000 values are reserved for internal variations infrastructure
  45   // use. Please do not use values in this range.
  46   MINIMIUM_ID = 3300000,
  47
  48   // Name: UMA-Uniformity-Trial-1-Percent
  49   // Range: 3300000 - 3300099
  50   UNIFORMITY_1_PERCENT_BASE  = MINIMIUM_ID,
  51   UNIFORMITY_1_PERCENT_LIMIT = UNIFORMITY_1_PERCENT_BASE + 100,
  52   // Name: UMA-Uniformity-Trial-5-Percent
  53   // Range: 3300100 - 3300119
  54   UNIFORMITY_5_PERCENT_BASE  = UNIFORMITY_1_PERCENT_LIMIT,
  55   UNIFORMITY_5_PERCENT_LIMIT = UNIFORMITY_5_PERCENT_BASE + 20,
  56   // Name: UMA-Uniformity-Trial-10-Percent
  57   // Range: 3300120 - 3300129
  58   UNIFORMITY_10_PERCENT_BASE  = UNIFORMITY_5_PERCENT_LIMIT,
  59   UNIFORMITY_10_PERCENT_LIMIT = UNIFORMITY_10_PERCENT_BASE + 10,
  60   // Name: UMA-Uniformity-Trial-20-Percent
  61   // Range: 3300130 - 3300134
  62   UNIFORMITY_20_PERCENT_BASE  = UNIFORMITY_10_PERCENT_LIMIT,
  63   UNIFORMITY_20_PERCENT_LIMIT = UNIFORMITY_20_PERCENT_BASE + 5,
  64   // Name: UMA-Uniformity-Trial-50-Percent
  65   // Range: 3300135 - 3300136
  66   UNIFORMITY_50_PERCENT_BASE  = UNIFORMITY_20_PERCENT_LIMIT,
  67   UNIFORMITY_50_PERCENT_LIMIT = UNIFORMITY_50_PERCENT_BASE + 2,
  68
  69   // Name: UMA-Dynamic-Binary-Uniformity-Trial
  70   // The dynamic uniformity trial is only specified on the server, this is just
  71   // to reserve the id.
  72   DYNAMIC_UNIFORMITY_ID_DEFAULT = 3300137,
  73   DYNAMIC_UNIFORMITY_ID_GROUP_1 = 3300138,
  74
  75   // Name: UMA-Session-Randomized-Uniformity-Trial-5-Percent
  76   // Range: 3300139 - 3300158
  77   // A uniformity trial used to compare one-time-randomized and
  78   // session-randomized FieldTrials.
  79   UNIFORMITY_SESSION_RANDOMIZED_5_PERCENT_BASE  = 3300139,
  80   UNIFORMITY_SESSION_RANDOMIZED_5_PERCENT_LIMIT =
  81       UNIFORMITY_SESSION_RANDOMIZED_5_PERCENT_BASE + 20,
  82
  83   // Name: UMA-Dynamic-Uniformity-Trial
  84   // Range: 3300159 - 3300165
  85   UNIFORMITY_DYNAMIC_TRIAL_BASE = 3300159,
  86   UNIFORMITY_DYNAMIC_TRIAL_LIMIT = UNIFORMITY_DYNAMIC_TRIAL_BASE + 6,
  87
  88   // Some values reserved for unit and integration tests.
  89   // Range: 3300159 - 3300299
  90   TEST_VALUE_BASE = 3300200,
  91   TEST_VALUE_LIMIT = TEST_VALUE_BASE + 100,
  92
  93   // USABLE IDs BEGIN HERE.
  94   //
  95   // The smallest possible Chrome Variation ID for use in real FieldTrials. If
  96   // you are defining variation IDs for your own FieldTrials, NEVER use a value
  97   // lower than this.
  98   MINIMUM_USER_ID = 3310000,
  99
 100   // Add new variation IDs below.
 101
 102   // DEPRECATED - DO NOT USE
 103   // Name: OmniboxSearchSuggest
 104   // Range: 3310000 - 3310019
 105   // Now retired.  But please don't reuse these IDs; they may taint
 106   // your experiment results.
 107   SUGGEST_ID_MIN = 3310000,
 108   SUGGEST_ID_MAX = 3310019,
 109
 110   // Instant field trial.
 111   INSTANT_ID_CONTROL = 3310020,
 112   INSTANT_ID_SILENT  = 3310021,
 113   INSTANT_ID_HIDDEN  = 3310022,
 114   INSTANT_ID_SUGGEST = 3310023,
 115   INSTANT_ID_INSTANT = 3310024,
 116
 117   // Instant dummy field trial.
 118   DUMMY_INSTANT_ID_DEFAULT      = 3310025,
 119   DUMMY_INSTANT_ID_CONTROL      = 3310026,
 120   DUMMY_INSTANT_ID_EXPERIMENT_1 = 3310027,
 121   DUMMY_INSTANT_ID_EXPERIMENT_2 = 3310028,
 122   DUMMY_INSTANT_ID_EXPERIMENT_3 = 3310049,
 123
 124   // DEPRECATED - DO NOT USE
 125   // Name: OmniboxSearchSuggestStarted2012Q4
 126   // Range: 3310029 - 3310048
 127   // Now retired.  But please don't reuse these IDs; they may taint
 128   // your experiment results.
 129   SUGGEST_TRIAL_STARTED_2012_Q4_ID_MIN = 3310029,
 130   SUGGEST_TRIAL_STARTED_2012_Q4_ID_MAX = 3310048,
 131
 132   // Name: Instant channel and extended field trials.
 133   // Range: 3310050 - 3310059
 134   CHANNEL_INSTANT_ID_BETA            = 3310050,
 135   CHANNEL_INSTANT_ID_DEV             = 3310051,
 136   CHANNEL_INSTANT_ID_STABLE          = 3310052,
 137   EXTENDED_INSTANT_ID_CANARY_GROUP_1 = 3310053,
 138   EXTENDED_INSTANT_ID_CANARY_CONTROL = 3310054,
 139   EXTENDED_INSTANT_ID_DEV_GROUP_1    = 3310055,
 140   EXTENDED_INSTANT_ID_DEV_CONTROL    = 3310056,
 141
 142   // DEPRECATED - DO NOT USE
 143   // Name: OmniboxSearchSuggestTrialStarted2013Q1
 144   // Range: 3310060 - 3310079
 145   // Now retired.  But please don't reuse these IDs; they may taint
 146   // your experiment results.
 147   SUGGEST_TRIAL_STARTED_2013_Q1_ID_MIN = 3310060,
 148   SUGGEST_TRIAL_STARTED_2013_Q1_ID_MAX = 3310079,
 149
 150   // Name: More IDs for the InstantExtended field trial.
 151   // Range: 3310080 - 3310085
 152   EXTENDED_INSTANT_ID_UNUSED_1            = 3310080,
 153   EXTENDED_INSTANT_ID_UNUSED_2            = 3310081,
 154   EXTENDED_INSTANT_ID_CANARY_CONTROL_2    = 3310082,
 155   EXTENDED_INSTANT_ID_DEV_CONTROL_2       = 3310083,
 156   EXTENDED_INSTANT_ID_CANARY_GROUP_2      = 3310084,
 157   EXTENDED_INSTANT_ID_DEV_GROUP_2         = 3310085,
 158   EXTENDED_INSTANT_ID_BETA_CONTROL_1      = 3310250,
 159   EXTENDED_INSTANT_ID_BETA_CONTROL_2      = 3310251,
 160   EXTENDED_INSTANT_ID_BETA_GROUP_1        = 3310252,
 161   EXTENDED_INSTANT_ID_BETA_GROUP_2        = 3310253,
 162   EXTENDED_INSTANT_ID_DEV_FRESH_CONTROL_1 = 3310254,
 163   EXTENDED_INSTANT_ID_DEV_FRESH_CONTROL_2 = 3310255,
 164   EXTENDED_INSTANT_ID_DEV_FRESH_GROUP_1   = 3310256,
 165   EXTENDED_INSTANT_ID_DEV_FRESH_GROUP_2   = 3310257,
 166   EXTENDED_INSTANT_ID_DEV_HOLDBACK        = 3310258,
 167   EXTENDED_INSTANT_ID_DEV_OFFLINE_1       = 3310259,
 168   EXTENDED_INSTANT_ID_DEV_OFFLINE_2       = 3310260,
 169   EXTENDED_INSTANT_ID_DEV_INSTANT_1       = 3310261,
 170   EXTENDED_INSTANT_ID_DEV_INSTANT_2       = 3310262,
 171   // Reserve a contiguous chunk of IDs for Instant Extended.
 172   EXTENDED_INSTANT_RANGE_ID_MIN           = 3310265,
 173   EXTENDED_INSTANT_RANGE_ID_MAX           = 3310365,
 174   EXTENDED_INSTANT_RANGE2_ID_MIN          = 3310368,
 175   EXTENDED_INSTANT_RANGE2_ID_MAX          = 3310868,
 176   EXTENDED_INSTANT_RANGE3_ID_MIN          = 3310871,
 177   EXTENDED_INSTANT_RANGE3_ID_MAX          = 3311870,
 178
 179   // Reserve 100 IDs to be used by autocomplete dynamic field trials.
 180   // The dynamic field trials are activated by a call to
 181   // OmniboxFieldTrial::ActivateDynamicFieldTrials.
 182   // For more details, see
 183   // chrome/browser/omnibox/omnibox_field_trial.{h,cc}.
 184   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_ID_MIN = 3310086,
 185   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_ID_MAX = 3310185,
 186
 187   // BookmarkPrompt field trial.
 188   BOOKMARK_PROMPT_TRIAL_DEFAULT = 3310186,
 189   BOOKMARK_PROMPT_TRIAL_CONTROL = 3310187,
 190   BOOKMARK_PROMPT_TRIAL_EXPERIMENT = 3310188,
 191
 192   // iOS tour trial.
 193   IOS_TOUR_DEFAULT = 3310189,
 194   IOS_TOUR_EXPERIMENT = 3310190,
 195
 196   // Name: SendFeedbackLinkLocation.
 197   // Field trial to test various locations, and strings
 198   // for submitting feedback.
 199   SEND_FEEDBACK_LINK_LOCATION_CONTROL = 3310200,
 200   SEND_FEEDBACK_LINK_LOCATION_CONTROL_CROS = 3310201,
 201   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_DEV = 3310202,
 202   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_STABLE = 3310203,
 203   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_BETA = 3310204,
 204   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_CROS_DEV = 3310205,
 205   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_CROS_STABLE = 3310206,
 206   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_CROS_BETA = 3310207,
 207   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_DEV = 3310208,
 208   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_STABLE = 3310209,
 209   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_BETA = 3310210,
 210   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_CROS_DEV = 3310211,
 211   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_CROS_STABLE = 3310212,
 212   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_CROS_BETA = 3310213,
 213   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_DEV = 3310214,
 214   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_STABLE = 3310215,
 215   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_BETA = 3310216,
 216   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_CROS_DEV = 3310217,
 217   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_CROS_STABLE = 3310218,
 218   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_CROS_BETA = 3310219,
 219   SEND_FEEDBACK_LINK_LOCATION_DEFAULT = 3310249,
 220
 221   // OmniboxStopTimer field trial.
 222   OMNIBOX_STOP_TIMER_CONTROL = 3310263,
 223   OMNIBOX_STOP_TIMER_EXPERIMENT = 3310264,
 224
 225   // ShowAppLauncherPromo field trial
 226   SHOW_APP_LAUNCHER_PROMO_UNTIL_DISMISSED = 3310366,
 227   SHOW_APP_LAUNCHER_PROMO_RESET_PREF = 3310367,
 228
 229   // CookieRetentionPriorityStudy field trial.
 230   COOKIE_RETENTION_PRIORITY_STUDY_EXPERIMENT_OFF = 3310869,
 231   COOKIE_RETENTION_PRIORITY_STUDY_EXPERIMENT_ON = 3310870,
 232
 233   // QUIC field trial.
 234   QUIC_FIELD_TRIAL_ID_MIN = 3311871,
 235   QUIC_FIELD_TRIAL_ID_MAX = 3311920,
 236
 237   // Android Native NTP trial.
 238   // Range: 3311921 - 3311940
 239   ANDROID_DEV_BETA_NATIVE_NTP_CONTROL_0 = 3311921,
 240   ANDROID_DEV_BETA_NATIVE_NTP_CONTROL_1 = 3311922,
 241   ANDROID_DEV_BETA_NATIVE_NTP_TWO_URL_BARS = 3311923,
 242   ANDROID_DEV_BETA_NATIVE_NTP_ONE_URL_BAR = 3311924,
 243   ANDROID_DEV_BETA_TABLET_NATIVE_NTP_CONTROL = 3311925,
 244   ANDROID_DEV_BETA_TABLET_NATIVE_NTP_TWO_URL_BARS = 3311926,
 245   ANDROID_STABLE_NATIVE_NTP_CONTROL_0 = 3311927,
 246   ANDROID_STABLE_NATIVE_NTP_CONTROL_1 = 3311928,
 247   ANDROID_STABLE_NATIVE_NTP_TWO_URL_BARS = 3311929,
 248   ANDROID_STABLE_NATIVE_NTP_ONE_URL_BAR = 3311930,
 249   ANDROID_STABLE_TABLET_NATIVE_NTP_CONTROL_0 = 3311931,
 250   ANDROID_STABLE_TABLET_NATIVE_NTP_TWO_URL_BARS = 3311932,
 251   ANDROID_STABLE_TABLET_NATIVE_NTP_CONTROL_1 = 3311933,
 252   ANDROID_M36_DEV_BETA_NATIVE_NTP_ONE_URL_BAR = 3311934,
 253   ANDROID_M36_DEV_BETA_TABLET_NATIVE_NTP_TWO_URL_BARS = 3311935,
 254   ANDROID_M36_STABLE_NATIVE_NTP_ONE_URL_BAR = 3311936,
 255   ANDROID_M36_STABLE_TABLET_NATIVE_NTP_TWO_URL_BARS = 3311937,
 256
 257   // WebGLDebugRendererInfo trial.
 258   WEBGL_DEBUG_RENDERER_INFO_ENABLED = 3311941,
 259   WEBGL_DEBUG_RENDERER_INFO_CONTROL = 3311942,
 260   WEBGL_DEBUG_RENDERER_INFO_DISABLED = 3311943,
 261
 262   NEW_USER_MANAGEMENT_ENABLED = 3311944,
 263   NEW_USER_MANAGEMENT_CONTROL = 3311945,
 264   NEW_USER_MANAGEMENT_DISABLED = 3311946,
 265
 266   // Reserve 100 more IDs to be used by autocomplete dynamic field trials.
 267   // The dynamic field trials are activated by a call to
 268   // OmniboxFieldTrial::ActivateDynamicFieldTrials.
 269   // For more details, see
 270   // chrome/browser/omnibox/omnibox_field_trial.{h,cc}.
 271   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE2_ID_MIN = 3311947,
 272   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE2_ID_MAX = 3312046,
 273
 274   // DEPRECATED - DO NOT USE
 275   // Name: IOSPhoneNewNTP
 276   // Range: 3312100 - 3312103, 3312112 - 3312113
 277   // Now retired.  But please don't reuse these IDs; they may taint
 278   // your experiment results.
 279   IOS_PHONE_NEW_NTP_2014_Q1_ID_MIN = 3312100,
 280   IOS_PHONE_NEW_NTP_2014_Q1_ID_MAX = 3312103,
 281   IOS_PHONE_NEW_NTP_2014_Q1_ID2_MIN = 3312112,
 282   IOS_PHONE_NEW_NTP_2014_Q1_ID2_MAX = 3312113,
 283
 284   // iOS Phone New NTP trial.
 285   // Range: 3312047 - 3312050 (Beta); 3312100 - 3312103 (Stable)
 286   //        3312112 - 3312113 (Stable); 3312372 (Stable)
 287   IOS_PHONE_NEW_NTP_OMNIBOX_HINT_BETA = 3312047,
 288   IOS_PHONE_NEW_NTP_CONTROL_1_BETA = 3312048,
 289   IOS_PHONE_NEW_NTP_FAKEBOX_HINT_BETA = 3312049,
 290   IOS_PHONE_NEW_NTP_CONTROL_2_BETA = 3312050,
 291   IOS_PHONE_NEW_NTP_OMNIBOX_HINT_STABLE = 3312114,
 292   IOS_PHONE_NEW_NTP_CONTROL_1_STABLE = 3312115,
 293   IOS_PHONE_NEW_NTP_FAKEBOX_HINT_STABLE = 3312116,
 294   IOS_PHONE_NEW_NTP_CONTROL_2_STABLE = 3312117,
 295   IOS_PHONE_NEW_NTP_HOLDBACK_STABLE = 3312372,
 296
 297   // iOS Tablet New NTP trial.
 298   // Range: 3312104 - 3312107 (Beta); 3312108 - 3312111 (Stable)
 299   //        3312373 (Stable)
 300   IOS_TABLET_NEW_NTP_OMNIBOX_HINT_BETA = 3312104,
 301   IOS_TABLET_NEW_NTP_CONTROL_1_BETA = 3312105,
 302   IOS_TABLET_NEW_NTP_FAKEBOX_HINT_BETA = 3312106,
 303   IOS_TABLET_NEW_NTP_CONTROL_2_BETA = 3312107,
 304   IOS_TABLET_NEW_NTP_OMNIBOX_HINT_STABLE = 3312108,
 305   IOS_TABLET_NEW_NTP_CONTROL_1_STABLE = 3312109,
 306   IOS_TABLET_NEW_NTP_FAKEBOX_HINT_STABLE = 3312110,
 307   IOS_TABLET_NEW_NTP_CONTROL_2_STABLE = 3312111,
 308   IOS_TABLET_NEW_NTP_HOLDBACK_STABLE = 3312373,
 309
 310   // ExtensionInstallPrompt field trial.
 311   EXTENSION_INSTALL_PROMPT_EXPERIMENT_ID_MIN = 3312051,
 312   EXTENSION_INSTALL_PROMPT_EXPERIMENT_ID_MAX = 3312099,
 313
 314   // <link rel=prefetch> field trial.
 315   LINK_REL_PREFETCH_ENABLED_1 = 3312118,
 316   LINK_REL_PREFETCH_ENABLED_2 = 3312119,
 317   LINK_REL_PREFETCH_DISABLED_1 = 3312120,
 318   LINK_REL_PREFETCH_DISABLED_2 = 3312121,
 319
 320   // Reserve 200 more IDs to be used by autocomplete dynamic field trials.
 321   // The dynamic field trials are activated by a call to
 322   // OmniboxFieldTrial::ActivateDynamicFieldTrials.
 323   // For more details, see
 324   // chrome/browser/omnibox/omnibox_field_trial.{h,cc}.
 325   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE3_ID_MIN = 3312122,
 326   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE3_ID_MAX = 3312321,
 327
 328   // Instant search clicks field trial.
 329   INSTANT_SEARCH_CLICKS_FIELD_TRIAL_ID_MIN = 3312322,
 330   INSTANT_SEARCH_CLICKS_FIELD_TRIAL_ID_MAX = 3312371,
 331
 332   // iOS Phone modal dialog field trial.
 333   IOS_PHONE_NTP_MODAL_DIALOG_ENABLED_1 = 3312374,
 334   IOS_PHONE_NTP_MODAL_DIALOG_ENABLED_2 = 3312375,
 335   IOS_PHONE_NTP_MODAL_DIALOG_CONTROL_1 = 3312376,
 336   IOS_PHONE_NTP_MODAL_DIALOG_CONTROL_2 = 3312377,
 337
 338   // Field trials can be queried directly from webrtc via webrtc::field_trial.
 339   // Thus new trials are added without explicit CLs in chromium repository.
 340   // This is the range of ids reserved for those trials.
 341   WEBRTC_FIELD_TRIAL_RANGE_ID_MIN = 3312378,
 342   WEBRTC_FIELD_TRIAL_RANGE_ID_MAX = 3312477,
 343
 344   // NEXT ID: When adding new IDs, please add them above this section, starting
 345   // with the value of NEXT_ID, and updating NEXT_ID to (end of your reserved
 346   // range) + 1.
 347   NEXT_ID = 3312478,
 348
 349   // USABLE IDs END HERE.
 350   //
 351   // The largest possible Chrome variation ID in the reserved range. When
 352   // defining your variation IDs, DO NOT exceed this value - GWS will ignore
 353   // your experiment!
 354   MAXIMUM_ID = 3399999,
 355 };
 356
 357 }  // namespace chrome_variations
 358
 359 #endif  // CHROME_COMMON_VARIATIONS_VARIATION_IDS_H_