<!--
Copyright 2020 The Chromium Authors. All rights reserved.
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
-->

<!--
This file is used to generate a comprehensive list of Assistant histograms
along with a detailed description for each histogram.

For best practices on writing histogram descriptions, see
https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md

Please follow the instructions in the OWNERS file in this directory to find a
reviewer. If no OWNERS file exists, please consider signing up at
go/reviewing-metrics (Googlers only), as all subdirectories are expected to
have an OWNERS file. As a last resort you can send the CL to
chromium-metrics-reviews@google.com.
-->

<histogram-configuration>

<histograms>

<variants name="QuickAnswersClickResultType">
  <variant name=".Definition" summary="Definition result type"/>
  <variant name=".NoResult" summary="Result is not available"/>
  <variant name=".Translation" summary="Translation result type"/>
  <variant name=".UnitConversion" summary="UnitConversion result type"/>
</variants>

<variants name="QuickAnswersConsentInteractionType">
  <variant name=".Accept" summary="Clicks on the accept button"/>
  <variant name=".Dismiss" summary="Dismisses the consent"/>
  <variant name=".ManageSettings"
      summary="Clicks on the 'manage settings' button"/>
</variants>

<variants name="QuickAnswersV2ConsentResultType">
  <variant name=".Allow" summary="Clicks on the allow button"/>
  <variant name=".Dismiss" summary="Dismisses or ignores the consent"/>
  <variant name=".NoThanks" summary="Clicks on the no thanks button"/>
</variants>

<variants name="UserEligibilityTiming">
<!--
    Before M90, the base ("") variant was reported multiple times per search
    and at other random points in time.

    From M90 onwards, this is reported to exactly once per mic click.
  -->

  <variant name="" summary="when the mic button is pressed"/>
  <variant name=".Startup" summary="on browser startup"/>
</variants>

<histogram name="Assistant.BetterOnboarding.Click"
    enum="AssistantBetterOnboardingType" expires_after="2022-05-01">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    The number of times Assistant better onboarding buttons are clicked.
  </summary>
</histogram>

<histogram name="Assistant.BetterOnboarding.Shown"
    enum="AssistantBetterOnboardingMode" expires_after="2021-12-19">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    The number of times Assistant better onboarding UI is shown. The UI has a
    few different modes recorded in the enum.
  </summary>
</histogram>

<histogram name="Assistant.ButtonClickCount" enum="AssistantButtonId"
    expires_after="2022-04-11">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    The number of times buttons on Assistant UI (e.g., minimize) are clicked.
  </summary>
</histogram>

<histogram name="Assistant.ContextEnabledUserCount" enum="BooleanEnabled"
    expires_after="2022-04-24">
  <owner>updowndota@chromium.org</owner>
  <owner>xiaohuic@chromium.org</owner>
  <summary>
    Among eligible users, whether the user has the Assistant context (related
    info) enabled. Recorded once for every UMA upload. The set of eligible users
    includes all users with profiles that can allow Assistant service to be
    enabled (AssistantAllowedState is limited by locale, policy, etc).
  </summary>
</histogram>

<histogram name="Assistant.DspHotwordDetection"
    enum="DspHotwordDetectionStatus" expires_after="2022-06-12">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Counts the number of times Dsp hotword gets detected in each status, to help
    capture the hotword false acceptance rate.
  </summary>
</histogram>

<histogram name="Assistant.EntryPoint" enum="AssistantEntryPoint"
    expires_after="2022-08-09">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Record the Assistant entry point where Assistant UI becomes visible.
    ChromeOS only.
  </summary>
</histogram>

<histogram name="Assistant.ExitPoint" enum="AssistantExitPoint"
    expires_after="2022-08-09">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Record the Assistant exit point where Assistant UI becomes invisible.
    ChromeOS only.
  </summary>
</histogram>

<histogram name="Assistant.HotwordEnableNotification" enum="BooleanHit"
    expires_after="2022-12-31">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Counts the number of times user click the hotword enable notification to
    open Assistant settings.
  </summary>
</histogram>

<histogram name="Assistant.Interaction.Resolution"
    enum="AssistantInteractionResolution" expires_after="2021-07-22">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Record the Assistant interaction resolution code. It indicates how the
    Assistant server interpreted a particular query and decision on the state,
    e.g. if the conversation is normal or timed out or ended with other errors.
  </summary>
</histogram>

<histogram name="Assistant.OptInFlow.GetSettingsRequestTime" units="ms"
    expires_after="2022-09-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Amount of time between get settings request and response. The request will
    be sent for each time the Assistant OptIn Flow is triggered to get string
    texts from the server.
  </summary>
</histogram>

<histogram name="Assistant.OptInFlow.LoadingTimeoutCount" units="timeouts"
    expires_after="2022-09-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Number of times that the loading timeout triggers. The loading timeout is
    set by the Assistant OptIn Flow loading screen, which shows up during the
    server string texts and webviews are pending.
  </summary>
</histogram>

<histogram name="Assistant.OptInFlowStatus" enum="AssistantOptInFlowStatus"
    expires_after="2022-04-10">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>Record the status of the Assistant opt-in flow.</summary>
</histogram>

<histogram name="Assistant.QueryCountPerEntryPoint" enum="AssistantEntryPoint"
    expires_after="2022-12-26">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>Number of queries fired for each entry point.</summary>
</histogram>

<histogram name="Assistant.QueryResponseType" enum="AssistantQueryResponseType"
    expires_after="2022-07-01">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>The Assistant query response type.</summary>
</histogram>

<histogram name="Assistant.QuerySource" enum="AssistantQuerySource"
    expires_after="2022-05-01">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    The source of Assistant query (e.g. dialog plate text field, voice input).
    Recorded when the query is committed.
  </summary>
</histogram>

<histogram name="Assistant.ServiceEnabledUserCount" enum="BooleanEnabled"
    expires_after="2022-04-24">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Among eligible users, whether the user has the Assistant service enabled.
    Recorded once for every UMA upload. The set of eligible users includes all
    users with profiles that can allow Assistant service to be enabled
    (AssistantAllowedState is limited by locale, policy, etc).
  </summary>
</histogram>

<histogram name="Assistant.ServiceReadyTime" units="ms"
    expires_after="2022-08-29">
  <owner>xiaohuic@chromium.org</owner>
  <summary>
    Amount of time between when the Assistant service is launched, and when the
    Assistant back-end signals it is ready to process queries.
  </summary>
</histogram>

<histogram name="Assistant.ServiceStartTime" units="ms"
    expires_after="2022-08-29">
  <owner>updowndota@chromium.org</owner>
  <summary>Amount of time spent in starting Assistant service.</summary>
</histogram>

<histogram name="Assistant.SetDspHotwordLocale" enum="BooleanSuccess"
    expires_after="2022-05-01">
  <owner>xiaohuic@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For each attempt to set the hotword locale for a DSP device, counts whether
    the attempt succeeded.
  </summary>
</histogram>

<histogram name="Assistant.VoiceSearch.AgsaVersion{Timing}" units="Version"
    expires_after="2022-08-22">
  <owner>wylieb@chromium.org</owner>
  <owner>fgorski@chromium.org</owner>
  <owner>jds@google.com</owner>
  <summary>
    (Android only) Reports the current Agsa version on the device. The version
    is reported as described in GSAState#parseAgsaMajorMinorVersionAsInteger.

    This is reported {Timing}.
  </summary>
  <token key="Timing" variants="UserEligibilityTiming"/>
</histogram>

<histogram name="Assistant.VoiceSearch.ConsentOutcome"
    enum="AssistantConsentOutcome" expires_after="2022-08-22">
  <owner>wylieb@chromium.org</owner>
  <owner>fgorski@chromium.org</owner>
  <owner>jds@google.com</owner>
  <summary>
    (Android only) Reports the outcome of the consent dialog shown for the
    assistant.
  </summary>
</histogram>

<histogram name="Assistant.VoiceSearch.UserEligibility.FailureReason{Timing}"
    enum="EligibilityFailureReason" expires_after="2022-08-22">
  <owner>wylieb@chromium.org</owner>
  <owner>fgorski@chromium.org</owner>
  <owner>jds@google.com</owner>
  <summary>
    (Android only) Reports why users failed the eligibility check for the
    feature.

    Before M90, this histogram only reported the FailureReason which failed the
    eligibility check. If a client failed for multiple reasons, some would be
    ignored.

    From M90 onwards, this will report all FailureReasons that effect
    eligibility.

    This is reported {Timing}.
  </summary>
  <token key="Timing" variants="UserEligibilityTiming"/>
</histogram>

<histogram name="Assistant.VoiceSearch.UserEligibility{Timing}"
    enum="BooleanEligible" expires_after="2022-08-22">
  <owner>wylieb@chromium.org</owner>
  <owner>fgorski@chromium.org</owner>
  <owner>jds@google.com</owner>
  <summary>
    (Android only) Reports user eligibility for Assistant voice search. This is
    reported even when the feature is disabled.

    This is reported {Timing}.
  </summary>
  <token key="Timing" variants="UserEligibilityTiming"/>
</histogram>

<histogram name="QuickAnswers.ActiveImpression" enum="QuickAnswersResultType"
    expires_after="2022-05-01">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For quick answer impression that fulfills a user's intent, records the
    result type. ChromeOS only.
  </summary>
</histogram>

<histogram
    name="QuickAnswers.ActiveImpression.Duration{QuickAnswersClickResultType}"
    units="ms" expires_after="2022-01-16">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For quick answer impression that fulfills a user's intent, records the
    impression duration. ChromeOS only. {QuickAnswersClickResultType}
  </summary>
  <token key="QuickAnswersClickResultType"
      variants="QuickAnswersClickResultType">
    <variant name=""/>
  </token>
</histogram>

<histogram name="QuickAnswers.Click" enum="QuickAnswersResultType"
    expires_after="2022-04-24">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answer click event, records the result type. ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.Click.Duration{QuickAnswersClickResultType}"
    units="ms" expires_after="2022-11-21">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answer click event, records the duration between fetch
    finish and user clicks. ChromeOS only. {QuickAnswersClickResultType}
  </summary>
  <token key="QuickAnswersClickResultType"
      variants="QuickAnswersClickResultType">
    <variant name=""/>
  </token>
</histogram>

<histogram name="QuickAnswers.Consent" units="impressions" expires_after="M98">
  <obsolete>
    Removed 10-2021
  </obsolete>
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers consent impression, records how many times the user
    has seen the consent. ChromeOS only.
  </summary>
</histogram>

<histogram
    name="QuickAnswers.Consent.Duration{QuickAnswersConsentInteractionType}"
    units="ms" expires_after="M98">
  <obsolete>
    Removed 10-2021
  </obsolete>
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers consent interaction event, records how long the user
    has seen the consent before. ChromeOS only.
    {QuickAnswersConsentInteractionType}
  </summary>
  <token key="QuickAnswersConsentInteractionType"
      variants="QuickAnswersConsentInteractionType">
    <variant name="">
      <obsolete>
        Base histogram. Use suffixes of this histogram instead.
      </obsolete>
    </variant>
  </token>
</histogram>

<histogram
    name="QuickAnswers.Consent.Impression{QuickAnswersConsentInteractionType}"
    units="impressions" expires_after="M98">
  <obsolete>
    Removed 10-2021
  </obsolete>
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers consent interaction event, records how many times
    the user has seen the consent before. ChromeOS only.
    {QuickAnswersConsentInteractionType}
  </summary>
  <token key="QuickAnswersConsentInteractionType"
      variants="QuickAnswersConsentInteractionType">
    <variant name="">
      <obsolete>
        Base histogram. Use suffixes of this histogram instead.
      </obsolete>
    </variant>
  </token>
</histogram>

<histogram name="QuickAnswers.ContextMenu.Close" enum="BooleanClicked"
    expires_after="2022-04-10">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Records whether or not the user interacted (via clicking) with a context
    menu, whether or not that menu included any Quick Answers. Recorded when the
    menu is closed. This metric can be used as a baseline for Quick Answers
    engagement metrics, which record whether users click on context menus that
    *do* include a Quick Answers card. Recorded on ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.ContextMenu.Close.Duration{InteractionType}"
    units="ms" expires_after="2022-12-31">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Records the amount of time the context menu was shown before close if the
    user {InteractionType} (via clicking) with the context menu. Recorded on
    ChromeOS only.
  </summary>
  <token key="InteractionType">
    <variant name="WithClick" summary="has interacted"/>
    <variant name="WithoutClick" summary="has not interacted"/>
  </token>
</histogram>

<histogram name="QuickAnswers.ExitPoint" enum="QuickAnswersExitPoint"
    expires_after="2022-09-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Record the Quick Answers exit point point when the Quick Answers UI is
    dismissed. ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.Intent" enum="QuickAnswersIntentType"
    expires_after="2022-04-10">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For quick answer fetch, records the intent generated on-device. ChromeOS
    only.
  </summary>
</histogram>

<histogram name="QuickAnswers.Loading.Duration" units="ms"
    expires_after="2022-01-23">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers fetch, records the duration between fetch start and
    fetch finish. ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.Loading.Status" enum="QuickAnswersLoadStatus"
    expires_after="2022-12-31">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers fetch, records the result status. ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.NetworkError.IntentType"
    enum="QuickAnswersIntentType" expires_after="2022-05-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    Records the intent type when network error occurs during the quick answers
    fetch. ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.RequestTextLength.{IntentType}"
    units="characters" expires_after="2022-09-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answer request, records the length of the selected text that
    is being used for fetching {IntentType} results. ChromeOS only.
  </summary>
  <token key="IntentType">
    <variant name="Definition" summary="definition"/>
    <variant name="Translation" summary="translation"/>
    <variant name="UnitConversion" summary="unit conversion"/>
  </token>
</histogram>

<histogram name="QuickAnswers.Result" enum="QuickAnswersResultType"
    expires_after="2022-04-03">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answer result received event, records the result type.
    ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.Result.Duration{QuickAnswersClickResultType}"
    units="ms" expires_after="2022-12-31">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answer result received event, records the duration between
    fetch start and fetch finish. ChromeOS only. {QuickAnswersClickResultType}
  </summary>
  <token key="QuickAnswersClickResultType"
      variants="QuickAnswersClickResultType">
    <variant name=""/>
  </token>
</histogram>

<histogram name="QuickAnswers.SelectedContent.Length" units="characters"
    expires_after="2022-04-10">
  <owner>updowndota@chromium.org</owner>
  <owner>llin@google.com</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answer request, records the length of the selected text that
    is being considered for fetching quick answers. ChromeOS only.
  </summary>
</histogram>

<histogram name="QuickAnswers.V2.Consent" units="impressions"
    expires_after="2022-09-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers consent impression, records how many times the user
    has seen the consent. ChromeOS only.
  </summary>
</histogram>

<histogram
    name="QuickAnswers.V2.Consent.Duration{QuickAnswersV2ConsentResultType}"
    units="ms" expires_after="2022-09-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers consent result event, records how long the user has
    seen the consent before. ChromeOS only. {QuickAnswersV2ConsentResultType}
  </summary>
  <token key="QuickAnswersV2ConsentResultType"
      variants="QuickAnswersV2ConsentResultType"/>
</histogram>

<histogram
    name="QuickAnswers.V2.Consent.Impression{QuickAnswersV2ConsentResultType}"
    units="impressions" expires_after="2022-09-01">
  <owner>updowndota@chromium.org</owner>
  <owner>croissant-eng@chromium.org</owner>
  <summary>
    For every quick answers consent result event, records how many times the
    user has seen the consent before. ChromeOS only.
    {QuickAnswersV2ConsentResultType}
  </summary>
  <token key="QuickAnswersV2ConsentResultType"
      variants="QuickAnswersV2ConsentResultType"/>
</histogram>

</histograms>

</histogram-configuration>