File: privacy_sandbox_incognito_survey_service.h

package info (click to toggle)
chromium 139.0.7258.138-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,120,676 kB
  • sloc: cpp: 35,100,869; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (91 lines) | stat: -rw-r--r-- 3,861 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_PRIVACY_SANDBOX_INCOGNITO_PRIVACY_SANDBOX_INCOGNITO_SURVEY_SERVICE_H_
#define CHROME_BROWSER_PRIVACY_SANDBOX_INCOGNITO_PRIVACY_SANDBOX_INCOGNITO_SURVEY_SERVICE_H_

#include "base/gtest_prod_util.h"
#include "base/memory/raw_ptr.h"
#include "base/memory/weak_ptr.h"
#include "build/build_config.h"
#include "chrome/browser/ui/hats/hats_service.h"
#include "components/keyed_service/core/keyed_service.h"
#include "content/public/browser/web_contents.h"

namespace privacy_sandbox {

// A service responsible for managing Privacy Sandbox surveys in Incognito.
class PrivacySandboxIncognitoSurveyService : public KeyedService {
 public:
  // Records the survey's status when attempting to surface the ACT survey.
  //
  // LINT.IfChange(PrivacySandboxActSurveyStatus)
  enum class ActSurveyStatus {
    kSurveyShown = 0,          // Survey was successfully shown.
    kFeatureDisabled = 1,      // ACT Survey feature disabled.
    kHatsServiceFailed = 2,    // Could not initialize HaTS service.
    kSurveyLaunchFailed = 3,   // Survey failed to launch.
    kNonIncognitoProfile = 4,  // Not inside Incognito.
    kMaxValue = kNonIncognitoProfile,
  };
  // LINT.ThenChange(/tools/metrics/histograms/enums.xml:PrivacySandboxActSurveyStatus)

  using RandIntCallback = base::RepeatingCallback<int(int, int)>;

  explicit PrivacySandboxIncognitoSurveyService(HatsService* hats_service,
                                                bool is_incognito);
  ~PrivacySandboxIncognitoSurveyService() override;

  // Called to surface the ACT survey if the conditions are met.
  void MaybeShowActSurvey(content::WebContents* web_contents);

  // Set a custom RandInt callback for testing.
  void SetRandIntCallbackForTesting(const RandIntCallback&& rand_int_callback);

 private:
  // Determines if the ACT survey is enabled.
  bool IsActSurveyEnabled();

  // Calculates the delay of the ACT survey based on feature params. The delay
  // is the time between triggering the survey and launching it. Note that
  // survey loading time is not included in the delay.
  base::TimeDelta CalculateActSurveyDelay();

  // Construct product specific string data for the ACT survey.
  std::map<std::string, std::string> GetActSurveyPsd(int delay_ms);

  // Construct survey options for the ACT survey.
  HatsService::SurveyOptions GetActSurveyOptions();

  // Emits the given ACT survey status to UMA.
  void RecordActSurveyStatus(ActSurveyStatus status);

  void OnActSurveyShown();
  void OnActSurveyFailure();

  RandIntCallback rand_int_callback_;
  const bool is_incognito_;
  raw_ptr<HatsService> hats_service_;
  base::WeakPtrFactory<PrivacySandboxIncognitoSurveyService> weak_ptr_factory_{
      this};

  FRIEND_TEST_ALL_PREFIXES(PrivacySandboxIncognitoSurveyServiceTest,
                           IsActSurveyEnabled_DisabledByDefault);
  FRIEND_TEST_ALL_PREFIXES(PrivacySandboxIncognitoSurveyServiceTest,
                           RecordActSurveyStatus_EmitsHistogram);
  FRIEND_TEST_ALL_PREFIXES(PrivacySandboxIncognitoSurveyServiceTest,
                           GetActSurveyPsd_ReturnsProperPsd);
  FRIEND_TEST_ALL_PREFIXES(PrivacySandboxIncognitoSurveyServiceTest,
                           GetActSurveyOptions_ReturnsNoInvitationWhenDisabled);
  FRIEND_TEST_ALL_PREFIXES(
      PrivacySandboxIncognitoSurveyServiceActSurveyDelayTest,
      CalculateActSurveyDelay_ProperlyCalculatesDelay);
  FRIEND_TEST_ALL_PREFIXES(
      PrivacySandboxIncognitoSurveyServiceActSurveyDelayRandomizationTest,
      CalculateActSurveyDelay_ProperlyCalculatesRandomizedDelay);
};

}  // namespace privacy_sandbox

#endif  // CHROME_BROWSER_PRIVACY_SANDBOX_INCOGNITO_PRIVACY_SANDBOX_INCOGNITO_SURVEY_SERVICE_H_