Home | History | Annotate | Download | only in variations
      1 // Copyright (c) 2012 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_METRICS_VARIATIONS_VARIATION_IDS_H_
      6 #define CHROME_COMMON_METRICS_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 - 3300099
     35 // // The 5% Uniformity Trial. This is a reserved range.
     36 // UNIFORMITY_TRIAL_5_PERCENT_ID_START = 330000,
     37 // UNIFORMITY_TRIAL_5_PERCENT_ID_END   = 330099,
     38 //
     39 // Anything within the range of a uint32 should be castable to an ID, but
     40 // please ensure that they are within the range of the min and max values.
     41 enum VariationID {
     42   // Used to represent no associated Chrome variation ID.
     43   EMPTY_ID = 0,
     44 
     45   // The smallest possible Chrome Variation ID in the reserved range. The
     46   // first 10,000 values are reserved for internal variations infrastructure
     47   // use. Please do not use values in this range.
     48   MINIMIUM_ID = 3300000,
     49 
     50   // Name: UMA-Uniformity-Trial-1-Percent
     51   // Range: 3300000 - 3300099
     52   UNIFORMITY_1_PERCENT_BASE  = MINIMIUM_ID,
     53   UNIFORMITY_1_PERCENT_LIMIT = UNIFORMITY_1_PERCENT_BASE + 100,
     54   // Name: UMA-Uniformity-Trial-5-Percent
     55   // Range: 3300100 - 3300119
     56   UNIFORMITY_5_PERCENT_BASE  = UNIFORMITY_1_PERCENT_LIMIT,
     57   UNIFORMITY_5_PERCENT_LIMIT = UNIFORMITY_5_PERCENT_BASE + 20,
     58   // Name: UMA-Uniformity-Trial-10-Percent
     59   // Range: 3300120 - 3300129
     60   UNIFORMITY_10_PERCENT_BASE  = UNIFORMITY_5_PERCENT_LIMIT,
     61   UNIFORMITY_10_PERCENT_LIMIT = UNIFORMITY_10_PERCENT_BASE + 10,
     62   // Name: UMA-Uniformity-Trial-20-Percent
     63   // Range: 3300130 - 3300134
     64   UNIFORMITY_20_PERCENT_BASE  = UNIFORMITY_10_PERCENT_LIMIT,
     65   UNIFORMITY_20_PERCENT_LIMIT = UNIFORMITY_20_PERCENT_BASE + 5,
     66   // Name: UMA-Uniformity-Trial-50-Percent
     67   // Range: 3300135 - 3300136
     68   UNIFORMITY_50_PERCENT_BASE  = UNIFORMITY_20_PERCENT_LIMIT,
     69   UNIFORMITY_50_PERCENT_LIMIT = UNIFORMITY_50_PERCENT_BASE+ 2,
     70 
     71   // Name: UMA-Dynamic-Binary-Uniformity-Trial
     72   // The dynamic uniformity trial is only specified on the server, this is just
     73   // to reserve the id.
     74   DYNAMIC_UNIFORMITY_ID_DEFAULT = 3300137,
     75   DYNAMIC_UNIFORMITY_ID_GROUP_1 = 3300138,
     76 
     77   // Name: UMA-Session-Randomized-Uniformity-Trial-5-Percent
     78   // Range: 3300139 - 3300158
     79   // A uniformity trial used to compare one-time-randomized and
     80   // session-randomized FieldTrials.
     81   UNIFORMITY_SESSION_RANDOMIZED_5_PERCENT_BASE  = 3300139,
     82   UNIFORMITY_SESSION_RANDOMIZED_5_PERCENT_LIMIT =
     83       UNIFORMITY_SESSION_RANDOMIZED_5_PERCENT_BASE + 20,
     84 
     85   // Name: UMA-Dynamic-Uniformity-Trial
     86   // Range: 3300159 - 3300165
     87   UNIFORMITY_DYNAMIC_TRIAL_BASE = 3300159,
     88   UNIFORMITY_DYNAMIC_TRIAL_LIMIT = UNIFORMITY_DYNAMIC_TRIAL_BASE + 6,
     89 
     90   // Some values reserved for unit and integration tests.
     91   TEST_VALUE_A = 3300200,
     92   TEST_VALUE_B = 3300201,
     93   TEST_VALUE_C = 3300202,
     94   TEST_VALUE_D = 3300203,
     95 
     96   // USABLE IDs BEGIN HERE.
     97   //
     98   // The smallest possible Chrome Variation ID for use in real FieldTrials. If
     99   // you are defining variation IDs for your own FieldTrials, NEVER use a value
    100   // lower than this.
    101   MINIMUM_USER_ID = 3310000,
    102 
    103   // Add new variation IDs below.
    104 
    105   // DEPRECATED - DO NOT USE
    106   // Name: OmniboxSearchSuggest
    107   // Range: 3310000 - 3310019
    108   // Now retired.  But please don't reuse these IDs; they may taint
    109   // your experiment results.
    110   SUGGEST_ID_MIN = 3310000,
    111   SUGGEST_ID_MAX = 3310019,
    112 
    113   // Instant field trial.
    114   INSTANT_ID_CONTROL = 3310020,
    115   INSTANT_ID_SILENT  = 3310021,
    116   INSTANT_ID_HIDDEN  = 3310022,
    117   INSTANT_ID_SUGGEST = 3310023,
    118   INSTANT_ID_INSTANT = 3310024,
    119 
    120   // Instant dummy field trial.
    121   DUMMY_INSTANT_ID_DEFAULT      = 3310025,
    122   DUMMY_INSTANT_ID_CONTROL      = 3310026,
    123   DUMMY_INSTANT_ID_EXPERIMENT_1 = 3310027,
    124   DUMMY_INSTANT_ID_EXPERIMENT_2 = 3310028,
    125   DUMMY_INSTANT_ID_EXPERIMENT_3 = 3310049,
    126 
    127   // DEPRECATED - DO NOT USE
    128   // Name: OmniboxSearchSuggestStarted2012Q4
    129   // Range: 3310029 - 3310048
    130   // Now retired.  But please don't reuse these IDs; they may taint
    131   // your experiment results.
    132   SUGGEST_TRIAL_STARTED_2012_Q4_ID_MIN = 3310029,
    133   SUGGEST_TRIAL_STARTED_2012_Q4_ID_MAX = 3310048,
    134 
    135   // Name: Instant channel and extended field trials.
    136   // Range: 3310050 - 3310059
    137   CHANNEL_INSTANT_ID_BETA            = 3310050,
    138   CHANNEL_INSTANT_ID_DEV             = 3310051,
    139   CHANNEL_INSTANT_ID_STABLE          = 3310052,
    140   EXTENDED_INSTANT_ID_CANARY_GROUP_1 = 3310053,
    141   EXTENDED_INSTANT_ID_CANARY_CONTROL = 3310054,
    142   EXTENDED_INSTANT_ID_DEV_GROUP_1    = 3310055,
    143   EXTENDED_INSTANT_ID_DEV_CONTROL    = 3310056,
    144 
    145   // DEPRECATED - DO NOT USE
    146   // Name: OmniboxSearchSuggestTrialStarted2013Q1
    147   // Range: 3310060 - 3310079
    148   // Now retired.  But please don't reuse these IDs; they may taint
    149   // your experiment results.
    150   SUGGEST_TRIAL_STARTED_2013_Q1_ID_MIN = 3310060,
    151   SUGGEST_TRIAL_STARTED_2013_Q1_ID_MAX = 3310079,
    152 
    153   // Name: More IDs for the InstantExtended field trial.
    154   // Range: 3310080 - 3310085
    155   EXTENDED_INSTANT_ID_UNUSED_1            = 3310080,
    156   EXTENDED_INSTANT_ID_UNUSED_2            = 3310081,
    157   EXTENDED_INSTANT_ID_CANARY_CONTROL_2    = 3310082,
    158   EXTENDED_INSTANT_ID_DEV_CONTROL_2       = 3310083,
    159   EXTENDED_INSTANT_ID_CANARY_GROUP_2      = 3310084,
    160   EXTENDED_INSTANT_ID_DEV_GROUP_2         = 3310085,
    161   EXTENDED_INSTANT_ID_BETA_CONTROL_1      = 3310250,
    162   EXTENDED_INSTANT_ID_BETA_CONTROL_2      = 3310251,
    163   EXTENDED_INSTANT_ID_BETA_GROUP_1        = 3310252,
    164   EXTENDED_INSTANT_ID_BETA_GROUP_2        = 3310253,
    165   EXTENDED_INSTANT_ID_DEV_FRESH_CONTROL_1 = 3310254,
    166   EXTENDED_INSTANT_ID_DEV_FRESH_CONTROL_2 = 3310255,
    167   EXTENDED_INSTANT_ID_DEV_FRESH_GROUP_1   = 3310256,
    168   EXTENDED_INSTANT_ID_DEV_FRESH_GROUP_2   = 3310257,
    169   EXTENDED_INSTANT_ID_DEV_HOLDBACK        = 3310258,
    170   EXTENDED_INSTANT_ID_DEV_OFFLINE_1       = 3310259,
    171   EXTENDED_INSTANT_ID_DEV_OFFLINE_2       = 3310260,
    172   EXTENDED_INSTANT_ID_DEV_INSTANT_1       = 3310261,
    173   EXTENDED_INSTANT_ID_DEV_INSTANT_2       = 3310262,
    174   // Reserve a contiguous chunk of IDs for Instant Extended.
    175   EXTENDED_INSTANT_RANGE_ID_MIN           = 3310265,
    176   EXTENDED_INSTANT_RANGE_ID_MAX           = 3310365,
    177   EXTENDED_INSTANT_RANGE2_ID_MIN          = 3310368,
    178   EXTENDED_INSTANT_RANGE2_ID_MAX          = 3310868,
    179 
    180   // Reserve 100 IDs to be used by autocomplete dynamic field trials.
    181   // The dynamic field trials are activated by a call to
    182   // OmniboxFieldTrial::ActivateDynamicFieldTrials.
    183   // For more details, see
    184   // chrome/browser/omnibox/omnibox_field_trial.{h,cc}.
    185   AUTOCOMPLETE_DYNAMIC_FIELD_TRIAL_ID_MIN = 3310086,
    186   AUTOCOMPLETE_DYANMIC_FIELD_TRIAL_ID_MAX = 3310185,
    187 
    188   // BookmarkPrompt field trial.
    189   BOOKMARK_PROMPT_TRIAL_DEFAULT = 3310186,
    190   BOOKMARK_PROMPT_TRIAL_CONTROL = 3310187,
    191   BOOKMARK_PROMPT_TRIAL_EXPERIMENT = 3310188,
    192 
    193   // iOS tour trial.
    194   IOS_TOUR_DEFAULT = 3310189,
    195   IOS_TOUR_EXPERIMENT = 3310190,
    196 
    197   // Name: SendFeedbackLinkLocation.
    198   // Field trial to test various locations, and strings
    199   // for submitting feedback.
    200   SEND_FEEDBACK_LINK_LOCATION_CONTROL = 3310200,
    201   SEND_FEEDBACK_LINK_LOCATION_CONTROL_CROS = 3310201,
    202   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_DEV = 3310202,
    203   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_STABLE = 3310203,
    204   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_BETA = 3310204,
    205   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_CROS_DEV = 3310205,
    206   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_CROS_STABLE = 3310206,
    207   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_CROS_BETA = 3310207,
    208   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_DEV = 3310208,
    209   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_STABLE = 3310209,
    210   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_BETA = 3310210,
    211   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_CROS_DEV = 3310211,
    212   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_CROS_STABLE = 3310212,
    213   SEND_FEEDBACK_LINK_LOCATION_ALT_LOCATION_CROS_BETA = 3310213,
    214   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_DEV = 3310214,
    215   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_STABLE = 3310215,
    216   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_BETA = 3310216,
    217   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_CROS_DEV = 3310217,
    218   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_CROS_STABLE = 3310218,
    219   SEND_FEEDBACK_LINK_LOCATION_ALT_TEXT_AND_LOCATION_CROS_BETA = 3310219,
    220   SEND_FEEDBACK_LINK_LOCATION_DEFAULT = 3310249,
    221 
    222   // OmniboxStopTimer field trial.
    223   OMNIBOX_STOP_TIMER_CONTROL = 3310263,
    224   OMNIBOX_STOP_TIMER_EXPERIMENT = 3310264,
    225 
    226   // ShowAppLauncherPromo field trial
    227   SHOW_APP_LAUNCHER_PROMO_UNTIL_DISMISSED = 3310366,
    228   SHOW_APP_LAUNCHER_PROMO_RESET_PREF = 3310367,
    229 
    230   // CookieRetentionPriorityStudy field trial.
    231   COOKIE_RETENTION_PRIORITY_STUDY_EXPERIMENT_OFF = 3310869,
    232   COOKIE_RETENTION_PRIORITY_STUDY_EXPERIMENT_ON = 3310870,
    233 
    234   // NEXT ID: When adding new IDs, please add them above this section, starting
    235   // with the value of NEXT_ID, and updating NEXT_ID to (end of your reserved
    236   // range) + 1.
    237   NEXT_ID = 3310871,
    238 
    239   // USABLE IDs END HERE.
    240   //
    241   // The largest possible Chrome variation ID in the reserved range. When
    242   // defining your variation IDs, DO NOT exceed this value - GWS will ignore
    243   // your experiment!
    244   MAXIMUM_ID = 3399999,
    245 };
    246 
    247 }  // namespace chrome_variations
    248 
    249 #endif  // CHROME_COMMON_METRICS_VARIATIONS_VARIATION_IDS_H_
    250