• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1// Copyright 2014 The Chromium Authors
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5syntax = "proto2";
6
7option optimize_for = LITE_RUNTIME;
8option java_package = "org.chromium.components.metrics";
9
10option java_outer_classname = "OmniboxEventProtos";
11
12package metrics;
13
14import "omnibox_input_type.proto";
15
16// Stores information about an omnibox interaction.
17// Next tag: 27
18message OmniboxEventProto {
19  // The timestamp for the event, in seconds.
20  // This value comes from Chromium's TimeTicks::Now(), which is an abstract
21  // time value that is guaranteed to always be non-decreasing (regardless of
22  // Daylight Saving Time or any other changes to the system clock).
23  // These numbers are only comparable within a session.  To sequence events
24  // across sessions, order by the |session_id| from the
25  // ChromeUserMetricsExtension message.
26  optional int64 time_sec = 1;
27
28  // The id of the originating tab for this omnibox interaction.
29  // This is the current tab *unless* the user opened the target in a new tab.
30  // In those cases, this is unset.  Tab ids are unique for a given session_id
31  // (in the containing protocol buffer ChromeUserMetricsExtensionProto).
32  optional int32 tab_id = 2;
33
34  // The number of characters the user had typed before autocompleting.
35  optional int32 typed_length = 3;
36
37  // Whether the user deleted text immediately before selecting an omnibox
38  // suggestion.  This is usually the result of pressing backspace or delete.
39  optional bool just_deleted_text = 11;
40
41  // The number of terms that the user typed in the omnibox.
42  optional int32 num_typed_terms = 4;
43
44  // The index of the item that the user selected in the omnibox popup list.
45  // This corresponds the index of the |suggestion| below.
46  optional int32 selected_index = 5;
47
48  // Whether the user selected the option to switch tabs (or ignored it
49  // and navigated). If true, one or more |Suggestions| will have
50  // |has_tab_match| set as well, which must include the |selected_index|.
51  optional bool selected_tab_match = 17;
52
53  // DEPRECATED. Whether or not the top match was hidden in the omnibox
54  // suggestions dropdown.
55  optional bool DEPRECATED_is_top_result_hidden_in_dropdown = 14
56      [deprecated = true];
57
58  // Whether the omnibox popup is open.  It can be closed if, for instance,
59  // the user clicks in the omnibox and hits return to reload the same page.
60  // If the popup is closed, the suggestion list will contain only one item
61  // and selected_index will be 0 (pointing to that single item).  Because
62  // paste-and-search/paste-and-go actions ignore the current content of the
63  // omnibox dropdown (if it is open) when they happen, we pretend the
64  // dropdown is closed when logging these.
65  optional bool is_popup_open = 15;
66
67  // True if this is a paste-and-search or paste-and-go action.  (The codebase
68  // refers to both these types as paste-and-go.)
69  optional bool is_paste_and_go = 16;
70
71  // The length of the inline autocomplete text in the omnibox.
72  // The sum |typed_length| + |completed_length| gives the full length of the
73  // user-visible text in the omnibox.
74  // This field is only set for suggestions that are allowed to be the default
75  // match and omitted otherwise.  The first suggestion is always allowed to
76  // be the default match.  (This is an enforced constraint.)  Hence, if
77  // |selected_index| == 0, then this field will always be set.
78  optional int32 completed_length = 6;
79
80  // The amount of time, in milliseconds, since the user first began modifying
81  // the text in the omnibox.  If at some point after modifying the text, the
82  // user reverts the modifications (thus seeing the current web page's URL
83  // again), then writes in the omnibox again, this elapsed time should start
84  // from the time of the second series of modification.
85  optional int64 typing_duration_ms = 7;
86
87  // The amount of time, in milliseconds, since the last time the default
88  // (inline) match changed.  This may be longer than the time since the
89  // last keystroke.  (The last keystroke may not have changed the default
90  // match.)  It may also be shorter than the time since the last keystroke
91  // because the default match might have come from an asynchronous
92  // provider.  Regardless, it should always be less than or equal to
93  // the field |typing_duration_ms|.
94  optional int64 duration_since_last_default_match_update_ms = 13;
95
96  // The type of page the user was on when they used the omnibox. Or the type of
97  // page for which suggestions were prefetched from the server.
98  enum PageClassification {
99    // An invalid URL; shouldn't happen.
100    INVALID_SPEC = 0;
101
102    // chrome://newtab/.  For modern versions of Chrome, this is only reported
103    // when an extension is replacing the new tab page. Otherwise, new tab
104    // page interactions will be reported as NTP_REALBOX,
105    // INSTANT_NTP_WITH_FAKEBOX_AS_STARTING_FOCUS or
106    // INSTANT_NTP_WITH_OMNIBOX_AS_STARTING_FOCUS.
107    // For old versions of Chrome, this was reported for the default New Tab
108    // Page.
109    NTP = 1;
110
111    // about:blank.
112    BLANK = 2;
113
114    // The user's home page.  Note that if the home page is set to any
115    // of the new tab page versions or to about:blank, then we'll
116    // classify the page into those categories, not HOME_PAGE.
117    HOME_PAGE = 3;
118
119    // The catch-all entry of everything not included somewhere else
120    // on this list.
121    OTHER = 4;
122
123    // The instant new tab page.
124    OBSOLETE_INSTANT_NTP = 5;  // DEPRECATED on August 2, 2013.
125
126    // The user is on a search result page that does search term replacement.
127    // This means the search terms are shown in the omnibox instead of the URL.
128    // In other words: Query in Omnibox is Active for this SRP.
129    SEARCH_RESULT_PAGE_DOING_SEARCH_TERM_REPLACEMENT = 6;
130
131    // The new tab page in which this omnibox interaction first started
132    // with the user having focus in the omnibox.
133    INSTANT_NTP_WITH_OMNIBOX_AS_STARTING_FOCUS = 7;
134
135    // The new tab page in which this omnibox interaction first started with the
136    // user having focus in the fakebox. This is replaced by NTP_REALBOX.
137    // DEPRECATED on Aug 17, 2020.
138    INSTANT_NTP_WITH_FAKEBOX_AS_STARTING_FOCUS = 8;
139
140    // The user is on a search result page that does not do search term
141    // replacement. This means the URL of the SRP is shown in the omnibox.
142    // In other words: Query in Omnibox is Inactive for this SRP.
143    SEARCH_RESULT_PAGE_NO_SEARCH_TERM_REPLACEMENT = 9;
144
145    // The user is on the home screen.
146    APP_HOME = 10;
147
148    // The user is in the search app.
149    APP_SEARCH = 11;
150
151    // The user is in the maps app.
152    APP_MAPS = 12;
153
154    // This omnibox interaction started with the user tapping the search button.
155    SEARCH_BUTTON_AS_STARTING_FOCUS = 13;
156
157    // This interaction started with the user focusing or typing in the search
158    // box of the ChromeOS app list (a.k.a., launcher).
159    CHROMEOS_APP_LIST = 14;
160
161    // The new tab page in which this omnibox interaction started with the user
162    // having focus in the realbox.
163    NTP_REALBOX = 15;
164
165    // Android's Search Widget started directly from Launcher.
166    ANDROID_SEARCH_WIDGET = 16;
167
168    // Android's Start surface homepage.
169    START_SURFACE_HOMEPAGE = 17;  // DEPRECATED on Jun 17, 2022.
170    // New Tab with Omnibox focused with Android's start surface finale enabled.
171    START_SURFACE_NEW_TAB = 18;  // DEPRECATED on Jun 17, 2022.
172
173    // Android's improved Search Widget with new suggestions.
174    ANDROID_SHORTCUTS_WIDGET = 19;
175
176    // The New Tab Page zero-prefix suggestion prefetch.
177    // Used for prefetching suggestions and should never appear in an
178    // OmniboxEventProto or any of its derived histograms. (PageClassification
179    // enum is used in other places too, and not only OmniboxEventProto.)
180    NTP_ZPS_PREFETCH = 20;
181
182    // Used for Journeys requests in its landing page, side Panel or the NTP.
183    // Should never appear in an OmniboxEventProto or any of its derived
184    // histograms. (PageClassification enum is used in other places too, and not
185    // only OmniboxEventProto.)
186    JOURNEYS = 21;
187
188    // The Search Results Page zero-prefix suggestion prefetch.
189    // Used for prefetching suggestions and should never appear in an
190    // OmniboxEventProto or any of its derived histograms. (PageClassification
191    // enum is used in other places too, and not only OmniboxEventProto.)
192    SRP_ZPS_PREFETCH = 22;
193
194    // The catch-all zero-prefix suggestion prefetch for everything other than
195    // NTP and SRP.
196    // Used for prefetching suggestions and should never appear in an
197    // OmniboxEventProto or any of its derived histograms. (PageClassification
198    // enum is used in other places too, and not only OmniboxEventProto.)
199    OTHER_ZPS_PREFETCH = 23;
200
201    // When adding new classifications, please consider adding them in
202    // chromium's chrome/browser/resources/omnibox/omnibox.html
203    // so that these new options are displayed on about:omnibox.
204  }
205  optional PageClassification current_page_classification = 10;
206
207  enum ModeType {
208    // Unknown type (should not be reported).
209    UNKNOWN_MODE = 0;
210    // This user is in web mode when looking for suggestions.
211    WEB_MODE = 1;
212    // This user is in image mode when looking for suggestions.
213    IMAGE_MODE = 2;
214  }
215  optional ModeType mode_type = 18;
216
217  optional OmniboxInputType input_type = 8;
218
219  // An enum used in multiple places below.
220  enum ProviderType {
221    UNKNOWN_PROVIDER = 0;  // Unknown provider (should not reach here)
222    HISTORY_URL = 1;       // URLs in history, or user-typed URLs
223    HISTORY_CONTENTS = 2;  // Matches for page contents of pages in history
224    HISTORY_QUICK = 3;     // Matches for recently or frequently visited pages
225                           // in history
226    SEARCH = 4;            // Search suggestions for the default search engine
227    KEYWORD = 5;           // Keyword-triggered searches
228    BUILTIN = 6;           // Built-in URLs, such as chrome://version
229    SHORTCUTS = 7;         // Recently selected omnibox suggestions
230    EXTENSION_APPS = 8;    // DEPRECATED. Suggestions from extensions or apps
231    CONTACT = 9;           // DEPRECATED. The user's contacts
232    BOOKMARK = 10;         // The user's bookmarks
233    ZERO_SUGGEST = 11;     // Suggestions based on the current page
234    // This enum value is currently only used by Android GSA. It represents
235    // a suggestion from the phone powered by go/icing.
236    ON_DEVICE = 12;
237    // This enum value is currently only used by Android GSA. It represents
238    // a suggestion powered by a Chrome content provider.
239    ON_DEVICE_CHROME = 13;
240    CLIPBOARD = 14;     // Suggestion coming from clipboard.
241    PHYSICAL_WEB = 15;  // DEPRECATED. Suggestions triggered by URLs broadcast
242                        // by nearby devices.
243    DOCUMENT = 16;      // Suggestions for documents in a cloud corpus.
244    // Non personalized query suggestions generated from a lightweight on device
245    // head model.
246    ON_DEVICE_HEAD = 17;
247    // Zero-prefix query suggestions based on device local history.
248    ZERO_SUGGEST_LOCAL_HISTORY = 18;
249    // Only used by Android Chrome. Represents a suggestion showing query tiles
250    // that users can tap on for bulding queries.
251    QUERY_TILE = 19;
252    // Clusters generated on-device from the user's Chrome history.
253    HISTORY_CLUSTER = 20;
254    // Suggestions from history derived from input with automatic corrections.
255    HISTORY_FUZZY = 21;
256    // URLs amongst the user's currently open tabs.
257    OPEN_TAB = 22;
258  }
259
260  // The result set displayed on the completion popup
261  // Next tag: 11
262  message Suggestion {
263    // Where does this result come from?
264    optional ProviderType provider = 1;
265
266    // What kind of result this is.
267    // This corresponds to the AutocompleteMatch::Type enumeration in
268    // components/omnibox/autocomplete_match.h
269    // (except for Android GSA result types).
270    enum ResultType {
271      UNKNOWN_RESULT_TYPE = 0;    // Unknown type (should not reach here)
272      URL_WHAT_YOU_TYPED = 1;     // The input as a URL
273      HISTORY_URL = 2;            // A past page whose URL contains the input
274      HISTORY_TITLE = 3;          // A past page whose title contains the input
275      HISTORY_BODY = 4;           // DEPRECATED. A past page whose body
276                                  // contains the input
277      HISTORY_KEYWORD = 5;        // A past page whose keyword contains the
278                                  // input
279      NAVSUGGEST = 6;             // A suggested URL
280                                  //
281                                  // result_subtype_identifier is currently used
282                                  // for contextual zero-suggest suggestions
283                                  // provided by the experimental service (note
284                                  // that not all NAVSUUGGEST suggestions come
285                                  // from the experimental service).
286                                  // For subtype definitions, please contact
287                                  // gcomanici@chromium.org.
288      SEARCH_WHAT_YOU_TYPED = 7;  // The input as a search query (with the
289                                  // default engine)
290      SEARCH_HISTORY = 8;         // A past search (with the default engine)
291                                  // containing the input
292      SEARCH_SUGGEST = 9;         // A suggested search (with the default
293                                  // engine) for a query.
294      SEARCH_OTHER_ENGINE = 10;   // A search with a non-default engine
295      EXTENSION_APP = 11;         // DEPRECATED. An Extension App with a
296                                  // title/url that contains the input.
297      CONTACT = 12;               // One of the user's contacts
298      BOOKMARK_TITLE = 13;        // A bookmark with a title/url that contains
299                                  // the input.
300      SEARCH_SUGGEST_ENTITY = 14;  // A suggested search for an entity.
301      SEARCH_SUGGEST_TAIL = 15;    // A suggested search to complete the tail of
302                                   // the query.
303      SEARCH_SUGGEST_PERSONALIZED = 16;  // A personalized suggested search.
304      SEARCH_SUGGEST_PROFILE = 17;   // A personalized suggested search for a
305                                     // Google+ profile.
306      APP_RESULT = 18;               // Result from an installed app
307                                     // (eg: a gmail email).
308                                     // Used by Android GSA for on-device
309                                     // suggestion logging.
310      APP = 19;                      // An app result (eg: the gmail app).
311                                     // Used by Android GSA for on-device
312                                     // suggestion logging.
313      LEGACY_ON_DEVICE = 20;         // An on-device result from a legacy
314                                     // provider. That is, this result is not
315                                     // from the on-device suggestion provider
316                                     // (go/icing). This field is
317                                     // used by Android GSA for on-device
318                                     // suggestion logging.
319      NAVSUGGEST_PERSONALIZED = 21;  // A personalized url.
320      SEARCH_SUGGEST_ANSWER = 22;    // DEPRECATED. Answers no longer have their
321                                     // own type but instead can be attached to
322                                     // suggestions of any type.
323      CALCULATOR = 23;               // A calculator answer.
324      CLIPBOARD_URL = 24;            // An URL based on the clipboard.
325      PHYSICAL_WEB = 25;             // DEPRECATED. A Physical Web nearby URL.
326      PHYSICAL_WEB_OVERFLOW = 26;  // DEPRECATED. An item representing multiple
327                                   // Physical Web nearby URLs.
328      DOCUMENT = 27;               // An item representing a cloud document
329                                   // suggestion.
330      CLIPBOARD_TEXT = 28;         // Text based on the clipboard.
331      CLIPBOARD_IMAGE = 29;        // An image based on the clipboard.
332      TILE_SUGGESTION = 30;        // A search query from Chrome Query Tiles
333                                   // feature. Only used by Android.
334      HISTORY_CLUSTER = 31;        // A past page that is a member of a cluster
335                                   // (an aggregation of related searches and
336                                   // URLs from the user's history) that
337                                   // contains the input (the input might or
338                                   // might not also match the title or URL of
339                                   // this page).
340      OPEN_TAB = 32;      // A currently open tab whose URL contains the input.
341      STARTER_PACK = 33;  // A built-in URL suggestion specifically created for
342                          // the starter pack keyword mode chip to attach to.
343    }
344    optional ResultType result_type = 2;
345
346    // The relevance score for this suggestion.
347    optional int32 relevance = 3;
348
349    // How many times this result was typed in / selected from the omnibox
350    // in this profile.
351    // Only set for some providers and result_types.  At the time of
352    // writing this comment, it is only set for HistoryURL and
353    // HistoryQuickProvider matches.
354    optional int32 typed_count = 5;
355
356    // Whether this item is starred (bookmarked) in this profile.
357    optional bool is_starred = 4 [deprecated = true];
358
359    // Whether this item is disabled in the UI (not clickable).
360    optional bool is_disabled = 6;
361
362    // Used to identify the specific source / type for suggestions by the
363    // suggest server. The meaning of individual values is determined by the
364    // provider of each suggestion type and is different for every suggestion
365    // type. See enum ResultType above for more details.
366    optional int32 result_subtype_identifier = 7;
367
368    // Whether the suggestion presented in the match, regardless of type,
369    // matched an open tab.
370    optional bool has_tab_match = 8;
371
372    // Whether this suggestion came associated with a keyword.  Does not include
373    // suggestions that came from the default search engine unless the search
374    // engine was explicitly invoked.  As two common examples,
375    // |is_keyword_suggestion| will be true for suggestions from explicitly-
376    // invoked suggestions (whether from a search engine or an extension).  It
377    // will also be true for suggestions from a keyword that wasn't explicitly
378    // requested.  For example, if a user has Google as their default search
379    // engine, the input "bing testing" will often show a suggestion to "Search
380    // Bing for testing" in the dropdown.  This suggestion will be marked as
381    // |is_keyword_suggestion|.
382    optional bool is_keyword_suggestion = 9;
383
384    // Signals for machine learning scoring.
385    // See details: http://shortn/_B21YgmkLs9.
386    // Currently, this message is only populated for URL suggestions
387    // (excluding Navsuggest and Document URLs) and only when there is a click
388    // on a URL suggestion.
389    // Only recorded on desktop platforms (Windows, Mac, Linux, ChromeOS).
390    // Next tag: 25
391    message ScoringSignals {
392      // Number of times the URL was navigated to using the Omnibox for this
393      // profile on this device, and all other devices syncing with this
394      // profile. Only include typed visits from the last 90 days. Discounted by
395      // a time-decaying factor with a 30-day half-life based on the last visit
396      // timestamp.
397      optional int32 typed_count = 1;
398      // Number of times the URL was visited in general for this profile on this
399      // device. Note that this will soon be across syncing devices with the
400      // rollout of full history sync in 2023. Only include visits from the last
401      // 90 days. Discounted by a time-decaying factor with a 30-day half-life
402      // based on the last visit timestamp.
403      optional int32 visit_count = 2;
404      // Elapsed time since last visit for this profile on this device. Uses the
405      // local client-side timestamps. Can be unreliable as local times can
406      // change in between different runs of Chrome.
407      optional int64 elapsed_time_last_visit_secs = 3;
408      // Number of times the suggestion was visited with the current input or
409      // prefix of it for this profile on this device.
410      // Discounted by a time-decaying factor with a 1-week half-life based on
411      // the last visit timestamp.
412      optional int32 shortcut_visit_count = 4;
413      // Length of the shortest shortcut text.
414      // Useful in comparison with |typed_length|.
415      optional int32 shortest_shortcut_len = 5;
416      // Elapsed time since last shortcut visit for this profile on this device.
417      // Uses the local client-side timestamps. Can be unreliable as local times
418      // can change in between different runs of Chrome.
419      optional int64 elapsed_time_last_shortcut_visit_sec = 6;
420      // URL points to the root page of a website, i.e., no query, path words,
421      // or references after "/".
422      optional bool is_host_only = 7;
423      // Number of bookmarks for this profile with this URL.
424      optional int32 num_bookmarks_of_url = 8;
425      // Position of the first matched bookmark title term.
426      // E.g. 4 for input 'x' and title "0123x56".
427      // Not set when there is no match in the bookmark title.
428      optional int32 first_bookmark_title_match_position = 9;
429      // Total length of matched strings in the bookmark title. Can be larger
430      // than the input text length. The input text is split by whitespaces, and
431      // each input word is matched against the title separately. Their matching
432      // lengths are summed. Similarly for other text matching signals below.
433      // E.g. 9 for input "[abc] ijk [xyz]" and title "[abc] def [xyz] - [xyz]".
434      // Set to 0 when there is no match in the title.
435      optional int32 total_bookmark_title_match_length = 10;
436      // Number of input terms matched by bookmark title. Take the maximum when
437      // there are multiple matching bookmarks of this URL.
438      // E.g., 1 for input "[a] b" and bookmark title "[a] book title".
439      // Not set when the user does not have this URL bookmarked.
440      optional int32 num_input_terms_matched_by_bookmark_title = 11;
441      // Position of the first matched URL substring.
442      // URL scheme or TLD matches are excluded, though those characters are
443      // counted when assessing match position. E.g., 11 for 't' in
444      // "https://hos[t].com" Not set when there is no URL match.
445      optional int32 first_url_match_position = 12;
446      // Total length of the matched URL strings. Can be longer than the input
447      // string. E.g., Given input "ab abc" and url "abc.com/ab", total is 7 (4
448      // for "ab" in "[ab]c.com/[ab]" and 3 for "abc" in
449      // "[abc].com"). Set to 0 when there is no URL string match.
450      optional int32 total_url_match_length = 13;
451      // One word matches host at a word boundary. E.g., true for input "[h] a"
452      // and "[h].com", Set to false when there are matches in the host but none
453      // at word boundaries. E.g., false for input "a" and "h[a].com". Not set
454      // when there is no host match.
455      optional bool host_match_at_word_boundary = 14;
456      // Total length of the matched host substrings.
457      // Can be larger than the input text.
458      // E.g., 3 for input "h a" and "[h]ost[aa].com".
459      // Set to 0 when there is no host match.
460      optional int32 total_host_match_length = 15;
461      // Total length of the matched substrings in the path at word boundaries.
462      // Can be larger than the input text. E.g. 3 for 'p' in
463      // 'a.com/[p]ath_[p]ath/[p]ath'. Set to 0 when there are no such matches.
464      optional int32 total_path_match_length = 16;
465      // Total length of the matched substrings in the query_or_ref at word
466      // boundaries. Can be larger than the input text.
467      // E.g., 3 for input '[qu] [a]' and 'a.com/a?[qu]ery_[a]'.
468      // Set to 0 when there are no such matches.
469      optional int32 total_query_or_ref_match_length = 17;
470      // Total length of the matched substrings in the page title at word
471      // boundaries. Can be larger than the input text.
472      // E.g., 2 for input "[a] [t] x" and page title "[a]bc [t]itle".
473      // Set to 0 when there is no title match.
474      optional int32 total_title_match_length = 18;
475      // Has matches that are not in schemes (e.g., "https") or "www".
476      optional bool has_non_scheme_www_match = 19;
477      // Number of input terms matched by title.
478      // E.g., 1 for input "[a] b" and title "[a] title [a]".
479      // Useful in comparison with |num_typed_terms|.
480      optional int32 num_input_terms_matched_by_title = 20;
481      // Number of input terms matched by url.
482      // Useful in comparison with |num_typed_terms|.
483      // E.g., 1 for input "[a] b" and url "[a].com".
484      optional int32 num_input_terms_matched_by_url = 21;
485      // Length of url. E.g., 22 for "https://www.host.com/p".
486      optional int32 length_of_url = 22;
487      // Site engagement score for the site the URL is on. See
488      // https://www.chromium.org/developers/design-documents/site-engagement/
489      optional float site_engagement = 23;
490      // True if url can be default match.
491      // Currently, this requires single-term input, and match needs to begin
492      // immediately after '', scheme, or 'http://www' in the URL, e.g., given
493      // input 'w', true for "https://www.[w]sj.com" or "[w]ww.a.com", false for
494      // "host[w].com". ref:
495      // https://source.chromium.org/chromium/chromium/src/+/main:components/omnibox/browser/scored_history_match.cc;l=187?q=inline%20autocomplete
496      optional bool allowed_to_be_default_match = 24;
497    }
498    optional ScoringSignals scoring_signals = 10;
499  }
500  repeated Suggestion suggestion = 9;
501
502  // A data structure that holds per-provider information, general information
503  // not associated with a particular result.
504  // Next tag: 6
505  message ProviderInfo {
506    // Which provider generated this ProviderInfo entry.
507    optional ProviderType provider = 1;
508
509    // The provider's done() value, i.e., whether it's completed processing
510    // the query.  Providers which don't do any asynchronous processing
511    // will always be done.
512    optional bool provider_done = 2;
513
514    // The set of field trials that have triggered in the most recent query,
515    // possibly affecting the shown suggestions.  Each element is a hash
516    // of the corresponding field trial name.
517    // See chrome/browser/autocomplete/search_provider.cc for a specific usage
518    // DEPRECATED with crrev.com/c/4126664 1/4/23; replaced by
519    // `feature_triggered`.
520    // example.
521    repeated fixed32 field_trial_triggered = 3 [deprecated = true];
522
523    // Same as above except that the set of field trials is a union of all field
524    // trials that have triggered within the current omnibox session including
525    // the most recent query.
526    // See AutocompleteController::ResetSession() for more details on the
527    // definition of a session.
528    // See chrome/browser/autocomplete/search_provider.cc for a specific usage
529    // example.
530    // DEPRECATED with crrev.com/c/4126664 1/4/23; replaced by
531    // `feature_triggered_in_session`.
532    repeated fixed32 field_trial_triggered_in_session = 4 [deprecated = true];
533
534    // The number of times this provider returned a non-zero number of
535    // suggestions during this omnibox session.
536    // Note that each provider may define a session differently for its
537    // purposes.
538    optional int32 times_returned_results_in_session = 5;
539  }
540  // A list of diagnostic information about each provider.  Providers
541  // will appear at most once in this list.
542  repeated ProviderInfo provider_info = 12;
543
544  // Whether the Omnibox was in keyword mode, however it was entered.
545  optional bool in_keyword_mode = 19;
546
547  // How the Omnibox got into keyword mode. Not present if not in keyword
548  // mode.
549  enum KeywordModeEntryMethod {
550    INVALID = 0;
551    TAB = 1;                // Select a suggestion that provides a keyword hint
552                            // and press Tab.
553    SPACE_AT_END = 2;       // Type a complete keyword and press Space.
554    SPACE_IN_MIDDLE = 3;    // Press Space in the middle of an input in order to
555                            // separate it into a keyword and other text.
556    KEYBOARD_SHORTCUT = 4;  // Press ^K.
557    QUESTION_MARK = 5;      // Press Question-mark without any other input.
558    CLICK_HINT_VIEW = 6;    // Select a suggestion that provides a keyword hint
559                            // and click the reminder that one can press Tab.
560    TAP_HINT_VIEW = 7;      // Select a suggestion that provides a keyword hint
561                            // and touch the reminder that one can press Tab.
562    SELECT_SUGGESTION = 8;  // Select a keyword suggestion, such as by arrowing
563                            // or tabbing to it.
564  }
565  optional KeywordModeEntryMethod keyword_mode_entry_method = 20;
566
567  // Whether the omnibox input is a search query that is started
568  // by clicking on a image tile.
569  optional bool is_query_started_from_tile = 21;
570
571  enum Feature {
572    RICH_AUTOCOMPLETION = 0;
573    SHORT_BOOKMARK_SUGGESTIONS_BY_TOTAL_INPUT_LENGTH = 2;
574    FUZZY_URL_SUGGESTIONS = 3;
575    HISTORY_CLUSTER_SUGGESTION = 4;
576    DOMAIN_SUGGESTIONS = 5;
577    // Whether the `SearchProvider` response included:
578    // '"google:fieldtrialtriggered":true'.
579    REMOTE_SEARCH_FEATURE = 6;
580    // Like `REMOTE_SEARCH_FEATURE`, but for the `ZeroSearchProvider`.
581    REMOTE_ZERO_SUGGEST_FEATURE = 7;
582    SHORTCUT_BOOST = 8;
583    REMOTE_SECONDARY_ZERO_SUGGEST = 9;
584    ML_URL_SCORING = 10;
585  }
586  // The set of features triggered in the most recent query. Each element is a
587  // value of `Features` enum.
588  repeated int32 legacy_feature_triggered = 24 [deprecated = true];
589
590  // Like above except that the set of features is a union of all features that
591  // triggered within the current omnibox session including the most recent
592  // query. See `AutocompleteController::ResetSession()` for more details on the
593  // definition of a session.
594  repeated int32 legacy_feature_triggered_in_session = 22 [deprecated = true];
595
596  // The set of features triggered in the most recent query.
597  repeated Feature feature_triggered = 25;
598
599  // Like above except that the set of features is a union of all features that
600  // triggered within the current omnibox session including the most recent
601  // query. See `AutocompleteController::ResetSession()` for more details on the
602  // definition of a session.
603  repeated Feature feature_triggered_in_session = 26;
604
605  // Profile data of the user. Currently, only logged when there is a URL click.
606  message ProfileData {
607    // Total number of bookmarks in the profile this omnibox interaction took
608    // place in.
609    optional int32 total_num_bookmarks = 1;
610    // Total number of URLs stored in the history database in the profile this
611    // omnibox interaction took place in.
612    optional int32 total_num_history_urls = 2;
613    // Is signed into the browser. Set to false for Guest and Incognito
614    // profiles. Not set when signed-in status is unknown.
615    optional bool is_signed_into_browser = 3;
616    // Is sync-enabled.
617    optional bool is_sync_enabled = 4;
618  }
619  optional ProfileData profile_data = 23;
620}
621