1<!--
2Copyright 2020 The Chromium Authors. All rights reserved.
3Use of this source code is governed by a BSD-style license that can be
4found in the LICENSE file.
5-->
6
7<!--
8This file is used to generate a comprehensive list of Search histograms
9along with a detailed description for each histogram.
10
11For best practices on writing histogram descriptions, see
12https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md
13
14Please send CLs to chromium-metrics-reviews@google.com rather than to specific
15individuals. These CLs will be automatically reassigned to a reviewer within
16about 5 minutes. This approach helps the metrics team to load-balance incoming
17reviews. Googlers can read more about this at go/gwsq-gerrit.
18-->
19
20<histogram-configuration>
21
22<histograms>
23
24<histogram name="Search.ContextualSearch.All.ResultsSeen" enum="Boolean"
25    expires_after="never">
26<!-- expires-never: dashboard metric (internal: go/cs-metrics-dashboard) -->
27
28<!-- expires-never: part of top-line metric (internal: go/chrome-browser-nsm) -->
29
30  <owner>donnd@chromium.org</owner>
31  <owner>twellington@chromium.org</owner>
32  <owner>chrome-analysis-team@google.com</owner>
33  <summary>
34    Records whether the user opened the panel when it was shown. Recorded for
35    all gestures for all users when the UX is hidden. Implemented for Android.
36
37    This histogram is of special interest to the chrome-analysis-team@. Do not
38    change its semantics or retire it without talking to them first.
39  </summary>
40</histogram>
41
42<histogram name="Search.ContextualSearch.CardTag"
43    enum="ContextualSearchCardTag" expires_after="never">
44<!-- expires-never: tracks key server results returned to the user. -->
45
46  <owner>donnd@chromium.org</owner>
47  <owner>twellington@chromium.org</owner>
48  <summary>
49    The type of card returned in the Search Term Resolution Response from the
50    server when a search is resolved in response to a Tap gesture that uses
51    surrounding text to determine the best search. This characterises what we'll
52    show in the Bar. Recorded when the panel is closed. Implemented for Android.
53  </summary>
54</histogram>
55
56<histogram name="Search.ContextualSearch.CardTagSeen"
57    enum="ContextualSearchCardTag" expires_after="never">
58<!-- expires-never: tracks key server results returned to the user. -->
59
60  <owner>donnd@chromium.org</owner>
61  <owner>twellington@chromium.org</owner>
62  <summary>
63    The type of card shown in the Bar when the panel has been opened. Recorded
64    when the panel is closed. Implemented for Android.
65  </summary>
66</histogram>
67
68<histogram name="Search.ContextualSearch.OutcomesDuration" units="days"
69    expires_after="M75">
70  <owner>donnd@chromium.org</owner>
71  <owner>twellington@chromium.org</owner>
72  <summary>
73    Records the duration of persisted outcomes between the time they were stored
74    and the time that they were sent back to the server. Recorded when persisted
75    data is sent to the server. Implemented for Android.
76  </summary>
77</histogram>
78
79<histogram name="Search.ContextualSearch.Ranker.FeaturesAvailable"
80    enum="Boolean" expires_after="M77">
81  <owner>donnd@chromium.org</owner>
82  <owner>twellington@chromium.org</owner>
83  <summary>
84    Logs that the UX has entered a state where features are available to be
85    recorded to Ranker. A value of true indicates that the available features
86    include outcomes, false if they are just features at inference-time. Use to
87    correlate with what actually gets recorded in the Search.
88    ContextualSearch.Ranker.Recorded histogram. Recorded when a tap gesture is
89    recognized that might trigger our UX (for pure features), and when the UX is
90    actually shown (for outcomes). Implemented for Android.
91  </summary>
92</histogram>
93
94<histogram name="Search.ContextualSearch.Ranker.Model.Status"
95    enum="RankerModelStatus" expires_after="M77">
96  <owner>donnd@chromium.org</owner>
97  <owner>charleszhao@chromium.org</owner>
98  <summary>Tracks the outcome of attempts to download a Ranker Model.</summary>
99</histogram>
100
101<histogram name="Search.ContextualSearch.Ranker.NotSuppressed.ResultsSeen"
102    enum="ContextualSearchResultsSeen" expires_after="M77">
103  <owner>donnd@chromium.org</owner>
104  <owner>twellington@chromium.org</owner>
105  <summary>
106    Records whether the user opened the panel when a tap was not suppressed by
107    Ranker. Recorded when the UX is hidden. Implemented for Android.
108  </summary>
109</histogram>
110
111<histogram name="Search.ContextualSearch.Ranker.Recorded" enum="Boolean"
112    expires_after="M77">
113  <owner>donnd@chromium.org</owner>
114  <owner>twellington@chromium.org</owner>
115  <summary>
116    Logs that features were recorded to Ranker and whether it was an outcome or
117    not. Recorded when the UX is shown or hidden. Implemented for Android.
118  </summary>
119</histogram>
120
121<histogram name="Search.ContextualSearch.Ranker.RecordedNative" enum="Boolean"
122    expires_after="M77">
123  <owner>donnd@chromium.org</owner>
124  <owner>twellington@chromium.org</owner>
125  <summary>
126    Logs that features were recorded to Ranker from native code and whether it
127    was an outcome or not. Recorded when the UX is shown or hidden. Implemented
128    for Android.
129  </summary>
130</histogram>
131
132<histogram name="Search.ContextualSearch.Ranker.Suppressed" enum="Boolean"
133    expires_after="M85">
134  <owner>donnd@chromium.org</owner>
135  <owner>twellington@chromium.org</owner>
136  <summary>
137    Records Ranker's prediction about whether a tap should be suppressed or not.
138    Recorded when the UX is hidden. Implemented for Android.
139  </summary>
140</histogram>
141
142<histogram name="Search.ContextualSearch.Ranker.Timer.DownloadModel" units="ms"
143    expires_after="M81">
144  <owner>charleszhao@chromium.org</owner>
145  <owner>donnd@chromium.org</owner>
146  <summary>
147    Time taken for the Ranker Model Loader to download its model from the
148    configured URL, in ms.
149  </summary>
150</histogram>
151
152<histogram name="Search.ContextualSearch.Ranker.Timer.ParseModel" units="ms"
153    expires_after="M77">
154  <owner>charleszhao@chromium.org</owner>
155  <owner>donnd@chromium.org</owner>
156  <summary>
157    Time taken for the Ranker Model Loader to parse its model, in ms.
158  </summary>
159</histogram>
160
161<histogram name="Search.ContextualSearch.Ranker.Timer.ReadModel" units="ms"
162    expires_after="M85">
163  <owner>charleszhao@chromium.org</owner>
164  <owner>donnd@chromium.org</owner>
165  <summary>
166    Time taken for the Ranker Model Loader to read its model from local storage
167    (cache), in ms.
168  </summary>
169</histogram>
170
171<histogram name="Search.ContextualSearch.Ranker.Timer.WriteModel" units="ms"
172    expires_after="M85">
173  <owner>charleszhao@chromium.org</owner>
174  <owner>donnd@chromium.org</owner>
175  <summary>
176    Time taken for the Ranker Model Loader to write its model to local storage,
177    in ms.
178  </summary>
179</histogram>
180
181<histogram name="Search.ContextualSearch.Ranker.WasAbleToPredict"
182    enum="Boolean" expires_after="M77">
183  <owner>donnd@chromium.org</owner>
184  <owner>twellington@chromium.org</owner>
185  <summary>
186    Records whether Ranker was able to make a prediction about tap suppression.
187    Recorded when the UX is triggered by tap. Implemented for Android.
188  </summary>
189</histogram>
190
191<histogram name="Search.ContextualSearch.Ranker.WouldSuppress.ResultsSeen"
192    enum="ContextualSearchResultsSeen" expires_after="M77">
193  <owner>donnd@chromium.org</owner>
194  <owner>twellington@chromium.org</owner>
195  <summary>
196    Records whether the user opened the panel when a tap would be suppressed by
197    Ranker if suppression was enforced. Recorded when the UX is hidden.
198    Implemented for Android.
199  </summary>
200</histogram>
201
202<histogram name="Search.ContextualSearch.ResolveReceived" enum="Boolean"
203    expires_after="M89">
204  <owner>donnd@chromium.org</owner>
205  <owner>twellington@chromium.org</owner>
206  <summary>
207    Records that a resolve response was received from the server, and whether
208    that was due to a Tap gesture or not (vs longpress). Recorded when the user
209    triggers the feature and the server responds. Implemented for Android.
210  </summary>
211</histogram>
212
213<histogram name="Search.ContextualSearch.ResolveRequested"
214    enum="ContextualSearchGestureIsTap" expires_after="M89">
215  <owner>donnd@chromium.org</owner>
216  <owner>twellington@chromium.org</owner>
217  <summary>
218    Records that a resolve request was sent to the server, and whether that was
219    due to a Tap or not (vs longpress). Recorded when the user triggers the
220    feature. Implemented for Android.
221  </summary>
222</histogram>
223
224<histogram name="Search.ContextualSearch.SelectionExpanded"
225    enum="ContextualSearchGestureIsTap" expires_after="M92">
226  <owner>donnd@chromium.org</owner>
227  <owner>twellington@chromium.org</owner>
228  <summary>
229    Records that a resolve request from the server caused the selection to be
230    expanded, and whether that original selection was due to a Tap or not (vs
231    longpress). Recorded when the qualifying server response is received.
232    Implemented for Android.
233  </summary>
234</histogram>
235
236<histogram name="Search.ContextualSearch.Tap.ResultsSeen" enum="Boolean"
237    expires_after="M77">
238  <owner>donnd@chromium.org</owner>
239  <owner>twellington@chromium.org</owner>
240  <summary>
241    Records whether the user opened the panel when it was shown in response to a
242    tap gesture, for all users. Recorded when the UX is hidden. Implemented for
243    Android.
244  </summary>
245</histogram>
246
247<histogram name="Search.ContextualSearch.Tap.SyncEnabled.ResultsSeen"
248    enum="Boolean" expires_after="M76">
249  <owner>donnd@chromium.org</owner>
250  <owner>twellington@chromium.org</owner>
251  <summary>
252    Records whether the user opened the panel when it was shown for sync-enabled
253    users only (this is an approximation for the population that logs to UKM).
254    Recorded for all gestures for users with sync enabled when the UX is hidden.
255    Implemented for Android.
256  </summary>
257</histogram>
258
259<histogram name="Search.ContextualSearch.TranslationNeeded"
260    enum="ContextualSearchGestureIsTap" expires_after="M89">
261  <owner>donnd@chromium.org</owner>
262  <owner>twellington@chromium.org</owner>
263  <summary>
264    Records that a translation is needed for the current Contextual Search, and
265    whether the selection was originally created by a Tap gesture. This is
266    recorded regardless of whether the user will actually be shown a translation
267    or not. Recorded any time a selection is established or changed with the
268    Contextual Search Translations feature enabled. Implemented for Android.
269  </summary>
270</histogram>
271
272<histogram name="Search.ContextualSearch.TranslationsOptInIPHShown"
273    enum="BooleanPreviouslyShown" expires_after="M89">
274  <owner>donnd@chromium.org</owner>
275  <owner>contextual-search-eng@google.com</owner>
276  <summary>
277    Records whether an IPH promoting the Opt-in for the Translations experiment
278    has ever been shown for the current user. Recorded when the Overlay Panel is
279    closed. Implemented for Android.
280  </summary>
281</histogram>
282
283<histogram name="Search.ContextualSearch.TranslationsOptInIPHWorked"
284    enum="BooleanOptedIn" expires_after="M89">
285  <owner>donnd@chromium.org</owner>
286  <owner>contextual-search-eng@google.com</owner>
287  <summary>
288    Records whether the user actually did Opt-in right after seeing the IPH for
289    the Translations experiment. Recorded when the Overlay Panel is closed.
290    Implemented for Android.
291  </summary>
292</histogram>
293
294<histogram name="Search.ContextualSearch.UnifiedConsent.PreviouslyUndecided"
295    enum="Boolean" expires_after="2019-01-30">
296  <owner>donnd@chromium.org</owner>
297  <owner>twellington@chromium.org</owner>
298  <summary>
299    Records the previous state of the user's enabled preference to indicate
300    whether they were decided or undecided about fully enabling this feature.
301    Recorded during the rollout of Unified Consent when the Contextual Search
302    preference is changed. Implemented for Android.
303  </summary>
304</histogram>
305
306<histogram name="Search.ContextualSearch.UnifiedConsent.ThrottledRequests"
307    enum="Boolean" expires_after="2019-01-30">
308  <owner>donnd@chromium.org</owner>
309  <owner>twellington@chromium.org</owner>
310  <summary>
311    Records whether throttling for Unified Consent was done for all requests.
312    Recorded when the user taps on text and the system would like the server to
313    suggest what to search for using page context, regardless of feature-enabled
314    state. Recorded multiple times for each request. Supports the rollout of
315    Unified Consent for Contextual Search. Implemented for Android.
316  </summary>
317</histogram>
318
319<histogram name="Search.ContextualSearch.UnifiedConsent.ThrottleEligible"
320    enum="Boolean" expires_after="2019-01-30">
321  <owner>donnd@chromium.org</owner>
322  <owner>twellington@chromium.org</owner>
323  <summary>
324    Records whether this user had a request throttled or not when needed.
325    Recorded when the user taps on text and the system would like the server to
326    suggest what to search for using page context, and throttling is in effect
327    for this user. Supports the rollout of Unified Consent for Contextual
328    Search. Implemented for Android.
329  </summary>
330</histogram>
331
332<histogram name="Search.ContextualSearchBarNoOverlap.PeekDuration" units="ms"
333    expires_after="M72">
334  <owner>donnd@chromium.org</owner>
335  <owner>twellington@chromium.org</owner>
336  <summary>
337    The duration that the panel was peeking before being opened when triggered
338    by a tap that was in a part of the screen where it overlaps the Bar. Logged
339    when the panel is closed after being opened. Implemented for Android.
340  </summary>
341</histogram>
342
343<histogram name="Search.ContextualSearchBarOverlap"
344    enum="ContextualSearchTapSuppression" expires_after="M77">
345  <owner>donnd@chromium.org</owner>
346  <owner>twellington@chromium.org</owner>
347  <summary>
348    Whether a Tap was suppressed because the Bar overlapped the selection area.
349    Implemented for Android.
350  </summary>
351</histogram>
352
353<histogram name="Search.ContextualSearchBarOverlap.PeekDuration" units="ms"
354    expires_after="M72">
355  <owner>donnd@chromium.org</owner>
356  <owner>twellington@chromium.org</owner>
357  <summary>
358    The duration that the panel was peeking before being opened when triggered
359    by a tap at the bottom of the screen where it overlaps the Bar. Logged when
360    the panel is closed after being opened. Implemented for Android.
361  </summary>
362</histogram>
363
364<histogram name="Search.ContextualSearchBarOverlapSeen"
365    enum="ContextualSearchBarOverlapSeen" expires_after="M72">
366  <owner>donnd@chromium.org</owner>
367  <owner>twellington@chromium.org</owner>
368  <summary>
369    Whether the Bar overlapped the selection area and whether the results were
370    seen. Recorded when the UX is hidden. Implemented for Android.
371  </summary>
372</histogram>
373
374<histogram name="Search.ContextualSearchBasePageProtocol"
375    enum="ContextualSearchBasePageProtocol" expires_after="M72">
376  <owner>donnd@chromium.org</owner>
377  <owner>twellington@chromium.org</owner>
378  <summary>
379    The protocol of the base page, logged at the time that any Search Term
380    Resolution Response is received.
381  </summary>
382</histogram>
383
384<histogram name="Search.ContextualSearchContextualCardsIntegration.DataShown"
385    enum="Boolean" expires_after="never">
386<!-- expires-never: key metric on usefulness of Touch to Search. -->
387
388  <owner>donnd@chromium.org</owner>
389  <owner>twellington@chromium.org</owner>
390  <summary>
391    Whether Contextual Cards data was shown in the Contextual Search Bar.
392    Contextual Cards data is included with the search term resolution response.
393    Implemented for Android.
394  </summary>
395</histogram>
396
397<histogram name="Search.ContextualSearchContextualCardsIntegration.ResultsSeen"
398    enum="ContextualSearchResultsSeen" expires_after="M85">
399  <owner>donnd@chromium.org</owner>
400  <owner>twellington@chromium.org</owner>
401  <summary>
402    Whether search results were seen as part of a Contextual Search when
403    Contextual Cards data was shown. This indicates that the panel was opened.
404    Implemented for Android.
405  </summary>
406</histogram>
407
408<histogram name="Search.ContextualSearchDurationBetweenTriggerAndScrollNotSeen"
409    units="ms" expires_after="M72">
410  <owner>donnd@chromium.org</owner>
411  <owner>twellington@chromium.org</owner>
412  <summary>
413    The duration between the panel being triggered and the panel being dismissed
414    due to a scroll when search results were not seen. Implemented for Android.
415    Prior to M57 this was recorded on tap and longpress; on M57+ it is only
416    recorded on tap.
417  </summary>
418</histogram>
419
420<histogram name="Search.ContextualSearchDurationBetweenTriggerAndScrollSeen"
421    units="ms" expires_after="M72">
422  <owner>donnd@chromium.org</owner>
423  <owner>twellington@chromium.org</owner>
424  <summary>
425    The duration between the panel being triggered and the panel being dismissed
426    due to a scroll when search results were seen. Implemented for Android.
427    Prior to M57 this was recorded on tap and longpress; on M57+ it is only
428    recorded on tap.
429  </summary>
430</histogram>
431
432<histogram name="Search.ContextualSearchDurationSeen" units="ms"
433    expires_after="M72">
434  <owner>donnd@chromium.org</owner>
435  <owner>twellington@chromium.org</owner>
436  <summary>
437    The time from initiating to ending a contextual search, when results were
438    seen as part of the search. Implemented for Android.
439  </summary>
440</histogram>
441
442<histogram name="Search.ContextualSearchDurationUnseen" units="ms"
443    expires_after="M72">
444  <owner>donnd@chromium.org</owner>
445  <owner>twellington@chromium.org</owner>
446  <summary>
447    The time from initiating to ending a contextual search, when results were
448    not seen as part of the search and the search did not end with the beginning
449    of another contextual search. Implemented for Android.
450  </summary>
451</histogram>
452
453<histogram name="Search.ContextualSearchDurationUnseenChained" units="ms"
454    expires_after="M72">
455  <owner>donnd@chromium.org</owner>
456  <owner>twellington@chromium.org</owner>
457  <summary>
458    The time from initiating to ending a contextual search, when results were
459    not seen as part of the search and the search ended with the beginning of
460    another contextual search. Implemented for Android.
461  </summary>
462</histogram>
463
464<histogram name="Search.ContextualSearchEnterClosed"
465    enum="ContextualSearchEnterClosedStateChange" expires_after="M72">
466  <owner>donnd@chromium.org</owner>
467  <owner>twellington@chromium.org</owner>
468  <summary>
469    The details (previous state and reason) of the first entry into the closed
470    panel state within a contextual search. Implemented for Android.
471  </summary>
472</histogram>
473
474<histogram name="Search.ContextualSearchEnterExpanded"
475    enum="ContextualSearchEnterExpandedStateChange" expires_after="M72">
476  <owner>donnd@chromium.org</owner>
477  <owner>twellington@chromium.org</owner>
478  <summary>
479    The details (previous state and reason) of the first entry into the expanded
480    panel state within a contextual search. Implemented for Android.
481  </summary>
482</histogram>
483
484<histogram name="Search.ContextualSearchEnterMaximized"
485    enum="ContextualSearchEnterMaximizedStateChange" expires_after="M72">
486  <owner>donnd@chromium.org</owner>
487  <owner>twellington@chromium.org</owner>
488  <summary>
489    The details (previous state and reason) of the first entry into the
490    maximized panel state within a contextual search. Implemented for Android.
491  </summary>
492</histogram>
493
494<histogram name="Search.ContextualSearchEnterPeeked"
495    enum="ContextualSearchEnterPeekedStateChange" expires_after="M72">
496  <owner>donnd@chromium.org</owner>
497  <owner>twellington@chromium.org</owner>
498  <summary>
499    The details (previous state and reason) of the first entry into the peeked
500    panel state within a contextual search. Implemented for Android.
501  </summary>
502</histogram>
503
504<histogram name="Search.ContextualSearchEntitySeen"
505    enum="ContextualSearchResultsSeen" expires_after="M77">
506  <owner>donnd@chromium.org</owner>
507  <owner>twellington@chromium.org</owner>
508  <summary>
509    Whether search results were seen as part of a Contextual Search when a tap
510    was on a word that we think is an entity. Recorded when Contextual Search is
511    dismissed. Implemented for Android.
512  </summary>
513</histogram>
514
515<histogram name="Search.ContextualSearchExitClosed"
516    enum="ContextualSearchExitClosedStateChange" expires_after="M72">
517  <owner>donnd@chromium.org</owner>
518  <owner>twellington@chromium.org</owner>
519  <summary>
520    The details (destination state and reason) of the first exit out of the
521    closed panel state within a contextual search. Implemented for Android.
522  </summary>
523</histogram>
524
525<histogram name="Search.ContextualSearchExitExpanded"
526    enum="ContextualSearchExitExpandedStateChange" expires_after="M72">
527  <owner>donnd@chromium.org</owner>
528  <owner>twellington@chromium.org</owner>
529  <summary>
530    The details (destination state and reason) of the first exit out of the
531    expanded panel state within a contextual search. Implemented for Android.
532  </summary>
533</histogram>
534
535<histogram name="Search.ContextualSearchExitMaximized"
536    enum="ContextualSearchExitMaximizedStateChange" expires_after="M72">
537  <owner>donnd@chromium.org</owner>
538  <owner>twellington@chromium.org</owner>
539  <summary>
540    The details (destination state and reason) of the first exit out of the
541    maximized panel state within a contextual search. Implemented for Android.
542  </summary>
543</histogram>
544
545<histogram name="Search.ContextualSearchExitPeeked"
546    enum="ContextualSearchExitPeekedStateChange" expires_after="M77">
547  <owner>donnd@chromium.org</owner>
548  <owner>twellington@chromium.org</owner>
549  <summary>
550    The details (destination state and reason) of the first exit out of the
551    peeked panel state within a contextual search. Implemented for Android.
552  </summary>
553</histogram>
554
555<histogram name="Search.ContextualSearchFallbackSearchRequestStatus"
556    enum="ContextualSearchSearchRequestStatus" expires_after="M85">
557  <owner>donnd@chromium.org</owner>
558  <owner>twellington@chromium.org</owner>
559  <summary>
560    The status of the Contextual Search fallback Search request. Implemented for
561    Android.
562  </summary>
563</histogram>
564
565<histogram name="Search.ContextualSearchFirstRunFlowOutcome"
566    enum="ContextualSearchPreferenceState" expires_after="M72">
567  <owner>donnd@chromium.org</owner>
568  <owner>twellington@chromium.org</owner>
569  <summary>
570    The state of the Contextual Search Preference after the first run flow.
571    Implemented for Android.
572  </summary>
573</histogram>
574
575<histogram name="Search.ContextualSearchFirstRunPanelSeen"
576    enum="ContextualSearchFirstRunPanelSeen" expires_after="M72">
577  <owner>donnd@chromium.org</owner>
578  <owner>twellington@chromium.org</owner>
579  <summary>
580    Whether the first run flow's panel was seen as part of a contextual search.
581    Only logged when the user triggered the first run flow yet exited the search
582    still in the undecided preference state. Implemented for Android.
583  </summary>
584</histogram>
585
586<histogram name="Search.ContextualSearchIPHShown" enum="Boolean"
587    expires_after="M77">
588  <owner>donnd@chromium.org</owner>
589  <owner>mahmoudi@chromium.org</owner>
590  <owner>twellington@chromium.org</owner>
591  <summary>
592    The number of times the Contextual Search panel is opened, categorized by
593    whether In-Product Help for Contextual Search was shown before. Logged when
594    the panel is opened. Implemented for Android.
595  </summary>
596</histogram>
597
598<histogram name="Search.ContextualSearchLiteralSearchDuration" units="ms"
599    expires_after="M72">
600  <owner>donnd@chromium.org</owner>
601  <owner>twellington@chromium.org</owner>
602  <summary>
603    The time from starting a literal search until the results in the SERP start
604    to become viewable. Applies only to prefetched requests. Implemented for
605    Android.
606  </summary>
607</histogram>
608
609<histogram name="Search.ContextualSearchLowPrioritySearchRequestStatus"
610    enum="ContextualSearchSearchRequestStatus" expires_after="M72">
611  <owner>donnd@chromium.org</owner>
612  <owner>twellington@chromium.org</owner>
613  <summary>
614    The status of the Contextual Search low priority Search request. Implemented
615    for Android.
616  </summary>
617</histogram>
618
619<histogram name="Search.ContextualSearchMandatoryPromoOutcomeByGesture"
620    enum="ContextualSearchOutcomeByGesture" expires_after="M85">
621  <owner>donnd@chromium.org</owner>
622  <owner>twellington@chromium.org</owner>
623  <summary>
624    The outcome of the mandatory Promo broken down by original triggering
625    gesture. Logged for each view of the promo. Implemented for Android.
626  </summary>
627</histogram>
628
629<histogram name="Search.ContextualSearchNormalPrioritySearchRequestStatus"
630    enum="ContextualSearchSearchRequestStatus" expires_after="M77">
631  <owner>donnd@chromium.org</owner>
632  <owner>twellington@chromium.org</owner>
633  <summary>
634    The status of the Contextual Search normal priority Search request.
635    Implemented for Android.
636  </summary>
637</histogram>
638
639<histogram name="Search.ContextualSearchPanelOpenDuration" units="ms"
640    expires_after="M72">
641  <owner>donnd@chromium.org</owner>
642  <owner>twellington@chromium.org</owner>
643  <summary>
644    The time from opening the panel beyond peek until the panel is closed.
645    Implemented for Android.
646  </summary>
647</histogram>
648
649<histogram name="Search.ContextualSearchPanelOpenedIPHShown" enum="Boolean"
650    expires_after="M77">
651  <owner>donnd@chromium.org</owner>
652  <owner>mahmoudi@chromium.org</owner>
653  <owner>twellington@chromium.org</owner>
654  <summary>
655    The number of times the Contextual Search panel is opened, categorized by
656    whether In-Product Help for opening the panel was shown before. Logged when
657    the panel is opened. Implemented for Android.
658  </summary>
659</histogram>
660
661<histogram name="Search.ContextualSearchPreferenceState"
662    enum="ContextualSearchPreferenceState" expires_after="never">
663<!-- expires-never: dashboard metric (internal: go/cs-metrics-dashboard) -->
664
665  <owner>donnd@chromium.org</owner>
666  <owner>twellington@chromium.org</owner>
667  <summary>
668    The state of the Contextual Search Preference. Can be logged multiple times.
669    Used to determine the population size (user view). Logged whenever the
670    Chrome application is paused. Implemented for Android.
671  </summary>
672</histogram>
673
674<histogram name="Search.ContextualSearchPreferenceStateChange"
675    enum="ContextualSearchPreferenceState" expires_after="never">
676<!-- expires-never: dashboard metric (internal: go/cs-metrics-dashboard) -->
677
678  <owner>donnd@chromium.org</owner>
679  <owner>twellington@chromium.org</owner>
680  <summary>
681    The Contextual Search preference state after a modification from the
682    preference menu. Implemented for Android.
683  </summary>
684</histogram>
685
686<histogram name="Search.ContextualSearchPrevious28DayCtr" units="%"
687    expires_after="M72">
688  <owner>donnd@chromium.org</owner>
689  <owner>twellington@chromium.org</owner>
690  <summary>
691    The CTR from the previous 28 day period for each user, expressed as a
692    percentage. Logged the first time the panel is closed in each new week.
693    Implemented for Android.
694  </summary>
695</histogram>
696
697<histogram name="Search.ContextualSearchPrevious28DayImpressions" units="views"
698    expires_after="M72">
699  <owner>donnd@chromium.org</owner>
700  <owner>twellington@chromium.org</owner>
701  <summary>
702    The number of user impressions of the Bar from the previous 28 day period.
703    Logged the first time the panel is closed in each new week. Implemented for
704    Android.
705  </summary>
706</histogram>
707
708<histogram name="Search.ContextualSearchPreviousWeekCtr" units="%"
709    expires_after="M72">
710  <owner>donnd@chromium.org</owner>
711  <owner>twellington@chromium.org</owner>
712  <summary>
713    The CTR from the previous week for each user, expressed as a percentage.
714    Logged the first time the panel is closed in each new week. Implemented for
715    Android.
716  </summary>
717</histogram>
718
719<histogram name="Search.ContextualSearchPreviousWeekImpressions" units="views"
720    expires_after="M72">
721  <owner>donnd@chromium.org</owner>
722  <owner>twellington@chromium.org</owner>
723  <summary>
724    The number of user impressions of the Bar from the previous week. Logged the
725    first time the panel is closed in each new week. Implemented for Android.
726  </summary>
727</histogram>
728
729<histogram name="Search.ContextualSearchPromoOpenCount" units="opens"
730    expires_after="M77">
731  <owner>donnd@chromium.org</owner>
732  <owner>twellington@chromium.org</owner>
733  <summary>
734    The total count of times that the bar with the promo has been opened. Once
735    the user decides, this counter is no longer updated.
736  </summary>
737</histogram>
738
739<histogram name="Search.ContextualSearchPromoOutcomeByGesture"
740    enum="ContextualSearchOutcomeByGesture" expires_after="M72">
741  <owner>donnd@chromium.org</owner>
742  <owner>twellington@chromium.org</owner>
743  <summary>
744    The outcome of the promo broken down by original triggering gesture. Logged
745    for each view of the promo. Implemented for Android.
746  </summary>
747</histogram>
748
749<histogram name="Search.ContextualSearchPromoSeenByGesture"
750    enum="ContextualSearchSeenByGesture" expires_after="M81">
751  <owner>donnd@chromium.org</owner>
752  <owner>twellington@chromium.org</owner>
753  <summary>
754    Whether the promo was seen, broken down by original triggering gesture.
755    Logged each time the promo was activated. Implemented for Android.
756  </summary>
757</histogram>
758
759<histogram name="Search.ContextualSearchPromoTapsBeforeFirstOpen" units="taps"
760    expires_after="M81">
761  <owner>donnd@chromium.org</owner>
762  <owner>twellington@chromium.org</owner>
763  <summary>
764    The historic number of taps that showed a peeking bar with the opt-out promo
765    before the first time the user opened the panel.
766  </summary>
767</histogram>
768
769<histogram name="Search.ContextualSearchPromoTapsForNeverOpened" units="taps"
770    expires_after="M77">
771  <owner>donnd@chromium.org</owner>
772  <owner>twellington@chromium.org</owner>
773  <summary>
774    The historic number of taps that showed a peeking bar with the opt-out promo
775    for users who have never opened the panel. This count may be limited by the
776    Finch config param promo_on_limited_taps.
777  </summary>
778</histogram>
779
780<histogram name="Search.ContextualSearchPromoTapsRemaining" units="taps"
781    expires_after="M77">
782  <owner>donnd@chromium.org</owner>
783  <owner>twellington@chromium.org</owner>
784  <summary>
785    The number of remaining taps that can trigger the promo for this user.
786    Implemented for Android.
787  </summary>
788</histogram>
789
790<histogram name="Search.ContextualSearchQuickActions.Category"
791    enum="ContextualSearchQuickActionCategory" expires_after="2021-03-21">
792  <owner>donnd@chromium.org</owner>
793  <owner>twellington@chromium.org</owner>
794  <summary>
795    The category of quick actions shown in the Contextual Search bar. Recorded
796    when the quick action is set. Implemented for Android.
797  </summary>
798</histogram>
799
800<histogram name="Search.ContextualSearchQuickActions.Clicked"
801    enum="BooleanClicked" expires_after="never">
802<!-- expires-never: indicates completion of a user journey. -->
803
804  <owner>donnd@chromium.org</owner>
805  <owner>twellington@chromium.org</owner>
806  <summary>
807    Whether a quick action in the Contextual Search bar was clicked, which
808    activates the associated intent. Recorded when Contextual Search is
809    dismissed due to a click on a QuickAction in the Bar. Implemented for
810    Android.
811  </summary>
812</histogram>
813
814<histogram name="Search.ContextualSearchQuickActions.IntentResolution"
815    enum="ContextualSearchQuickActionIntentResolution" expires_after="M81">
816  <owner>donnd@chromium.org</owner>
817  <owner>twellington@chromium.org</owner>
818  <summary>
819    Whether a Contextual Search quick action intent resolved to zero, one, or
820    many apps. Recorded when the quick action intent URI is resolved.
821    Implemented for Android.
822  </summary>
823</histogram>
824
825<histogram name="Search.ContextualSearchQuickActions.ResultsSeen"
826    enum="ContextualSearchResultsSeen" expires_after="M81">
827  <owner>donnd@chromium.org</owner>
828  <owner>twellington@chromium.org</owner>
829  <summary>
830    Whether search results were seen as part of a Contextual Search when a quick
831    action was shown. Recorded when Contextual Search is dismissed. Implemented
832    for Android.
833  </summary>
834</histogram>
835
836<histogram name="Search.ContextualSearchQuickActions.Shown" enum="BooleanShown"
837    expires_after="M72">
838  <owner>donnd@chromium.org</owner>
839  <owner>twellington@chromium.org</owner>
840  <summary>
841    Whether a quick action was shown in the Contextual Search bar. Recorded when
842    the quick action is set. Implemented for Android.
843  </summary>
844</histogram>
845
846<histogram name="Search.ContextualSearchQuickAnswerSeen"
847    enum="ContextualSearchQuickAnswerSeen" expires_after="M77">
848  <owner>donnd@chromium.org</owner>
849  <owner>twellington@chromium.org</owner>
850  <summary>
851    Whether a Quick Answer was activated, considered an answer, and seen.
852    Implemented for Android.
853  </summary>
854</histogram>
855
856<histogram name="Search.ContextualSearchRecentScrollSuppression"
857    enum="ContextualSearchTapSuppression" expires_after="M72">
858  <owner>donnd@chromium.org</owner>
859  <owner>twellington@chromium.org</owner>
860  <summary>
861    Whether showing the Tap to Search UX in response to a Tap was suppressed by
862    a recent scroll. Implemented for Android.
863  </summary>
864</histogram>
865
866<histogram name="Search.ContextualSearchResolutionDuration" units="ms"
867    expires_after="M72">
868  <owner>donnd@chromium.org</owner>
869  <owner>twellington@chromium.org</owner>
870  <summary>
871    The time from starting a resolving search until the Search Term Resolves.
872    Implemented for Android.
873  </summary>
874</histogram>
875
876<histogram name="Search.ContextualSearchResolvedSearchDuration" units="ms"
877    expires_after="M72">
878  <owner>donnd@chromium.org</owner>
879  <owner>twellington@chromium.org</owner>
880  <summary>
881    The time from starting a resolving search until the results in the SERP
882    start to become viewable. Applies only to prefetched requests. Implemented
883    for Android.
884  </summary>
885</histogram>
886
887<histogram name="Search.ContextualSearchResolvedTermWords"
888    enum="ContextualSearchResolvedTermWords" expires_after="M72">
889  <owner>donnd@chromium.org</owner>
890  <owner>twellington@chromium.org</owner>
891  <summary>
892    Whether the search term was single or multi-word, logged at the time that
893    any Search Term Resolution Response is received.
894  </summary>
895</histogram>
896
897<histogram name="Search.ContextualSearchResultsSeen"
898    enum="ContextualSearchResultsSeen" expires_after="never">
899<!-- expires-never: dashboard metric (internal: go/cs-metrics-dashboard) -->
900
901  <owner>donnd@chromium.org</owner>
902  <owner>twellington@chromium.org</owner>
903  <summary>
904    Whether search results were seen as part of a contextual search. Implemented
905    for Android.
906  </summary>
907</histogram>
908
909<histogram name="Search.ContextualSearchResultsSeenByGesture"
910    enum="ContextualSearchSeenByGesture" expires_after="never">
911<!-- expires-never: dashboard metric (internal: go/cs-metrics-dashboard) -->
912
913  <owner>donnd@chromium.org</owner>
914  <owner>twellington@chromium.org</owner>
915  <summary>
916    Whether search results were seen, broken down by original triggering
917    gesture. Only includes users that have enabled. Implemented for Android.
918  </summary>
919</histogram>
920
921<histogram name="Search.ContextualSearchScreenTopSuppressed"
922    enum="ContextualSearchTapSuppression" expires_after="M72">
923  <owner>donnd@chromium.org</owner>
924  <owner>twellington@chromium.org</owner>
925  <summary>
926    Whether Taps near the top of the screen was suppressed. Implemented for
927    Android.
928  </summary>
929</histogram>
930
931<histogram name="Search.ContextualSearchSecondTapMlOverrideSeen" enum="Boolean"
932    expires_after="M77">
933  <owner>donnd@chromium.org</owner>
934  <owner>twellington@chromium.org</owner>
935  <summary>
936    Whether results were seen for a second tap that was allowed to override ML
937    Tap Suppression. Recorded when the UX is hidden. Implemented for Android.
938  </summary>
939</histogram>
940
941<histogram name="Search.ContextualSearchSelectionLengthNotSeen" units="chars"
942    expires_after="M72">
943  <owner>donnd@chromium.org</owner>
944  <owner>twellington@chromium.org</owner>
945  <summary>
946    The length of the triggering selection when search results were not seen.
947    Only logged when contextual search is triggered due to a tap. Implemented
948    for Android.
949  </summary>
950</histogram>
951
952<histogram name="Search.ContextualSearchSelectionLengthSeen" units="chars"
953    expires_after="M72">
954  <owner>donnd@chromium.org</owner>
955  <owner>twellington@chromium.org</owner>
956  <summary>
957    The length of the triggering selection when search results were seen. Only
958    logged when contextual search is triggered due to a tap. Implemented for
959    Android.
960  </summary>
961</histogram>
962
963<histogram name="Search.ContextualSearchSelectionLengthSuppression"
964    enum="ContextualSearchTapSuppression" expires_after="M72">
965  <owner>donnd@chromium.org</owner>
966  <owner>twellington@chromium.org</owner>
967  <summary>
968    Whether a Tap was suppressed because the selection length was less than the
969    minimum selection length. Implemented for Android.
970  </summary>
971</histogram>
972
973<histogram name="Search.ContextualSearchSelectionValid"
974    enum="ContextualSearchSelectionValid" expires_after="M72">
975  <owner>donnd@chromium.org</owner>
976  <owner>twellington@chromium.org</owner>
977  <summary>
978    Whether a Contextual Search selection was valid. Implemented for Android.
979  </summary>
980</histogram>
981
982<histogram name="Search.ContextualSearchTapDurationNotSeen" units="ms"
983    expires_after="M72">
984  <owner>donnd@chromium.org</owner>
985  <owner>twellington@chromium.org</owner>
986  <summary>
987    The duration of a tap that triggered a Contextual Search when the user does
988    not open the panel. Implemented for Android. Logged when the panel closes
989    after being triggered by a tap.
990  </summary>
991</histogram>
992
993<histogram name="Search.ContextualSearchTapDurationSeen" units="ms"
994    expires_after="M72">
995  <owner>donnd@chromium.org</owner>
996  <owner>twellington@chromium.org</owner>
997  <summary>
998    The duration of a tap that triggered a Contextual Search when the user does
999    open the panel. Implemented for Android. Logged when the panel closes after
1000    being triggered by a tap and subsequently opened.
1001  </summary>
1002</histogram>
1003
1004<histogram name="Search.ContextualSearchTapIPHShown" enum="Boolean"
1005    expires_after="M77">
1006  <owner>donnd@chromium.org</owner>
1007  <owner>mahmoudi@chromium.org</owner>
1008  <owner>twellington@chromium.org</owner>
1009  <summary>
1010    The number of times the Contextual Search is triggered by tapping,
1011    categorized by whether In-Product Help for tapping was shown before. Logged
1012    when Contextual Search is triggered by tapping. Implemented for Android.
1013  </summary>
1014</histogram>
1015
1016<histogram name="Search.ContextualSearchTapLongDurationSeen"
1017    enum="ContextualSearchResultsSeen" expires_after="M72">
1018  <owner>donnd@chromium.org</owner>
1019  <owner>twellington@chromium.org</owner>
1020  <summary>
1021    Whether results were seen for a Tap that was of long duration. Recorded when
1022    the UX is hidden. Implemented for Android.
1023  </summary>
1024</histogram>
1025
1026<histogram name="Search.ContextualSearchTapLongWordSeen"
1027    enum="ContextualSearchResultsSeen" expires_after="M72">
1028  <owner>donnd@chromium.org</owner>
1029  <owner>twellington@chromium.org</owner>
1030  <summary>
1031    Whether results were seen for a Tap that was on a word considered long.
1032    Recorded when the UX is hidden. Implemented for Android.
1033  </summary>
1034</histogram>
1035
1036<histogram name="Search.ContextualSearchTapOnWordMiddleSeen"
1037    enum="ContextualSearchResultsSeen" expires_after="M72">
1038  <owner>donnd@chromium.org</owner>
1039  <owner>twellington@chromium.org</owner>
1040  <summary>
1041    Whether results were seen for a Tap that was on the middle part of a word.
1042    Recorded when the UX is hidden. Implemented for Android.
1043  </summary>
1044</histogram>
1045
1046<histogram name="Search.ContextualSearchTapShortDurationSeen"
1047    enum="ContextualSearchResultsSeen" expires_after="M72">
1048  <owner>donnd@chromium.org</owner>
1049  <owner>twellington@chromium.org</owner>
1050  <summary>
1051    Whether results were seen for a Tap that was of short duration. Recorded
1052    when the UX is hidden. Implemented for Android.
1053  </summary>
1054</histogram>
1055
1056<histogram name="Search.ContextualSearchTapShortWordSeen"
1057    enum="ContextualSearchResultsSeen" expires_after="M72">
1058  <owner>donnd@chromium.org</owner>
1059  <owner>twellington@chromium.org</owner>
1060  <summary>
1061    Whether results were seen for a Tap that was on a word considered short.
1062    Recorded when the UX is hidden. Implemented for Android.
1063  </summary>
1064</histogram>
1065
1066<histogram name="Search.ContextualSearchTapsSinceOpenDecided" units="taps"
1067    expires_after="M72">
1068  <owner>donnd@chromium.org</owner>
1069  <owner>twellington@chromium.org</owner>
1070  <summary>
1071    The count of taps that showed a peeking bar without the opt-out promo since
1072    this user has last opened the panel.
1073  </summary>
1074</histogram>
1075
1076<histogram name="Search.ContextualSearchTapsSinceOpenUndecided" units="taps"
1077    expires_after="M72">
1078  <owner>donnd@chromium.org</owner>
1079  <owner>twellington@chromium.org</owner>
1080  <summary>
1081    The count of taps that showed a peeking bar with the opt-out promo since
1082    this user has last opened the panel.
1083  </summary>
1084</histogram>
1085
1086<histogram
1087    name="Search.ContextualSearchTapSuppressionSeen.AnyHeuristicSatisfied"
1088    enum="ContextualSearchSuppressionResultsSeen" expires_after="M72">
1089  <owner>donnd@chromium.org</owner>
1090  <owner>twellington@chromium.org</owner>
1091  <summary>
1092    Whether results were seen for a Tap and whether any suppression heuristic
1093    was satisifed. Recorded when the UX is still shown (suppression not enabled,
1094    only logged). Implemented for Android.
1095  </summary>
1096</histogram>
1097
1098<histogram name="Search.ContextualSearchTimeToSearch" units="ms"
1099    expires_after="M72">
1100  <owner>donnd@chromium.org</owner>
1101  <owner>twellington@chromium.org</owner>
1102  <summary>
1103    The time between tapping on a word and performing a search. Implemented for
1104    Android.
1105  </summary>
1106</histogram>
1107
1108<histogram name="Search.ContextualSearchTopLocationNotSeen" units="dps"
1109    expires_after="M72">
1110  <owner>donnd@chromium.org</owner>
1111  <owner>twellington@chromium.org</owner>
1112  <summary>
1113    The DPs count histogram for Taps that were not seen. Implemented for
1114    Android.
1115  </summary>
1116</histogram>
1117
1118<histogram name="Search.ContextualSearchTopLocationSeen" units="dps"
1119    expires_after="M72">
1120  <owner>donnd@chromium.org</owner>
1121  <owner>twellington@chromium.org</owner>
1122  <summary>
1123    The DPs count histogram for Taps that were seen. Implemented for Android.
1124  </summary>
1125</histogram>
1126
1127<histogram name="Search.ContextualSearchTranslateCondition" enum="Boolean"
1128    expires_after="M77">
1129  <owner>donnd@chromium.org</owner>
1130  <owner>twellington@chromium.org</owner>
1131  <summary>
1132    For each contextual search that is triggered by tap, records whether the
1133    translation conditions are met. Implemented for Android.
1134  </summary>
1135</histogram>
1136
1137<histogram name="Search.DefaultSearchChangeOrigin"
1138    enum="DefaultSearchChangeOrigin" expires_after="M81">
1139  <owner>mathp@chromium.org</owner>
1140  <summary>
1141    The origin/cause of a change to the default search provider.
1142  </summary>
1143</histogram>
1144
1145<histogram name="Search.DefaultSearchProviderType"
1146    enum="OmniboxSearchEngineType" expires_after="2021-06-30">
1147  <owner>mpearson@chromium.org</owner>
1148  <owner>csharp@chromium.org</owner>
1149  <summary>
1150    The type of the default search engine that is loaded when a profile is
1151    opened or after a profile reset. Note that at least one profile is opened on
1152    startup. Due to an error, there was a period from roughly May 9 2014 to May
1153    23 2014 during which this was not being logged.
1154  </summary>
1155</histogram>
1156
1157<histogram name="Search.GsaAccountChangeNotificationSource"
1158    enum="GsaAccountChangeNotificationSource" expires_after="M77">
1159  <owner>lizeb@chromium.org</owner>
1160  <summary>
1161    On Android, when GSA tells Chrome about an account change, what is the
1162    notification mechanism used, which is either the service connection, or a
1163    broadcast. Recorded once per account change.
1164  </summary>
1165</histogram>
1166
1167<histogram name="Search.GsaBroadcastsAccountChanges"
1168    enum="BooleanAccountChange" expires_after="M77">
1169  <owner>lizeb@chromium.org</owner>
1170  <summary>
1171    On Android, whether GSA tells Chrome about account changes through the
1172    service or through a broadcast. This is reported at most once per Chrome
1173    startup.
1174  </summary>
1175</histogram>
1176
1177<histogram name="Search.HistoryReport.DeltaFile.LastSeqNo" units="count"
1178    expires_after="M71">
1179  <owner>wychen@chromium.org</owner>
1180  <owner>yusufo@chromium.org</owner>
1181  <summary>
1182    The last sequential number in the delta file for Icing. This is measured on
1183    cold start.
1184  </summary>
1185</histogram>
1186
1187<histogram name="Search.HistoryReport.DeltaFile.LevelDBEntries" units="entries"
1188    expires_after="2019-06-01">
1189  <owner>wychen@chromium.org</owner>
1190  <owner>yusufo@chromium.org</owner>
1191  <summary>
1192    The number of entries in the delta file level DB for Icing. This is measured
1193    on cold start.
1194  </summary>
1195</histogram>
1196
1197<histogram name="Search.HistoryReport.UsageReportsBuffer.LevelDBEntries"
1198    units="entries" expires_after="2019-06-01">
1199  <owner>wychen@chromium.org</owner>
1200  <owner>yusufo@chromium.org</owner>
1201  <summary>
1202    The number of entries in the usage report level DB for Icing. This is
1203    measured on cold start.
1204  </summary>
1205</histogram>
1206
1207<histogram name="Search.IcingContextReportingStatus"
1208    enum="IcingContextReportingStatus" expires_after="M77">
1209  <owner>donnd@chromium.org</owner>
1210  <summary>
1211    Records the reason why a context report to Icing failed, every time Chrome
1212    attemps to record the current context (tab switching, navigations, etc).
1213    Also records reasons why context reporting might be disabled. Recorded on
1214    Android only.
1215  </summary>
1216</histogram>
1217
1218<histogram name="Search.iOS.SelectDefaultSearchEngine"
1219    enum="OmniboxSearchEngineType" expires_after="2021-02-04">
1220  <owner>sczs@chromium.org</owner>
1221  <owner>gambard@chromium.org</owner>
1222  <summary>
1223    When an iOS user changes the default search engine in chrome Settings,
1224    records the search engine's type.
1225  </summary>
1226</histogram>
1227
1228<histogram name="Search.PartnershipSearchPerformed" enum="SearchEntryPoint"
1229    expires_after="M85">
1230  <owner>yusufo@chromium.org</owner>
1231  <summary>
1232    The entry point used for all searches performed under partnership after the
1233    Android search engine promo dialog was shown. This is a dialog prompting the
1234    user to pick a default search engine. This metric is collected for every
1235    search query performed.
1236  </summary>
1237</histogram>
1238
1239<histogram base="true" name="Search.QueryTiles.Bitmap.Available"
1240    enum="BooleanAvailable" expires_after="M91">
1241<!-- Name completed by histogram_suffixes name="TileUiSurface" -->
1242
1243  <owner>shaktisahu@chromium.org</owner>
1244  <owner>chrome-upboarding-eng@google.com</owner>
1245  <summary>
1246    Indicates whether or not a bitmap could be shown for a tile.
1247  </summary>
1248</histogram>
1249
1250<histogram base="true" name="Search.QueryTiles.Bitmap.FetchDuration" units="ms"
1251    expires_after="M91">
1252<!-- Name completed by histogram_suffixes name="TileUiSurface" -->
1253
1254  <owner>shaktisahu@chromium.org</owner>
1255  <owner>chrome-upboarding-eng@google.com</owner>
1256  <summary>
1257    Records the time taken to fetch a bitmap for a tile when a bitmap could be
1258    found. It includes the time starting from the UI layer requesting the
1259    backend till the backend returns the associated bitmap.
1260  </summary>
1261</histogram>
1262
1263<histogram name="Search.QueryTiles.Fetcher.FirstFlowDuration" units="hours"
1264    expires_after="M91">
1265  <owner>hesen@chromium.org</owner>
1266  <owner>chrome-upboarding-eng@google.com</owner>
1267  <summary>
1268    Records duration from time when first task scheduled to time the fetch task
1269    completed.
1270  </summary>
1271</histogram>
1272
1273<histogram name="Search.QueryTiles.Fetcher.Start" units="hours"
1274    expires_after="M91">
1275  <owner>hesen@chromium.org</owner>
1276  <owner>chrome-upboarding-eng@google.com</owner>
1277  <summary>Records the hour (0-23) when the TileFetcher task starts.</summary>
1278</histogram>
1279
1280<histogram name="Search.QueryTiles.FetcherHttpResponseCode"
1281    enum="HttpResponseCode" expires_after="M91">
1282  <owner>hesen@chromium.org</owner>
1283  <owner>chrome-upboarding-eng@google.com</owner>
1284  <summary>Records the HTTP response code get from TileFetcher.</summary>
1285</histogram>
1286
1287<histogram name="Search.QueryTiles.FetcherNetErrorCode" enum="NetErrorCodes"
1288    expires_after="M91">
1289  <owner>hesen@chromium.org</owner>
1290  <owner>chrome-upboarding-eng@google.com</owner>
1291  <summary>Records the net error code get from TileFetcher.</summary>
1292</histogram>
1293
1294<histogram name="Search.QueryTiles.Group.PruneReason"
1295    enum="QueryTilesGroupPruneReason" expires_after="M91">
1296  <owner>hesen@chromium.org</owner>
1297  <owner>chrome-upboarding-eng@google.com</owner>
1298  <summary>
1299    Records the reasons caused the tile group pruned in TileManager.
1300  </summary>
1301</histogram>
1302
1303<histogram name="Search.QueryTiles.GroupStatus" enum="QueryTilesGroupStatus"
1304    expires_after="M91">
1305  <owner>hesen@chromium.org</owner>
1306  <owner>chrome-upboarding-eng@google.com</owner>
1307  <summary>
1308    Records the TileManager status after initialized and loaded completed.
1309  </summary>
1310</histogram>
1311
1312<histogram name="Search.QueryTiles.ImagePreloadingEvent"
1313    enum="QueryTilesImageLoadingEvent" expires_after="M91">
1314  <owner>xingliu@chromium.org</owner>
1315  <owner>chrome-upboarding-eng@google.com</owner>
1316  <summary>
1317    Records the image preloading events when the query tile images are fetched
1318    from the background task.
1319  </summary>
1320</histogram>
1321
1322<histogram base="true" name="Search.QueryTiles.NoBitmap.FetchDuration"
1323    units="ms" expires_after="M91">
1324<!-- Name completed by histogram_suffixes name="TileUiSurface" -->
1325
1326  <owner>shaktisahu@chromium.org</owner>
1327  <owner>chrome-upboarding-eng@google.com</owner>
1328  <summary>
1329    Records the time taken by the bitmap request for a tile when no bitmap could
1330    be found. It includes the time starting from the UI layer requesting the
1331    backend till the backend returns the associated bitmap.
1332  </summary>
1333</histogram>
1334
1335<histogram name="Search.QueryTiles.NTP.Chip.SearchClicked" units="index"
1336    expires_after="M91">
1337  <owner>shaktisahu@chromium.org</owner>
1338  <owner>chrome-upboarding-eng@google.com</owner>
1339  <summary>
1340    Records the index of the query tile chip that was clicked from the fake
1341    search box on the new tab page.
1342  </summary>
1343</histogram>
1344
1345<histogram name="Search.QueryTiles.RequestStatus"
1346    enum="QueryTilesRequestStatus" expires_after="M91">
1347  <owner>hesen@chromium.org</owner>
1348  <owner>chrome-upboarding-eng@google.com</owner>
1349  <summary>
1350    Records the TileFetcher status after request send to server and response
1351    received.
1352  </summary>
1353</histogram>
1354
1355<histogram base="true" name="Search.QueryTiles.Tile.Clicked" units="index"
1356    expires_after="M91">
1357<!-- Name completed by histogram_suffixes name="TileUiSurface" -->
1358
1359  <owner>shaktisahu@chromium.org</owner>
1360  <owner>chrome-upboarding-eng@google.com</owner>
1361  <summary>
1362    Records the index of the tile that was clicked. The index refers to the
1363    position of the tile in the carousel.
1364  </summary>
1365</histogram>
1366
1367<histogram base="true" name="Search.QueryTiles.Tile.Clicked.IsTopLevel"
1368    enum="BooleanIsTopLevel" expires_after="M91">
1369<!-- Name completed by histogram_suffixes name="TileUiSurface" -->
1370
1371  <owner>shaktisahu@chromium.org</owner>
1372  <owner>chrome-upboarding-eng@google.com</owner>
1373  <summary>Indicates whether the tile clicked was a top level tile.</summary>
1374</histogram>
1375
1376<histogram base="true" name="Search.QueryTiles.TileCount" units="tiles"
1377    expires_after="M91">
1378<!-- Name completed by histogram_suffixes name="TileUiSurface" -->
1379
1380  <owner>shaktisahu@chromium.org</owner>
1381  <owner>chrome-upboarding-eng@google.com</owner>
1382  <summary>
1383    Indicates the number of tiles displayed in the UI after the backend was
1384    loaded.
1385  </summary>
1386</histogram>
1387
1388<histogram name="Search.QueryTiles.TilesFitPerRow" units="tiles"
1389    expires_after="M91">
1390  <owner>shaktisahu@chromium.org</owner>
1391  <owner>chrome-upboarding-eng@google.com</owner>
1392  <summary>
1393    Records the number of tiles per row that can be fit into the screen in the
1394    default scroll position.
1395  </summary>
1396</histogram>
1397
1398<histogram name="Search.QueryTiles.TileWidth" units="dp" expires_after="M91">
1399  <owner>shaktisahu@chromium.org</owner>
1400  <owner>chrome-upboarding-eng@google.com</owner>
1401  <summary>
1402    Records the width of a single query tile when shown in the carousel.
1403  </summary>
1404</histogram>
1405
1406<histogram name="Search.QueryTiles.TrendingTileEvent" enum="TrendingTileEvent"
1407    expires_after="M91">
1408  <owner>qinmin@chromium.org</owner>
1409  <owner>chrome-upboarding-eng@google.com</owner>
1410  <summary>
1411    Records events related to trending tiles, including display, removal and
1412    click, after the events occur.
1413  </summary>
1414</histogram>
1415
1416<histogram name="Search.RelatedSearches.AllUserPermissions"
1417    enum="ContextualSearchPermissions" expires_after="M91">
1418  <owner>donnd@chromium.org</owner>
1419  <owner>related-searches-vteam@google.com</owner>
1420  <summary>
1421    Enumerates all users by the permissions needed in order to use the Related
1422    Searches feature. This tells us the potential user pool if we were to remove
1423    one of the current requirements (which are sending page content and sending
1424    the URL to Google). Logged whenever the Chrome application is paused. NOTE:
1425    Use the Count unique clients option to count users since multiple events are
1426    logged for each user. Implemented for Android.
1427  </summary>
1428</histogram>
1429
1430<histogram name="Search.RelatedSearches.QualifiedUsers" enum="Boolean"
1431    expires_after="M92">
1432  <owner>donnd@chromium.org</owner>
1433  <owner>related-searches-vteam@google.com</owner>
1434  <summary>
1435    Records true for every user that is qualified for the Related Searches
1436    experiment regardless of whether that feature is enabled or not. Never logs
1437    false. Used to validate that population sizes are relatively equal (since
1438    only a subset is actually qualified). Logged whenever a user triggers
1439    Contextual Search in way that could activate Related Searches (i.e. sends
1440    context). NOTE: Use the Count unique clients option to count users since
1441    multiple events are logged for each user. Implemented for Android.
1442  </summary>
1443</histogram>
1444
1445<histogram name="Search.SearchEngineListedInPromoDialog"
1446    enum="OmniboxSearchEngineType" expires_after="M81">
1447<!-- Name completed by histogram_suffixes name="SearchEnginePromoOrdering" and name="SearchEnginePromoDeviceType" -->
1448
1449  <owner>yusufo@chromium.org</owner>
1450  <summary>
1451    The search engines listed in the options for search engine promo. This is an
1452    Android specific dialog prompting the user to pick a default search engine.
1453    The dialog was shown on a device that had Chrome before it was first
1454    introduced.
1455  </summary>
1456</histogram>
1457
1458<histogram name="Search.SearchEngineSelectionInPromoDialog"
1459    enum="OmniboxSearchEngineType" expires_after="M81">
1460  <owner>yusufo@chromium.org</owner>
1461  <summary>
1462    The search engine selected by the user from the search engine promo. This is
1463    an Android specific dialog prompting the user to pick a default search
1464    engine. The dialog was shown on a device that had Chrome before it was first
1465    introduced.
1466  </summary>
1467</histogram>
1468
1469<histogram name="Search.SearchWidgetUseAndDeviceInfo"
1470    enum="SearchWidgetUseInfo" expires_after="2020-02-16">
1471  <owner>yusufo@chromium.org</owner>
1472  <summary>
1473    The current state for search widget use and whether the device is a
1474    partnership device related with the Android Search Widget. Collected on
1475    every cold start.
1476  </summary>
1477</histogram>
1478
1479<histogram name="Search.TemplateURL.Events" enum="SearchTemplateURLEvent"
1480    expires_after="2021-10-01">
1481  <owner>tommycli@chromium.org</owner>
1482  <owner>chrome-omnibox-team@google.com</owner>
1483  <summary>
1484    Records when TemplateURL encounters specific events, particularly during
1485    Sync or startup. There's a bunch of edge cases being handled by complicated
1486    code within TemplateURLService, and we'd like to learn how often they
1487    actually occur in the wild.
1488  </summary>
1489</histogram>
1490
1491<histogram name="SearchAnswer.AnswerVisibleTime" units="ms"
1492    expires_after="2021-09-01">
1493  <owner>mmourgos@chromium.org</owner>
1494  <owner>newcomer@chromium.org</owner>
1495  <summary>Time between showing and hiding the answer card.</summary>
1496</histogram>
1497
1498<histogram name="SearchAnswer.LoadingTime" units="ms" expires_after="M85">
1499  <owner>newcomer@chromium.org</owner>
1500  <summary>
1501    Time between sending an answer server request and the end of loading of the
1502    answer card. Failed requests and requests not returning an answer are not
1503    counted.
1504  </summary>
1505</histogram>
1506
1507<histogram name="SearchAnswer.NavigationTime" units="ms" expires_after="M85">
1508  <owner>newcomer@chromium.org</owner>
1509  <summary>
1510    Time between sending an answer server request and successful finish of
1511    navigation. Failed requests and requests not returning an answer are not
1512    counted.
1513  </summary>
1514</histogram>
1515
1516<histogram name="SearchAnswer.RequestResult" enum="SearchAnswerRequestResult"
1517    expires_after="M85">
1518  <owner>newcomer@chromium.org</owner>
1519  <summary>Result of a answer server request.</summary>
1520</histogram>
1521
1522<histogram name="SearchAnswer.ResizeAfterLoadTime" units="ms"
1523    expires_after="M85">
1524  <owner>newcomer@chromium.org</owner>
1525  <summary>
1526    Time between successfully loading an answer card request and updating its
1527    preferred size. There might be no or more than one size update per card
1528    load. Size updates that happen before the card finishes loading are ignored
1529    since they are not visible.
1530  </summary>
1531</histogram>
1532
1533</histograms>
1534
1535</histogram-configuration>
1536