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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
// Copyright 2020 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.
#ifndef COMPONENTS_PROFILE_METRICS_STATE_H_
#define COMPONENTS_PROFILE_METRICS_STATE_H_
namespace profile_metrics {
// State for a profile avatar, documenting what Chrome UI exactly shows.
// These values are persisted to logs. Entries should not be renumbered and
// numeric values should never be reused.
enum class AvatarState {
// All SignedIn* states denote having a primary account (incl. unconsented,
// not necessarily syncing).
kSignedInGaia =
0, // User has the avatar from GAIA (the default for signed-in users).
kSignedInModern = 1, // User has explicitly selected a modern avatar.
kSignedInOld = 2, // User has explicitly selected an old avatar.
kSignedOutDefault = 3, // Grey silhouette.
kSignedOutModern = 4, // User has explicitly selected a modern avatar.
kSignedOutOld = 5, // User has explicitly selected an old avatar.
kMaxValue = kSignedOutOld
};
// State for a profile name, documenting what Chrome UI exactly shows.
// These values are persisted to logs. Entries should not be renumbered and
// numeric values should never be reused.
enum class NameState {
kGaiaName = 0, // The name of the user from Gaia.
kGaiaAndCustomName = 1, // The name of the user from Gaia and the custom
// local name specified by the user.
kGaiaAndDefaultName = 2, // Chrome shows "Person X" alongside the Gaia name
// because it is needed to resolve ambiguity.
kCustomName = 3, // Only a custom name of the profile specified by the user.
kDefaultName = 4, // Only "Person X" since there's nothing better.
kMaxValue = kDefaultName
};
// Type of the unconsented primary account in a profile.
// These values are persisted to logs. Entries should not be renumbered and
// numeric values should never be reused.
enum class UnconsentedPrimaryAccountType {
kConsumer = 0,
kEnterprise = 1,
kChild = 2,
kSignedOut = 3,
kMaxValue = kSignedOut
};
// Classification of what gaia names appear or appeared in this profile since
// the last time gaia cookies got deleted. Thus, this also includes signed-out
// accounts. In order to protect privacy, only classifies whether multiple
// distinct gaia names appeared in this profile and if so, whether sync is
// enabled for one of them. Furthermore, this classification uses a low-entropy
// hash to detect distinct names. In case of a rare hash collision (less than
// 0.1% of cases), multiple names get recorded as a single name. Entries should
// not be renumbered and numeric values should never be reused.
enum class AllAccountsNames {
kLikelySingleName = 0, // Gets also rare false records due to hash collision.
kMultipleNamesWithoutSync = 1,
kMultipleNamesWithSync = 2,
kMaxValue = kMultipleNamesWithSync
};
// Classification of what account categories out of {consumer, enterprise}
// appear or appeared in this profile since the last time gaia cookies got
// deleted. Thus, this also includes signed-out accounts. If both categories
// appeared, it also distinguishes whether sync is enabled and for which of
// them. Entries should not be renumbered and numeric values should never be
// reused.
enum class AllAccountsCategories {
kSingleCategory = 0,
kBothConsumerAndEnterpriseNoSync = 1,
kBothConsumerAndEnterpriseSyncingConsumer = 2,
kBothConsumerAndEnterpriseSyncingEnterprise = 3,
kMaxValue = kBothConsumerAndEnterpriseSyncingEnterprise
};
// Different types of reporting for profile state. This is used as a histogram
// suffix.
enum class StateSuffix {
kAll, // Recorded for all clients and all their profiles.
kActiveMultiProfile, // Recorded for multi-profile users with >=2 active
// profiles, for all their profiles.
kLatentMultiProfile, // Recorded for multi-profile users with one active
// profile, for all their profiles.
kLatentMultiProfileActive, // Recorded for multi-profile users with one
// active profile, only for the active profile.
kLatentMultiProfileOthers, // Recorded for multi-profile users with one
// active profile, only for the non-active
// profiles.
kSingleProfile, // Recorded for single-profile users for their single
// profile.
kUponDeletion // Recorded whenever a profile gets deleted.
};
// Records the state of profile's avatar.
void LogProfileAvatar(AvatarState avatar_state, StateSuffix suffix);
// Records the state of profile's name.
void LogProfileName(NameState name_state, StateSuffix suffix);
// Records the state of profile's UPA.
void LogProfileAccountType(UnconsentedPrimaryAccountType account_type,
StateSuffix suffix);
// Records the state of profile's sync.
void LogProfileSyncEnabled(bool sync_enabled, StateSuffix suffix);
// Records the days since last use of a profile.
void LogProfileDaysSinceLastUse(int days_since_last_use, StateSuffix suffix);
// Records the context of a profile deletion, whether it is the last profile and
// whether it happens while no browser windows are opened.
void LogProfileDeletionContext(bool is_last_profile, bool no_browser_windows);
// Records the state of account names used in multi-login.
void LogProfileAllAccountsNames(AllAccountsNames names);
// Records the state of account categories used in multi-login.
void LogProfileAllAccountsCategories(AllAccountsCategories categories);
} // namespace profile_metrics
#endif // COMPONENTS_PROFILE_METRICS_STATE_H_
|