<!--
Copyright 2021 The Chromium Authors
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 histograms related to
feature engagement 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="IPHDatabase">
  <variant name="AvailabilityStore" summary="Availability store"/>
  <variant name="EventStore" summary="Event store"/>
</variants>

<variants name="IPHFeature">
  <variant name="IPH_3pcdUserBypass"
      summary="promo for bypassing cookie blocking during third-party cookie
               deprecation"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_AddToBookmarks"
      summary="the add to bookmarks adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_NewTab"
      summary="the new tab adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_ReadAloud"
      summary="the Read Aloud adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_Share"
      summary="the share adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_Translate"
      summary="the translate adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_VoiceSearch"
      summary="the voice search adaptive button in the top toolbar"/>
  <variant name="IPH_AddToHomescreenMessage"
      summary="educating users about adding website shortcuts to their home
               screen (using a message UI)"/>
  <variant name="IPH_AddToHomescreenTextBubble"
      summary="(obsolete) educating users about adding website shortcuts to
               their home screen (using a text bubble)"/>
  <variant name="IPH_AutoDarkOptOut"
      summary="educating users about disabling auto dark feature globally"/>
  <variant name="IPH_AutoDarkUserEducationMessage"
      summary="message educating users about disabling auto dark web contents
               feature globally"/>
  <variant name="IPH_AutoDarkUserEducationMessageOptIn"
      summary="message educating users about enabling auto dark web contents
               feature globally"/>
  <variant name="IPH_AutofillExternalAccountProfileSuggestion"
      summary="message shown along with the externally created (e.g. in
               Google Pay) profile suggestion option in the Autofill dropdown"/>
  <variant name="IPH_AutofillVirtualCardCVCSuggestion"
      summary="message shown to users that have saved a virtual card on an
               online merchant website to educate users on how to fill in
               their virtual card verification code"/>
  <variant name="IPH_AutofillVirtualCardSuggestion"
      summary="message shown along with the virtual card suggestion option in
               the Autofill dropdown to educate users virtual cards come with
               better security"/>
  <variant name="IPH_BackNavigationMenu"
      summary="educating users about the back navigation menu to navigate
               back more than one page at a time."/>
  <variant name="IPH_BadgedReadingList" summary="badged reading list"/>
  <variant name="IPH_BatterySaverMode" summary="battery saver mode"/>
  <variant name="IPH_Bookmark" summary="bookmark"/>
  <variant name="IPH_BottomToolbarTip" summary="bottom toolbar"/>
  <variant name="IPH_ChromeDuet"
      summary="notifying users that search accelerator is at the bottom of
               the screen"/>
  <variant name="IPH_ChromeDuetHomeButton"
      summary="notifying users that home button has moved to the bottom of
               the screen"/>
  <variant name="IPH_ChromeDuetTabSwitcherButton"
      summary="notifying users that tab switcher button has moved to the
               bottom of the screen"/>
  <variant name="IPH_ChromeHomeExpand"
      summary="Chrome Home shown on cold start"/>
  <variant name="IPH_ChromeHomePullToRefresh"
      summary="Chrome Home shown after a pull-to-refresh"/>
  <variant name="IPH_CompanionSidePanel"
      summary="prompting users to view the companion feature in the side
               panel"/>
  <variant name="IPH_CompanionSidePanelRegionSearch"
      summary="prompting users to use the region search feature in the
               companion side panel"/>
  <variant name="IPH_ContextualPageActions_PriceTracking"
      summary="contextual page price tracking action in the top toolbar"/>
  <variant name="IPH_ContextualPageActions_PriceTrackingActionChip"
      summary="action chip variant of contextual page price tracking action
               in the top toolbar"/>
  <variant name="IPH_ContextualSearchInPanelHelp"
      summary="promoting longpress from within the panel"/>
  <variant name="IPH_ContextualSearchOptIn"
      summary="opting-in to contextual search"/>
  <variant name="IPH_ContextualSearchPromotePanelOpen"
      summary="opening the contextual search panel"/>
  <variant name="IPH_ContextualSearchPromoteTap"
      summary="tap trigger for contextual search"/>
  <variant name="IPH_ContextualSearchTappedButShouldLongpress"
      summary="contextual search to help users that try to trigger the
               feature with a tap to long-press instead"/>
  <variant name="IPH_ContextualSearchTranslationEnable"
      summary="contextual search to help users enable our privacy policy in
               order to get better translations"/>
  <variant name="IPH_ContextualSearchWebSearch"
      summary="contextual search for users who use web search"/>
  <variant name="IPH_CookieControls"
      summary="promo for third-party cookie blocking and controls"/>
  <variant name="IPH_DataSaverDetail" summary="data saver detail"/>
  <variant name="IPH_DataSaverMilestonePromo"
      summary="data saver milestone promo"/>
  <variant name="IPH_DataSaverPreview" summary="data saver preview"/>
  <variant name="IPH_DefaultSiteView" summary="default site view info on iOS"/>
  <variant name="IPH_DesktopCustomizeChrome"
      summary="customizing new tab page"/>
  <variant name="IPH_DesktopCustomizeChromeRefresh"
      summary="customizing new tab page for refresh"/>
  <variant name="IPH_DesktopPwaInstall" summary="desktop PWA install icon"/>
  <variant name="IPH_DesktopTabGroupsNewGroup"
      summary="creating a new tab group"/>
  <variant name="IPH_DownloadHome" summary="download home"/>
  <variant name="IPH_DownloadInfobarDownloadContinuing"
      summary="download infobar informing that downloads are still in
               progress"/>
  <variant name="IPH_DownloadInfoBarDownloadsAreFaster"
      summary="download infobar informing that downloads are now faster than
               before"/>
  <variant name="IPH_DownloadPage" summary="download page"/>
  <variant name="IPH_DownloadPageScreenshot"
      summary="download page for screenshot"/>
  <variant name="IPH_DownloadSettings"
      summary="accessing download settings from download home"/>
  <variant name="IPH_DownloadToolbarButton" summary="download toolbar button"/>
  <variant name="IPH_EphemeralTab"
      summary="new label on the context menu for Ephemeral Tab"/>
  <variant name="IPH_ExploreSitesTile" summary="Explore Sites feature"/>
  <variant name="IPH_ExtensionsMenu" summary="extensions menu opened"/>
  <variant name="IPH_ExtensionsRequestAccessButton"
      summary="extensions request access button shown"/>
  <variant name="IPH_FeatureNotificationGuideDefaultBrowserNotificationShown"
      summary="feature notification guide default browser notification"/>
  <variant name="IPH_FeatureNotificationGuideDefaultBrowserPromo"
      summary="feature notification guide default browser promo"/>
  <variant name="IPH_FeatureNotificationGuideIncognitoTabHelpBubble"
      summary="feature notification guide incognito tab help bubble"/>
  <variant name="IPH_FeatureNotificationGuideIncognitoTabNotificationShown"
      summary="feature notification guide incognito tab notification"/>
  <variant name="IPH_FeatureNotificationGuideNTPSuggestionCardHelpBubble"
      summary="feature notification guide NTP suggestion card help bubble"/>
  <variant
      name="IPH_FeatureNotificationGuideNTPSuggestionCardNotificationShown"
      summary="feature notification guide NTP suggestion card notification"/>
  <variant name="IPH_FeatureNotificationGuideSignInHelpBubble"
      summary="feature notification guide sign in help bubble"/>
  <variant name="IPH_FeatureNotificationGuideSignInNotificationShown"
      summary="feature notification guide sign in notification"/>
  <variant name="IPH_FeatureNotificationGuideVoiceSearchHelpBubble"
      summary="feature notification guide voice search help bubble"/>
  <variant name="IPH_FeatureNotificationGuideVoiceSearchNotificationShown"
      summary="feature notification guide voice search notification"/>
  <variant name="IPH_FeedCardMenu" summary="feed card menu on NTP"/>
  <variant name="IPH_FeedHeaderMenu" summary="feed header menu on NTP"/>
  <variant name="IPH_FeedSwipeRefresh" summary="swipe refreshing feeds on NTP"/>
  <variant name="IPH_FollowWhileBrowsing"
      summary="IPH for following the current site"/>
  <variant name="IPH_GenericAlwaysTriggerHelpUiFeature"
      summary="generic feature to always show help Ui whenever asked"/>
  <variant name="IPH_GlobalMediaControls" summary="the Global Media Controls"/>
  <variant name="IPH_GMCCastStartStop"
      summary="Cast start stop in the Zenith dialog"/>
  <variant name="IPH_GoogleOneOfferNotification"
      summary="show google one offer notification with a visit to Google
               Drive or Google Photo"/>
  <variant name="IPH_HighEfficiencyInfoMode" summary="High efficiency info"/>
  <variant name="IPH_HighEfficiencyMode"
      summary="encourages users to turn on high efficiency mode"/>
  <variant name="IPH_IdentityDisc" summary="Identity Disc"/>
  <variant name="IPH_IncognitoWindow" summary="incognito window"/>
  <variant name="IPH_InstanceSwitcher" summary="instance switcher"/>
  <variant name="IPH_IntentChip" summary="opening a webpage in an app"/>
  <variant name="IPH_iOSChoiceScreenFeature"
      summary="showing the Choice screen on iOS"/>
  <variant name="IPH_iOSDefaultBrowserBadgeEligibility"
      summary="default browser badge promo eligibility tracking"/>
  <variant name="IPH_iOSDefaultBrowserOverflowMenuBadge"
      summary="default browser badge promo on the overflow menu"/>
  <variant name="IPH_iOSDefaultBrowserSettingsBadge"
      summary="default browser badge promo on the settings menu row"/>
  <variant name="IPH_iOSDefaultBrowserVideoPromoTrigger"
      summary="notifying that the conditions to show the default browser
               video promo have been met."/>
  <variant name="IPH_iOSHistoryOnOverflowMenuFeature"
      summary="history item on the overflow menu on iOS"/>
  <variant name="IPH_iOSNewTabToolbarItemFeature"
      summary="the new tab tool bar item (bottom on iPhone, top on iPad)"/>
  <variant name="IPH_iOSPasswordPromoDesktop"
      summary="showing the iOS password promo on desktop"/>
  <variant name="IPH_iOSPromoAppStore"
      summary="showing the App Store Promo on iOS"/>
  <variant name="IPH_iOSPromoCredentialProviderExtension"
      summary="showing the Credential Provider Extension Promo on iOS"/>
  <variant name="IPH_iOSPromoDefaultBrowser"
      summary="showing the Default Browser Promo on iOS"/>
  <variant name="IPH_iOSPromoDefaultBrowserReminder"
      summary="showing the Default Browser Promo after remind me later on iOS"/>
  <variant name="IPH_iOSPromoPasswordManagerWidget"
      summary="showing the Password Manager widget promo on iOS"/>
  <variant name="IPH_iOSPromoPostRestore"
      summary="showing the Post Restore Promo on iOS"/>
  <variant name="IPH_iOSPromoPostRestoreDefaultBrowser"
      summary="showing the Post Restore Default Browser Promo on iOS"/>
  <variant name="IPH_iOSPromoWhatsNew"
      summary="showing the Whats New Promo on iOS"/>
  <variant name="IPH_iOSShareToolbarItemFeature"
      summary="the share tool bar item (bottom on iPhone, top on iPad)"/>
  <variant name="IPH_iOSTabGridToolbarItemFeature"
      summary="the tab grid tool bar item (bottom on iPhone, top on iPad)"/>
  <variant name="IPH_KeyboardAccessoryAddressFilling"
      summary="address autofill suggestions"/>
  <variant name="IPH_KeyboardAccessoryPasswordFilling"
      summary="password autofill suggestions"/>
  <variant name="IPH_KeyboardAccessoryPaymentFilling"
      summary="payments autofill suggestions"/>
  <variant name="IPH_KeyboardAccessoryPaymentOffer"
      summary="payments autofill suggestions that have an offer"/>
  <variant name="IPH_LauncherSearchHelpUi"
      summary="show launcher search chips in the launcher"/>
  <variant name="IPH_LiveCaption" summary="Live Caption"/>
  <variant name="IPH_LongPressToolbarTip" summary="LongPress toolbar"/>
  <variant name="IPH_MicToolbar" summary="the mic button in the toolbar"/>
  <variant name="IPH_NewIncognitoTabTip" summary="new incognito tab tip"/>
  <variant name="IPH_NewTab" summary="new tab"/>
  <variant name="IPH_NewTabPageHomeButton" summary="new tab page button"/>
  <variant name="IPH_NewTabTip" summary="new tab tip"/>
  <variant name="IPH_PageInfo" summary="opening PageInfo"/>
  <variant name="IPH_PageInfoStoreInfo" summary="PageInfoStoreInfo feature"/>
  <variant name="IPH_PageZoom"
      summary="educating users about the zoom option in the main menu"/>
  <variant name="IPH_PasswordManagerShortcut"
      summary="Password Manager shortcut."/>
  <variant name="IPH_PasswordsAccountStorage"
      summary="passwords account storage"/>
  <variant name="IPH_PasswordsManagementBubbleAfterSave"
      summary="educating the users about the password management bubble after
               saving a password"/>
  <variant name="IPH_PasswordsManagementBubbleDuringSignin"
      summary="educating the users about the password management bubble
               during signin flows"/>
  <variant name="IPH_PasswordSuggestions"
      summary="the Autofill password suggestions on iOS"/>
  <variant name="IPH_PasswordsWebAppProfileSwitch"
      summary="profile switch in Password Manager web app"/>
  <variant name="IPH_PerformanceNewBadge"
      summary="New badge shows next to performance item on the app menu"/>
  <variant name="IPH_PowerBookmarksSidePanel"
      summary="prompting users to view bookmarks in the side panel"/>
  <variant name="IPH_PreviewsOmniboxUI"
      summary="the Previews UI in the Android Omnibox"/>
  <variant name="IPH_PriceDropNTP"
      summary="the in product help message to inform users that a price drop
               has occurred in a tab"/>
  <variant name="IPH_PriceInsightsPageActionIconLabel"
      summary="price insights page action icon label triggering"/>
  <variant name="IPH_PriceTrackingChipFeature"
      summary="first time user sees the price tracking page action icon"/>
  <variant name="IPH_PriceTrackingEmailConsentFeature"
      summary="An email consent dialog shown after saving a product if a
               decision about receiving email notifications has not been
               made."/>
  <variant name="IPH_PriceTrackingInSidePanel"
      summary="first time user tracks a product to educate them to see the
               price tracking list in side panel"/>
  <variant name="IPH_PriceTrackingPageActionIconLabel"
      summary="price tracking page action icon label triggering"/>
  <variant name="IPH_ProfileSwitch"
      summary="switching profiles using the profile menu"/>
  <variant name="IPH_PwaInstallAvailableFeature"
      summary="surfacing the Android PWA install option"/>
  <variant name="IPH_QuietNotificationPrompts"
      summary="the quiet notification prompts feature"/>
  <variant name="IPH_ReadingListDiscovery"
      summary="first time a tab is added to reading list"/>
  <variant name="IPH_ReadingListEntryPoint"
      summary="educating users to click the star icon to add a tab to reading
               list"/>
  <variant name="IPH_ReadingListMessages"
      summary="the Reading List entry point in iOS tools menu"/>
  <variant name="IPH_ReadingMode"
      summary="educating users to click the side panel icon to open reading
               mode"/>
  <variant name="IPH_ReadLaterAppMenuBookmarks" summary="read later app menu"/>
  <variant name="IPH_ReadLaterAppMenuBookmarkThisPage"
      summary="read later app menu"/>
  <variant name="IPH_ReadLaterBottomSheet"
      summary="read later bottom sheet entry point"/>
  <variant name="IPH_ReadLaterContextMenu"
      summary="read later context menu entry point"/>
  <variant name="IPH_ReopenTab" summary="reopening closed tabs"/>
  <variant name="IPH_RequestDesktopSiteAppMenu"
      summary="educating users about using the desktop site app menu item to
               add a site-level exception"/>
  <variant name="IPH_RequestDesktopSiteDefaultOn"
      summary="the in product help message to let users opt out of desktop
               site global settings default-on"/>
  <variant name="IPH_RequestDesktopSiteExceptionsGeneric"
      summary="educating tablet users about using the desktop site per-site
               settings in general"/>
  <variant name="IPH_RequestDesktopSiteOptIn"
      summary="the in product help message to let users turn on the desktop
               site global settings"/>
  <variant name="IPH_RequestDesktopSiteWindowSetting"
      summary="educating users about using the desktop site window setting"/>
  <variant name="IPH_RestoreTabsOnFRE"
      summary="the in product help sheet to let users know they can restore
               tabs from other synced devices on a fresh Chrome install"/>
  <variant name="IPH_ScalableIphGaming"
      summary="A variant for gaming scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedEight"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedFive"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedFour"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedNine"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedNudge"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedOne"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedSeven"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedSix"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedTen"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedThree"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphHelpAppBasedTwo"
      summary="A variant of help app based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedEight"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedFive"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedFour"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedNine"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedOne"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedSeven"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedSix"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedTen"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedThree"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphTimerBasedTwo"
      summary="A variant of timer based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedEight"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedFive"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedFour"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedNine"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedOne"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedSeven"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedSix"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedTen"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedThree"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_ScalableIphUnlockedBasedTwo"
      summary="A variant of unlocked based scalable iph"/>
  <variant name="IPH_SharedHighlightingBuilder"
      summary="the in product help message to notify the user that the share
               action can preemptively share a link-to-text"/>
  <variant name="IPH_SharedHighlightingReceiver"
      summary="the in product help message encouraging users to create
               highlights"/>
  <variant name="IPH_SharingHubLinkToggle"
      summary="turning on link sharing in the Sharing Hub"/>
  <variant name="IPH_ShoppingCollectionFeature"
      summary="UI that is shown in the bookmark save flow when a page is
               saved to the shopping collection"/>
  <variant name="IPH_ShoppingListMenuItem"
      summary="A text bubble showing that a product can be tracked from the
               overflow menu"/>
  <variant name="IPH_SideSearch" summary="side search discovery"/>
  <variant name="IPH_SideSearchAutoTriggering"
      summary="side search automatic triggering"/>
  <variant name="IPH_SideSearchPageActionLabel"
      summary="side search page action label triggering"/>
  <variant name="IPH_TabGroupsDragAndDrop"
      summary="educating user to drop one tab on another tab to create group"/>
  <variant name="IPH_TabGroupsQuicklyComparePages"
      summary="long pressing a link to open in a tab group"/>
  <variant name="IPH_TabGroupsTapToSeeAnotherTab" summary="tab strip"/>
  <variant name="IPH_TabGroupsYourTabsTogether"
      summary="tab switcher cards with multiple tab thumbnails"/>
  <variant name="IPH_TabSearch" summary="tab search discovery"/>
  <variant name="IPH_TabSwitcherButton" summary="tab switcher button"/>
  <variant name="IPH_TrackingProtectionOnboarding"
      summary="tracking protection onboarding notice"/>
  <variant name="IPH_TranslateMenuButton" summary="translate menu button"/>
  <variant name="IPH_UpdatedConnectionSecurityIndicators"
      summary="updated omnibox connection security indicators"/>
  <variant name="IPH_VideoTutorial_NTP_ChromeIntro"
      summary="Video tutorial card on NTP about introduction to chrome"/>
  <variant name="IPH_VideoTutorial_NTP_Download"
      summary="Video tutorial card on NTP about downloading in chrome"/>
  <variant name="IPH_VideoTutorial_NTP_Search"
      summary="Video tutorial card on NTP about search in chrome"/>
  <variant name="IPH_VideoTutorial_NTP_Summary"
      summary="Video tutorial summary card on NTP"/>
  <variant name="IPH_VideoTutorial_NTP_VoiceSearch"
      summary="Video tutorial card on NTP about voice search in chrome"/>
  <variant name="IPH_VideoTutorial_TryNow"
      summary="Video tutorial Try Now feature"/>
  <variant name="IPH_WebFeedAwareness"
      summary="proactive announcement of web feed on NTP/start surface"/>
  <variant name="IPH_WebFeedFollow"
      summary="proactive Web Feed follow recommendations"/>
  <variant name="IPH_WebFeedPostFollowDialog"
      summary="Web Feed successful follow operations"/>
  <variant name="IPH_WebFeedPostFollowDialogWithUIUpdate"
      summary="Web Feed successful follow operations with UI update"/>
  <variant name="IPH_WebUiHelpBubbleTest"
      summary="testing the WebUI help bubble"/>
  <variant name="IPH_WebUITabStrip" summary="opening the WebUI tab strip"/>
</variants>

<variants name="TutorialID">
  <variant name="" summary="any tutorial"/>
  <variant name=".CustomizeChromeSidePanel"
      summary="the tutorial for the customize chrome side panel"/>
  <variant name=".PasswordManager"
      summary="the tutorial for the password manager"/>
  <variant name=".SidePanelReadingList"
      summary="the tutorial for the side panel reading list"/>
  <variant name=".TabGroup" summary="the tutorial for tab groups"/>
</variants>

<histogram name="InProductHelp.Config.ParsingEvent" enum="ConfigParsingEvent"
    expires_after="2024-03-10">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if in-product help configuration is parsed correctly, and the
    failure reasons for parsing failures.
  </summary>
</histogram>

<histogram name="InProductHelp.Db.Init.{IPHDatabase}" enum="BooleanSuccess"
    expires_after="2024-02-25">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if {IPHDatabase} database initialization succeeds for in-product
    help.
  </summary>
  <token key="IPHDatabase" variants="IPHDatabase"/>
</histogram>

<histogram name="InProductHelp.Db.Load.{IPHDatabase}" enum="BooleanSuccess"
    expires_after="2024-02-25">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if {IPHDatabase} database successfully loads the data for in-product
    help.
  </summary>
  <token key="IPHDatabase" variants="IPHDatabase"/>
</histogram>

<histogram name="InProductHelp.Db.TotalEvents" units="events"
    expires_after="2024-02-25">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records the total number of event records in the database for in-product
    help after the event model is loaded.
  </summary>
</histogram>

<histogram name="InProductHelp.Db.Update.{IPHDatabase}" enum="BooleanSuccess"
    expires_after="2024-02-25">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if {IPHDatabase} database update succeeds for in-product help.
  </summary>
  <token key="IPHDatabase" variants="IPHDatabase"/>
</histogram>

<histogram name="InProductHelp.DismissalReason.iOS"
    enum="InProductHelpDismissalReason" expires_after="2024-01-28">
  <owner>lpromero@google.com</owner>
  <owner>gambard@chromium.org</owner>
  <summary>
    Records how the in-product help bubble was dismissed on iOS.
  </summary>
</histogram>

<histogram name="InProductHelp.NotifyEventReadyState.{IPHFeature}"
    enum="BooleanSuccess" expires_after="2024-02-25">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if the model is ready when in-product help event happens for
    {IPHFeature}.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="InProductHelp.ShouldTriggerHelpUI.{IPHFeature}"
    enum="TriggerHelpUIResult" expires_after="2024-02-25">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if in-product help for {IPHFeature} is shown to the user, and the
    failure reasons if in-product help is not shown. Recorded on its own across
    all in-product help features, in addition to being a base name for
    feature-specific histograms.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="InProductHelp.ShownTime.{IPHFeature}" units="ms"
    expires_after="2024-09-21">
  <owner>lpromero@google.com</owner>
  <owner>gambard@chromium.org</owner>
  <summary>
    Records the time duration during which the in-product help for {IPHFeature}
    is shown. The timer automatically starts when the feature engagement system
    says a particular IPH should be displayed. The timer is stopped and recorded
    when the IPH is dismissed.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="InProductHelp.SnoozeAction" enum="InProductHelpSnoozeAction"
    expires_after="2024-01-28">
  <owner>haileywang@chromium.org</owner>
  <owner>shaktisahu@chromium.org</owner>
  <summary>
    Records the action taken by the user on a snoozable in-product help bubble.
  </summary>
</histogram>

<histogram name="InProductHelp.TextBubble.ShownTime" units="ms"
    expires_after="2024-02-20">
  <owner>haileywang@chromium.org</owner>
  <owner>shaktisahu@chromium.org</owner>
  <summary>
    The time duration for which the in-product help bubble is shown.
  </summary>
</histogram>

<histogram name="InProductHelp.TextBubble.ShowSnooze" enum="BooleanShown"
    expires_after="2023-02-12">
  <owner>haileywang@chromium.org</owner>
  <owner>shaktisahu@chromium.org</owner>
  <summary>
    Records if the snooze button was shown on an in-product help bubble.
  </summary>
</histogram>

<histogram name="Tutorial.TabGroup.EditedTitle" enum="BooleanSuccess"
    expires_after="2024-09-20">
  <owner>dpenning@chromium.org</owner>
  <owner>dfried@chromium.org</owner>
  <summary>
    Records whether the user edited the tab group title during the Tab Groups
    tutorial. During one of the steps, the tutorial asks the user to name the
    new group, but the tutorial will continue if they dismiss the bubble without
    adding a name. We want to know if people follow the instruction or not.
  </summary>
</histogram>

<histogram name="Tutorial{TutorialID}.AbortStep" units="int"
    expires_after="2024-03-17">
  <owner>dpenning@chromium.org</owner>
  <owner>dfried@chromium.org</owner>
  <summary>
    When {TutorialID} is aborted, the step at which the tutorial was aborted.
    Only logged on desktop platforms. Logged each time a tutorial is aborted.
  </summary>
  <token key="TutorialID" variants="TutorialID"/>
</histogram>

<histogram name="Tutorial{TutorialID}.Completion" enum="BooleanSuccess"
    expires_after="2024-03-03">
  <owner>dpenning@chromium.org</owner>
  <owner>dfried@chromium.org</owner>
  <summary>
    When {TutorialID} is ended, whether the tutorial was completed or aborted.
    Only logged on desktop platforms. Logged each time a tutorial is ended.
  </summary>
  <token key="TutorialID" variants="TutorialID"/>
</histogram>

<histogram name="Tutorial{TutorialID}.IPHLinkClicked" enum="BooleanSuccess"
    expires_after="2024-03-03">
  <owner>dpenning@chromium.org</owner>
  <owner>dfried@chromium.org</owner>
  <summary>
    When {TutorialID} button is shown from an IPHLink, whether the user clicks
    to start the tutorial. Only logged on desktop platforms when the user either
    clicks or dismisses the FeaturePromo.
  </summary>
  <token key="TutorialID" variants="TutorialID"/>
</histogram>

<histogram name="Tutorial{TutorialID}.StartedFromWhatsNewPage"
    enum="BooleanSuccess" expires_after="2024-09-20">
  <owner>dpenning@chromium.org</owner>
  <owner>dfried@chromium.org</owner>
  <summary>
    The count of successful starts of the tutorial when {TutorialID} button is
    clicked on the whats new page (called by the Tutorial BrowserCommand). A
    false value correlates to a failure to start the tutorial.
  </summary>
  <token key="TutorialID" variants="TutorialID"/>
</histogram>

<histogram name="UserEducation.MessageAction.{IPHFeature}" enum="MessageAction"
    expires_after="2024-09-01">
  <owner>mickeyburks@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>Records what action was taken to close the In-Product Help.</summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="UserEducation.MessageShown.Subtype" enum="PromoSubtype"
    expires_after="2024-09-01">
  <owner>mickeyburks@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>
    Records what subtype of In-Product Help was shown to the user. The subtype
    dictates special rules for when it can be shown. It can be normal, per-app
    (shown once each in multiple applications), or a legal notice (must be shown
    until explicitly acknowledged by the user).
  </summary>
</histogram>

<histogram name="UserEducation.MessageShown.Type" enum="PromoType"
    expires_after="2024-09-01">
  <owner>mickeyburks@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>
    Records what type of In-Product Help was shown to the user. The type defines
    the behavior of the IPH, which can be many varieties (e.g. toast, snooze,
    custom action, etc.).
  </summary>
</histogram>

</histograms>

</histogram-configuration>
