tools/metrics/histograms/metadata/commerce/histograms.xml

<!--
Copyright 2021 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 Commerce 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
-->

<histogram-configuration>

<histograms>

<variants name="LocationIdentifiers">
  <variant name="EnterTabSwitcher" summary="enters the Tab Switcher."/>
  <variant name="NavigationComplete" summary="completes a navigation."/>
</variants>

<variants name="TabUsageStatuses">
  <variant name="">
    <obsolete>
      Previous histogram didn't differentiate between Stale and Active Tab.
    </obsolete>
  </variant>
  <variant name="ActiveTab"
      summary="Tabs between 0 and 1 day since last usage."/>
  <variant name="StaleTab"
      summary="Tabs between 1 and 90 days since last usage."/>
</variants>

<histogram name="Commerce.Carts.ExtractionExecutionTime" units="ms"
    expires_after="2021-12-30">
  <owner>wychen@chromium.org</owner>
  <owner>yuezhanggg@chromium.org</owner>
  <owner>chrome-shopping@google.com</owner>
  <summary>
    Logged when cart content extraction is executed for ChromeCart. This
    histogram records the elapsed time between the start and the end of the
    extraction JavaScript request execution.
  </summary>
</histogram>

<histogram name="Commerce.Carts.FormSubmitIsTransaction"
    units="BooleanIsTransaction" expires_after="2022-06-01">
  <owner>wychen@chromium.org</owner>
  <owner>yuezhanggg@chromium.org</owner>
  <owner>chrome-shopping@google.com</owner>
  <summary>
    Records whether the form submission is a shopping transaction. This has 50%
    chance randomized. Logged when there's a form submission.
  </summary>
</histogram>

<histogram name="Commerce.Carts.XHRIsAddToCart" units="BooleanIsAddToCart"
    expires_after="2022-06-01">
  <owner>wychen@chromium.org</owner>
  <owner>yuezhanggg@chromium.org</owner>
  <owner>chrome-shopping@google.com</owner>
  <summary>
    Records whether the XHR is to add a product to a shopping cart. This has 50%
    chance randomized. Logged when there's an XHR about to be sent.
  </summary>
</histogram>

<histogram
    name="Commerce.PowerBookmarks.ShoppingDataProvider.FallbackDataContent"
    enum="ShoppingDataProviderFallback" expires_after="M100">
  <owner>ayman@chromium.org</owner>
  <owner>mdjones@chromium.org</owner>
  <summary>
    Records whick type of fallback data (javascript on-page heuristics) was used
    when filling in gaps from Optimization Guide. This does not track whether
    the page was actually bookmarked, it only indicates what information might
    be missing or how often we get supplementary images when on a product page.
  </summary>
</histogram>

<histogram name="Commerce.PowerBookmarks.ShoppingDataProvider.FallbackDataUsed"
    enum="Boolean" expires_after="M100">
  <owner>ayman@chromium.org</owner>
  <owner>mdjones@chromium.org</owner>
  <summary>
    Records whether fallback data (javascript on-page heuristics) was used to
    supplement the data provided by Optimization Guide. This does not track
    whether the page was actually bookmarked.
  </summary>
</histogram>

<histogram name="Commerce.PowerBookmarks.ShoppingDataProvider.IsProductPage"
    enum="Boolean" expires_after="M100">
  <owner>ayman@chromium.org</owner>
  <owner>mdjones@chromium.org</owner>
  <summary>
    Records whether a particular navigation was determined to be a product page
    by Optimization Guide. This doesn not track whether the page was actually
    bookmarked.
  </summary>
</histogram>

<histogram name="Commerce.PriceDrop.NotificationChannelBlocked" enum="Boolean"
    expires_after="M97">
  <owner>zhiyuancai@chromium.org</owner>
  <owner>chrome-shopping@google.com</owner>
  <summary>
    Records whether the price drop notification channel is blocked by users.
    Recorded when we try to initialize commerce subscriptions. Implemented for
    Android.
  </summary>
</histogram>

<histogram name="Commerce.PriceDrop.NotificationChannelCreated" enum="Boolean"
    expires_after="M97">
  <owner>zhiyuancai@chromium.org</owner>
  <owner>chrome-shopping@google.com</owner>
  <summary>
    Records whether the price drop notification channel is created. Recorded
    when we try to initialize commerce subscriptions. Implemented for Android.
  </summary>
</histogram>

<histogram name="Commerce.PriceDrop.SystemNotificationEnabled" enum="Boolean"
    expires_after="M97">
  <owner>zhiyuancai@chromium.org</owner>
  <owner>chrome-shopping@google.com</owner>
  <summary>
    Records whether the system notification is enabled by users. Recorded when
    we try to initialize commerce subscriptions. Implemented for Android.
  </summary>
</histogram>

<histogram
    name="Commerce.PriceDrops.{TabUsageStatus}{LocationIdentifier}.ContainsPrice"
    enum="BooleanContainsPrice" expires_after="2022-06-07">
  <owner>davidjm@chromium.org</owner>
  <owner>ayman@chromium.org</owner>
  <owner>dtrainor@chromium.org</owner>
  <summary>
    Records if a page contains a price, as determined by the commerce data
    obtained to power the price drop feature. This data is acquired when the
    user finishes navigating to a page. Recorded when the user
    {LocationIdentifier}. Recorded for {TabUsageStatus}.
  </summary>
  <token key="LocationIdentifier" variants="LocationIdentifiers"/>
  <token key="TabUsageStatus" variants="TabUsageStatuses"/>
</histogram>

<histogram
    name="Commerce.PriceDrops.{TabUsageStatus}{LocationIdentifier}.ContainsPriceDrop"
    enum="BooleanContainsPriceDrop" expires_after="2022-06-07">
  <owner>davidjm@chromium.org</owner>
  <owner>ayman@chromium.org</owner>
  <owner>dtrainor@chromium.org</owner>
  <summary>
    Records if a page contains a decrease in price for an offer, relative to the
    previously seen price for the offer. This is determined by the commerce data
    obtained to power the price drop feature. The data is acquired when the user
    finishes navigating to a page. Recorded when the user {LocationIdentifier}.
    Recorded for {TabUsageStatus}.
  </summary>
  <token key="LocationIdentifier" variants="LocationIdentifiers"/>
  <token key="TabUsageStatus" variants="TabUsageStatuses"/>
</histogram>

<histogram
    name="Commerce.PriceDrops.{TabUsageStatus}{LocationIdentifier}.IsProductDetailPage"
    enum="BooleanIsProductDetailPage" expires_after="2022-06-07">
  <owner>davidjm@chromium.org</owner>
  <owner>ayman@chromium.org</owner>
  <owner>dtrainor@chromium.org</owner>
  <summary>
    Records if a page is a product detail page, as determined by the commerce
    data obtained to power the price drop feature. This data is acquired when
    the user finishes navigating to a page. Recorded when the user
    {LocationIdentifier}. Recorded for {TabUsageStatus}.
  </summary>
  <token key="LocationIdentifier" variants="LocationIdentifiers"/>
  <token key="TabUsageStatus" variants="TabUsageStatuses"/>
</histogram>

</histograms>

</histogram-configuration>