📰 Record user actions on the NTP and Home sheet

tools/metrics/actions/actions.xml

 <!--
 Copyright 2014 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 a comprehensive list of Chrome user actions along with the owner
 and description for each user action.
 
@@ skipping 15813 matching lines @@
 <action name="Stop">
   <owner>Please list the metric's owners. Add more owner tags as needed.</owner>
   <description>Please enter the description of this user action.</description>
 </action>
 
 <action name="Strikethrough">
   <owner>Please list the metric's owners. Add more owner tags as needed.</owner>
   <description>Please enter the description of this user action.</description>
 </action>
 
+<action name="Suggestions.Card.ActionTapped">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>
+    User tapped on a card's button in the content suggestions UI.
+  </description>
+</action>
+
+<action name="Suggestions.Card.SwipedAway">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>
+    User swiped a card away in the content suggestions UI.
+  </description>
+</action>
+
+<action name="Suggestions.Card.Tapped">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>
+    User tapped on a card in the content suggestions UI.
+  </description>
+</action>
+
+<action name="Suggestions.Category.Dismissed">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User dismissed a content suggestions category.</description>
+</action>
+
+<action name="Suggestions.Category.Fetch">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User requested fetching more content suggestions.</description>

[Alexei Svitkine (slow), 2017/05/09 14:53:50]

Nit: Maybe mention how the user did this? i.e. describe the UI used

[dgn, 2017/05/09 15:27:11]

We currently have only one way to do that, and that would be captured by
Suggestions.Card.ActionTapped, but we are planning to add another way by just
scrolling to the bottom of the feed. So this is more like an indirect user
action, and "how" is supposed to be indicated through the sequence. Is it okay
as is or should I mention to look at the sequence for more details?

[Alexei Svitkine (slow), 2017/05/09 16:59:07]

I think it would be good to mention this bit of context in the description and
mention the other metric by name there too.

+</action>
+
+<action name="Suggestions.Category.ViewAll">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>
+    User navigated to the complete view of a content suggestions section.
+  </description>
+</action>
+
+<action name="Suggestions.Content.Dismissed">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User dismissed a content suggestion.</description>
+</action>
+
+<action name="Suggestions.Content.Opened">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User opened a content suggestion.</description>
+</action>
+
 <action name="Suggestions.ContextMenu.DownloadItem">
   <owner>mvanouwerkerk@chromium.org</owner>
   <owner>galinap@google.com</owner>
   <description>
     Android: User used the context menu to download a suggested item.
   </description>
 </action>
 
 <action name="Suggestions.ContextMenu.OpenItemInIncognitoTab">
   <owner>mvanouwerkerk@chromium.org</owner>
@@ skipping 30 matching lines @@
 </action>
 
 <action name="Suggestions.ContextMenu.Shown">
   <owner>mvanouwerkerk@chromium.org</owner>
   <owner>galinap@google.com</owner>
   <description>
     Android: User opened the context menu on a suggested item.
   </description>
 </action>
 
+<action name="Suggestions.Site.RemovalUndone">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User reverted the removal of a suggested site.</description>
+</action>
+
+<action name="Suggestions.Site.Removed">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User removed a suggested site.</description>
+</action>
+
+<action name="Suggestions.SurfaceHidden">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User closed the content suggestions UI.</description>
+</action>
+
+<action name="Suggestions.SurfaceVisible">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>User opened the content suggestions UI.</description>
+</action>
+
 <action name="Suggestions.Tile.RemovalUndone">
   <owner>mvanouwerkerk@chromium.org</owner>
   <owner>galinap@google.com</owner>
   <description>
     Android: User tapped the undo button in the snackbar after removing a
     suggested item.
   </description>
+  <obsolete>
+    Deprecated as of 05/2017. Now recorded as
+    &quot;Suggestions.Site.RemovalUndone&quot;.
+  </obsolete>
+</action>
+
+<action name="Suggestions.Tile.Tapped">
+  <owner>finkm@chromium.org</owner>
+  <owner>dgn@chromium.org</owner>
+  <description>
+    User tapped on a tile in the content suggestions UI.
+  </description>
 </action>
 
 <action name="SuspiciousExtensionBubbleDismissed">
   <owner>finnur@chromium.org</owner>
   <description>Please enter the description of this user action.</description>
 </action>
 
 <action name="SwitchTab_Click">
   <owner>bruthig@chromium.org</owner>
   <owner>tdanderson@chromium.org</owner>
@@ skipping 1051 matching lines @@
 <action name="webapps.AddShortcut.Manifest">
   <owner>mlamouri@chromium.org</owner>
   <description>
     Shortcut added to the homescreen with a valid Manifest. This action will be
     recorded in addition to AppShortcut, AppShortcutApple and Bookmark actions
     to keep a trend of whether the webapp also add meta tags.
   </description>
 </action>
 
 </actions>