chrome/browser/interstitials/security_interstitial_metrics_helper.h

   1 // Copyright (c) 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_INTERSTITIALS_SECURITY_INTERSTITIAL_METRICS_HELPER_H_
   6 #define CHROME_BROWSER_INTERSTITIALS_SECURITY_INTERSTITIAL_METRICS_HELPER_H_
   7
   8 #include <string>
   9
  10 #include "base/task/cancelable_task_tracker.h"
  11 #include "base/time/time.h"
  12 #include "url/gurl.h"
  13
  14 namespace content {
  15 class WebContents;
  16 }
  17
  18 namespace extensions {
  19 class ExperienceSamplingEvent;
  20 }
  21
  22 // Most of the security interstitials share a common layout and set of
  23 // choices. SecurityInterstitialMetricsHelper is intended to help the security
  24 // interstitials record user choices in a common way via METRICS histograms
  25 // and RAPPOR metrics.
  26 class SecurityInterstitialMetricsHelper {
  27  public:
  28   // These enums are used for histograms.  Don't reorder, delete, or insert
  29   // elements. New elements should be added at the end (right before the max).
  30   enum SecurityInterstitialDecision {
  31     SHOW,
  32     PROCEED,
  33     DONT_PROCEED,
  34     PROCEEDING_DISABLED,
  35     MAX_DECISION
  36   };
  37   enum SecurityInterstitialInteraction {
  38     TOTAL_VISITS,
  39     SHOW_ADVANCED,
  40     SHOW_PRIVACY_POLICY,
  41     SHOW_DIAGNOSTIC,
  42     SHOW_LEARN_MORE,
  43     RELOAD,
  44     OPEN_TIME_SETTINGS,
  45     MAX_INTERACTION
  46   };
  47
  48   enum RapporReporting {
  49     REPORT_RAPPOR,
  50     SKIP_RAPPOR,
  51   };
  52
  53   // Args:
  54   //   url: URL of page that triggered the interstitial. Only origin is used.
  55   //   uma_prefix: Histogram prefix for UMA.
  56   //               examples: "phishing", "ssl_overridable"
  57   //   rappor_prefix: Metric prefix for Rappor.
  58   //               examples: "phishing", "ssl"
  59   //   rappor_reporting: Used to skip rappor rapporting if desired.
  60   //   sampling_event_name: Event name for Experience Sampling.
  61   //                        e.g. "phishing_interstitial_"
  62   SecurityInterstitialMetricsHelper(content::WebContents* web_contents,
  63                                     const GURL& url,
  64                                     const std::string& uma_prefix,
  65                                     const std::string& rappor_prefix,
  66                                     RapporReporting rappor_reporting,
  67                                     const std::string& sampling_event_name);
  68   ~SecurityInterstitialMetricsHelper();
  69
  70   // Record a user decision or interaction to the appropriate UMA histogram
  71   // and potentially in a RAPPOR metric.
  72   void RecordUserDecision(SecurityInterstitialDecision decision);
  73   void RecordUserInteraction(SecurityInterstitialInteraction interaction);
  74
  75  private:
  76   // Used to query the HistoryService to see if the URL is in history.
  77   void OnGotHistoryCount(bool success, int num_visits, base::Time first_visit);
  78
  79   content::WebContents* web_contents_;
  80   const GURL request_url_;
  81   const std::string uma_prefix_;
  82   const std::string rappor_prefix_;
  83   const RapporReporting rappor_reporting_;
  84   const std::string sampling_event_name_;
  85   int num_visits_;
  86   base::CancelableTaskTracker request_tracker_;
  87 #if defined(ENABLE_EXTENSIONS)
  88   scoped_ptr<extensions::ExperienceSamplingEvent> sampling_event_;
  89 #endif
  90
  91   DISALLOW_COPY_AND_ASSIGN(SecurityInterstitialMetricsHelper);
  92 };
  93
  94 #endif  // CHROME_BROWSER_INTERSTITIALS_SECURITY_INTERSTITIAL_METRICS_HELPER_H_