Home | History | Annotate | Download | only in variations
      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_ONE_URL_BAR = 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_ONE_URL_BAR = 3311932,
    251   ANDROID_STABLE_TABLET_NATIVE_NTP_CONTROL_1 = 3311933,
    252 
    253   // WebGLDebugRendererInfo trial.
    254   WEBGL_DEBUG_RENDERER_INFO_ENABLED = 3311941,
    255   WEBGL_DEBUG_RENDERER_INFO_CONTROL = 3311942,
    256   WEBGL_DEBUG_RENDERER_INFO_DISABLED = 3311943,
    257 
    258   NEW_USER_MANAGEMENT_ENABLED = 3311944,
    259   NEW_USER_MANAGEMENT_CONTROL = 3311945,
    260   NEW_USER_MANAGEMENT_DISABLED = 3311946,
    261 
    262   // Reserve 100 more IDs to be used by autocomplete dynamic field trials.
    263   // The dynamic field trials are activated by a call to
    264   // OmniboxFieldTrial::ActivateDynamicFieldTrials.
    265   // For more details, see
    266   // chrome/browser/omnibox/omnibox_field_trial.{h,cc}.
    267   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE2_ID_MIN = 3311947,
    268   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE2_ID_MAX = 3312046,
    269 
    270   // DEPRECATED - DO NOT USE
    271   // Name: IOSPhoneNewNTP
    272   // Range: 3312100 - 3312103, 3312112 - 3312113
    273   // Now retired.  But please don't reuse these IDs; they may taint
    274   // your experiment results.
    275   IOS_PHONE_NEW_NTP_2014_Q1_ID_MIN = 3312100,
    276   IOS_PHONE_NEW_NTP_2014_Q1_ID_MAX = 3312103,
    277   IOS_PHONE_NEW_NTP_2014_Q1_ID2_MIN = 3312112,
    278   IOS_PHONE_NEW_NTP_2014_Q1_ID2_MAX = 3312113,
    279 
    280   // iOS Phone New NTP trial.
    281   // Range: 3312047 - 3312050 (Beta); 3312100 - 3312103 (Stable)
    282   //        3312112 - 3312113 (Stable); 3312372 (Stable)
    283   IOS_PHONE_NEW_NTP_OMNIBOX_HINT_BETA = 3312047,
    284   IOS_PHONE_NEW_NTP_CONTROL_1_BETA = 3312048,
    285   IOS_PHONE_NEW_NTP_FAKEBOX_HINT_BETA = 3312049,
    286   IOS_PHONE_NEW_NTP_CONTROL_2_BETA = 3312050,
    287   IOS_PHONE_NEW_NTP_OMNIBOX_HINT_STABLE = 3312114,
    288   IOS_PHONE_NEW_NTP_CONTROL_1_STABLE = 3312115,
    289   IOS_PHONE_NEW_NTP_FAKEBOX_HINT_STABLE = 3312116,
    290   IOS_PHONE_NEW_NTP_CONTROL_2_STABLE = 3312117,
    291   IOS_PHONE_NEW_NTP_HOLDBACK_STABLE = 3312372,
    292 
    293   // iOS Tablet New NTP trial.
    294   // Range: 3312104 - 3312107 (Beta); 3312108 - 3312111 (Stable)
    295   //        3312373 (Stable)
    296   IOS_TABLET_NEW_NTP_OMNIBOX_HINT_BETA = 3312104,
    297   IOS_TABLET_NEW_NTP_CONTROL_1_BETA = 3312105,
    298   IOS_TABLET_NEW_NTP_FAKEBOX_HINT_BETA = 3312106,
    299   IOS_TABLET_NEW_NTP_CONTROL_2_BETA = 3312107,
    300   IOS_TABLET_NEW_NTP_OMNIBOX_HINT_STABLE = 3312108,
    301   IOS_TABLET_NEW_NTP_CONTROL_1_STABLE = 3312109,
    302   IOS_TABLET_NEW_NTP_FAKEBOX_HINT_STABLE = 3312110,
    303   IOS_TABLET_NEW_NTP_CONTROL_2_STABLE = 3312111,
    304   IOS_TABLET_NEW_NTP_HOLDBACK_STABLE = 3312373,
    305 
    306   // ExtensionInstallPrompt field trial.
    307   EXTENSION_INSTALL_PROMPT_EXPERIMENT_ID_MIN = 3312051,
    308   EXTENSION_INSTALL_PROMPT_EXPERIMENT_ID_MAX = 3312099,
    309 
    310   // <link rel=prefetch> field trial.
    311   LINK_REL_PREFETCH_ENABLED_1 = 3312118,
    312   LINK_REL_PREFETCH_ENABLED_2 = 3312119,
    313   LINK_REL_PREFETCH_DISABLED_1 = 3312120,
    314   LINK_REL_PREFETCH_DISABLED_2 = 3312121,
    315 
    316   // Reserve 200 more IDs to be used by autocomplete dynamic field trials.
    317   // The dynamic field trials are activated by a call to
    318   // OmniboxFieldTrial::ActivateDynamicFieldTrials.
    319   // For more details, see
    320   // chrome/browser/omnibox/omnibox_field_trial.{h,cc}.
    321   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE3_ID_MIN = 3312122,
    322   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_RANGE3_ID_MAX = 3312321,
    323 
    324   // Instant search clicks field trial.
    325   INSTANT_SEARCH_CLICKS_FIELD_TRIAL_ID_MIN = 3312322,
    326   INSTANT_SEARCH_CLICKS_FIELD_TRIAL_ID_MAX = 3312371,
    327 
    328   // NEXT ID: When adding new IDs, please add them above this section, starting
    329   // with the value of NEXT_ID, and updating NEXT_ID to (end of your reserved
    330   // range) + 1.
    331   NEXT_ID = 3312374,
    332 
    333   // USABLE IDs END HERE.
    334   //
    335   // The largest possible Chrome variation ID in the reserved range. When
    336   // defining your variation IDs, DO NOT exceed this value - GWS will ignore
    337   // your experiment!
    338   MAXIMUM_ID = 3399999,
    339 };
    340 
    341 }  // namespace chrome_variations
    342 
    343 #endif  // CHROME_COMMON_VARIATIONS_VARIATION_IDS_H_
    344