Skip to content
Darnell Andries edited this page Mar 9, 2023 · 318 revisions

Privacy Preserving Product Analytics Metrics

This is a human-readable list of product analytics metrics collected. The list of metrics collected can also be found in the source code. The analytics reported are not exact numbers, but are collected into aggregate "buckets" or histograms. The process for this aggregation can also be verified in the source code.

Current Metrics

[D] = supported on Desktop (merged and enabled in 1.1.x)

[A] = supported on Android (merged in 1.19.x and enabled in 1.20.x)

[iOS] = supported on iOS (merged and enabled in 1.46.x)

Q1: How long has this browser been open for the last seven days?

Brave.Uptime.BrowserOpenMinutes [D]

  1. N/A -- seven days have not passed since first open
  2. 0 - 30min
  3. 30min - 5hrs
  4. 5hrs+

Q2: Have you made Brave your default browser?

_Brave.Core.IsDefault_ [D]

  1. No
  2. Yes

Q3: Did you follow the on-boarding process

Brave.Welcome.InteractionStatus [D]

  1. Did not click within welcome screen
  2. Clicked once
  3. Clicked twice or more but did not make it to the end
  4. Made it to end of on-boarding flow

Q4: Did you import settings and bookmarks, and if so from where?

Brave.Importer.ImporterSource [D]

  1. Did not import
  2. Imported from Brave
  3. Imported from Chrome
  4. Imported from Firefox
  5. Imported from Bookmarks HTML
  6. Imported from Safari (answer only possible on macOS)

Q5: How many bookmarks do you have?

Brave.Core.BookmarksCountOnProfileLoad.2 [D] [A] [iOS]

  1. 0-5
  2. 6-20
  3. 21-100
  4. 101-500
  5. 501-1000
  6. 1001-5000
  7. 5001-10000
  8. More than 10000

Q6: How many open windows do you have?

Brave.Core.WindowCount.2 [D]

  1. 0
  2. 1
  3. 2-5
  4. 6+

Q7: How many open tabs do you have?

Brave.Core.TabCount [D] [A] [iOS]

  1. 0-1
  2. 2-5
  3. 6-10
  4. 11-50
  5. 50+

Q8: What has been your interaction with the shields icon?

Brave.Shields.UsageStatus [D]

  1. Never clicked on shields icon
  2. Clicked on it, but never made a change
  3. Clicked on it, shut off shields for one or more sites
  4. Clicked on it, changed Shields defaults or per-site shield settings in addition to (or in place of) shutting off shields on one or more sites

Q9: Have you ever used a private window?

Brave.Core.LastTimeIncognitoUsed [D]

  1. Used in last 24h
  2. Used in last week but not 24h
  3. Used in last 28 days but not week
  4. Ever used but not in last 28 days
  5. Never used

Q10: Have you ever used a Tor private window?

Brave.Core.TorEverUsed [D]

  1. Yes
  2. No

Q11: What is the state of your Brave Rewards wallet?

Brave.Rewards.WalletState [D] (ANDROID?)

  1. No wallet created
  2. Wallet created; no grants claimed; no funds added
  3. Wallet created; grant(s) claimed; no funds added
  4. Wallet created: no grants claimed; funds added
  5. Wallet created: grant(s) claimed; funds added
  6. Wallet disabled after having been created (Brave Rewards switched off)

Q12: How much BAT, excluding grants, is in your wallet?

Brave.Rewards.WalletBalance.3 [D] [A]

  1. No wallet created
  2. Wallet created, rewards disabled
  3. Zero BAT, excluding grants
  4. 1-9 BAT, excluding grants
  5. 10-50 BAT, excluding grants
  6. Over 50 BAT, excluding grants~~

Q13: Have you made use of Auto-contribute in Brave Rewards?

Brave.Rewards.AutoContributionsState.2 [D] [A]

  1. No wallet created
  2. Rewards Disabled
  3. Wallet created, Auto-Contribute off
  4. Auto-contribute enabled, no contribution so far
  5. Auto-contribute enabled, one successful contribution so far
  6. Auto-contribute enabled, more than one successful contribution so far

Q14: Have you made use of tips within Brave Rewards?

Brave.Rewards.TipsState.2 [D] [A]

  1. No wallet created
  2. Rewards Disabled
  3. Wallet created, no tips sent
  4. Wallet created, one-time tip sent
  5. Wallet created, at least one monthly tip queued up or sent
  6. Wallet created, one-time sent and at least one monthly tip queued up or sent

Q15: Have you enabled sync?

Brave.Sync.Status [D]

  1. No
  2. Sync enabled with two devices
  3. Sync enabled more than two devices

Q16: How many extensions have you installed?

Brave.Core.NumberOfExtensions (only queried on program start) [D]

  1. None
  2. One extension
  3. Two to four extensions
  4. Five or more extensions

Q17: Have you enabled Brave Ads? [BROKEN]

Brave.Rewards.AdsState.2 [D] [A]

  1. No wallet created
  2. Rewards Disabled
  3. Wallet created, ads not enabled
  4. Wallet created and ads enabled
  5. Wallet created, ads enabled, then disabled, while Brave Rewards remains on
  6. Wallet created, ads enabled, then disabled, Brave Rewards disabled

Q18: How many weekly questions did the browser send in the previous week?

Brave.P3A.SentAnswersCount [D] [A]

  1. None
  2. Between 1 and 4
  3. Between 5 and 9
  4. 10 or more

Q19: How many times did you search last week?

Brave.Omnibox.SearchCount [D] Note: we count only omnibox events that trigger a search.

  1. Never
  2. 1 to 5 times
  3. 6 to 10 times
  4. 11 to 20 times
  5. 21 to 50 times
  6. 51 to 100 times
  7. 101 to 500 times
  8. More than 500 times

Q20: Which is your currently selected search engine?

Brave.Search.DefaultEngine.4 [D] [A] [iOS]

  1. Other
  2. Google
  3. DuckDuckGo
  4. Startpage
  5. Bing
  6. Qwant
  7. Yandex
  8. Ecosia
  9. Brave Search

Q21: How much data did Brave save you last week?

Note: this is based on a predictive algorithm running strictly client-side

Brave.Savings.BandwidthSavingsMB [D] [A] [iOS]

  1. 0
  2. >0-50mb
  3. 51-100mb
  4. 101-200mb
  5. 201-400mb
  6. 401-700mb
  7. 701-1500mb
  8. more than 1501mb

Q22: Is crash reporting enabled?

Note: Records the corresponding preference ("Help improve Brave's features and performance ") state during a startup.

Brave.Core.CrashReportsEnabled [D] [A]

  1. no
  2. yes

Q23: Have you used SpeedReader?

Brave.SpeedReader.Enabled [D]

  1. Never Used
  2. Used but not recently (in reporting interval)
  3. Used within the last week

Q24: Number of times user clicked on SpeedReader button to toggle the feature?

Brave.SpeedReader.ToggleCount [D]

  1. 0
  2. 1-5
  3. 5-10
  4. 10-20
  5. 20-30
  6. 30+

Q25: On average, how many New Tab Pages did you create per day?

Brave.NTP.NewTabsCreated [D] [A] [iOS]

  1. 0
  2. 1 to 3
  3. 4 to 8
  4. 9 to 20
  5. 21 to 50
  6. 51 to 100
  7. More than 100

Q26: Is the sponsored new tab page option enabled?

Brave.NTP.SponsoredImagesEnabled [D] [A] [iOS]

  1. Disabled
  2. Enabled

Q27: On average, how many of the New Tab Pages you saw per day were sponsored?

Brave.NTP.SponsoredNewTabsCreated [D] [A] [iOS]

  1. 0%
  2. > 0% and < 10%
  3. 10% to < 20%
  4. 20% to < 30%
  5. 30% to < 40%
  6. 40% to < 50%
  7. 50% or more

Q28: On the New Tab Page, did you click the Customize Settings icon?

Brave.NTP.CustomizeUsageStatus [D]

  1. No
  2. Yes, but I didn't make any changes
  3. Yes, and I did make a change

Q29: Is IPFS Companion installed?

Brave.IPFS.IPFSCompanionInstalled [D]

  1. No
  2. Yes

Q30: How many lifetime times are IPFS detection prompts shown without installing

Brave.IPFS.DetectionPromptCount [D]

  1. 0 times
  2. 1 time
  3. 2-5 times
  4. 5+ times or more

Q30: How does IPFS resolve ipfs/ipns protocol?

Brave.IPFS.GatewaySetting [D]

  1. Ask
  2. Gateway
  3. Local Node
  4. Disabled

Q31: How long did the daemon run?

Brave.IPFS.DaemonRunTime [D]

  1. 0-5min
  2. 5-60min
  3. 1h-24h
  4. 24h+

Q32: Have you ever used Brave Today?

Brave.Today.HasEverInteracted [D]

  1. Yes

Q33: How many times did you use Brave Today in the last week that Brave Today was used?*

Brave.Today.WeeklySessionCount [D] [iOS]

  1. Never
  2. Once
  3. 2-3 times
  4. 4-7 times
  5. 8-12 times
  6. 13-18 times
  7. 19-25 times
  8. 26+ times

Q34: How many articles did you visit (or read) in your largest article-reading session in the preceeding week of the last time you visited a Brave Today article?*

Brave.Today.WeeklyMaxCardVisitsCount [D] [iOS]

  1. None (won't ever be sent)
  2. 1
  3. 2-3
  4. 4-6
  5. 7-10
  6. 11-15
  7. 16+

Q35: How many rows of articles did you view in your largest row-viewing session in the preceeding week of the last time you used Brave Today?*

Brave.Today.WeeklyMaxCardViewsCount [D] [iOS]

  1. None (won't ever be sent)
  2. 1
  3. 2-4
  4. 5-12
  5. 13-20
  6. 21-40
  7. 41-80
  8. 81+

* Refers to the issue whereby stats won't be reset or updated if the corresponding feature is not used in the next time period.

Q36: Was reset sync progress marker procedure ever done?

Brave.Sync.ProgressTokenEverReset [D] [A]

  1. 0-Normal reset of progress marker due to 7th failure
  2. 1-Reset progress marker due to 7th failure happening twice in a row in less than 30 minutes

Q37: Have you used the wallet in the previous month?

Brave.Wallet.UsageMonthly.2 [D] [A]

  1. No
  2. Yes

Q38/39: How many days have you used the wallet in the past 7 days?

Brave.Wallet.UsageDaysInWeek [D] [A]

  1. No usage
  2. One day
  3. Two days
  4. Three days
  5. Four days
  6. Five days
  7. Six days
  8. Seven days

Q40: Did you switch search engines this week, and if so from what to what?

Brave.Search.SwitchEngine [D] [A] [iOS]

  1. No
  2. Yes, from Brave to Google
  3. Yes, from Brave to DuckDuckGo
  4. Yes, from Brave to Other
  5. Yes, from Google to Brave
  6. Yes, from DuckDuckGo to Brave
  7. Yes, from Other to Brave
  8. Yes, from Other to Other

Q42: Has the Wallet keyring been created?

Brave.Wallet.KeyringCreated [D] [A]

  1. No
  2. Yes

Q43: What is the DefaultWalletSetting?

Brave.Wallet.DefaultWalletSetting [D] [A]

  1. AskDeprecated
  2. None
  3. CryptoWallets
  4. BraveWalletPreferExtension
  5. BraveWallet

Q44: Was the IPFS local node installed? If so, is it still used?

Brave.IPFS.LocalNodeRetention [D] [A]

  1. Never installed
  2. Installed, in use
  3. Installed, but disabled

Q45: Are ads enabled? If not, were they enabled in the past? If so, for how long?

Brave.Rewards.AdsEnabledDuration [D] [A] [iOS]

  1. It was never on
  2. It’s still on
  3. Less than three hours
  4. Less than three days
  5. Less than three weeks
  6. Less than three months
  7. More than three months

Q46: What is the global ad blocking shields setting?

Brave.Shields.AdBlockSetting [D] [A] [iOS]

  1. Disabled
  2. Standard
  3. Aggressive

Q47: What is the global fingerprinting shields setting?

Brave.Shields.FingerprintBlockSetting [D] [A] [iOS]

  1. Disabled
  2. Standard
  3. Aggressive

Q48: How many external feeds did you add last week?

Brave.Today.WeeklyAddedDirectFeedsCount [D] [A] [iOS]

  1. None
  2. 1 feed
  3. 2 feeds
  4. 3 feeds
  5. 4 feeds
  6. 5 feeds
  7. 6 to 10 feeds
  8. More than 10 feeds

Q49: How many external feeds do you have in total?

Brave.Today.DirectFeedsTotal [D] [A] [iOS]

  1. None
  2. 1 feed
  3. 2 feeds
  4. 3 feeds
  5. 4 feeds
  6. 5 feeds
  7. 6 to 10 feeds
  8. More than 10 feeds

Q50: How many Brave News cards did you view in the past week?

Brave.Today.WeeklyTotalCardViews [D] [A] [iOS]

  1. None
  2. 1
  3. 2 to 10
  4. 11 to 20
  5. 21 to 40
  6. 41 to 80
  7. 81 to 100
  8. 101 or more

Q51: On how many domains has the user set the adblock setting to be lower (block less) than the default?

Brave.Shields.DomainAdsSettingsBelowGlobal [D] [A] [iOS]

  1. 0
  2. 1-5
  3. 6-10
  4. 11-20
  5. 21-30
  6. 31+

Q52: On how many domains has the user set the adblock setting to be higher (block more) than the default?

Brave.Shields.DomainAdsSettingsAboveGlobal [D] [A] [iOS]

  1. 0
  2. 1-5
  3. 6-10
  4. 11-20
  5. 21-30
  6. 31+

Q53: On how many domains has the user set the FP setting to be lower (block less) than the default?

Brave.Shields.DomainFingerprintSettingsBelowGlobal [D] [A] [iOS]

  1. 0
  2. 1-5
  3. 6-10
  4. 11-20
  5. 21-30
  6. 31+

Q54: On how many domains has the user set the FP setting to be higher (block more) than the default?

Brave.Shields.DomainFingerprintSettingsAboveGlobal [D] [A] [iOS]

  1. 0
  2. 1-5
  3. 6-10
  4. 11-20
  5. 21-30
  6. 31+

Q55: As an opted in Brave News user, when was the last time I used Brave News?

Brave.Today.LastUsageTime [D] [A] [iOS]

  1. Within the last 6 days
  2. 7 - 13 days ago
  3. 14 - 20 days ago
  4. 21 - 27 days ago
  5. 28 - 59 days ago
  6. 60 days ago or more

Q56: As an opted in Brave News user, how many days did I use Brave News in the last 30 days?

Brave.Today.DaysInMonthUsedCount [D] [A] [iOS]

  1. 0 days
  2. 1 day
  3. 2 days
  4. 3 to 5 days
  5. 6 to 10 days
  6. 11 to 15 days
  7. 16 to 20 days
  8. More than 20 days

Q57: As a first time user of Brave News this week, did I return again to use it during the first 7 day period?

Brave.Today.NewUserReturning [D] [A] [iOS]

  1. I have never used Brave News
  2. I have used Brave News, but I'm not a first time Brave News user this week
  3. I'm a first time Brave News user this week but, no, I did not return the rest of the week
  4. I'm a first time Brave News user this week and, yes, I returned and used it again the following day
  5. I'm a first time Brave News user this week and, yes, I returned and used it again this week but not the following day

Q58: Did the participant in Group A click on the promo and did they switch their default engine to Brave Search?

Brave.Search.Promo.Button [D]

  1. No, No
  2. Yes, No
  3. No, Yes
  4. Yes, Yes

Q59: Did the participant in Group B click on the promo and did they switch their default engine to Brave Search?

Brave.Search.Promo.Banner [D]

  1. No, No
  2. Yes, No
  3. No, Yes
  4. Yes, Yes

Q60. As a first time user of Brave Wallet this week, did I return again to use it during the first 7 day period?

Brave.Wallet.NewUserReturning [D] [A]

  1. I have never used Brave Wallet
  2. I have used Brave Wallet, but I'm not a first time Brave Wallet user this week
  3. I'm a first time Brave Wallet user this week but, no, I did not return the rest of the week
  4. I'm a first time Brave Wallet user this week and, yes, I returned and used it again the following day
  5. I'm a first time Brave Wallet user this week and, yes, I returned and used it again this week but not the following day

Q61. If you accessed the Wallet page at least once, did you create/import a wallet?

Brave.Wallet.OnboardingConversion.2 [D] [A]

  1. I accessed the wallet page, but did not set up the wallet
  2. Yes, I have set up a new wallet
  3. Yes, I have imported an existing wallet

Q62. Did the participant in Group C click on the promo and did they switch their default engine to Brave Search?

Brave.Search.Promo.NewTabPage [D] [A]

  1. No, No
  2. Yes, No
  3. No, Yes
  4. Yes, Yes

Q63. As a Brave VPN user, when was the last time I enabled the Brave VPN?

Brave.VPN.LastUsageTime [D] [A] [iOS]

  1. Within the last 6 days
  2. 7 - 13 days ago
  3. 14 - 20 days ago
  4. 21 - 27 days ago
  5. 28 - 59 days ago
  6. 60 days ago or more

Q64. As Brave VPN user, how many different days did I enable the Brave VPN in the last 30 days?

Brave.VPN.DaysInMonthUsed [D] [A] [iOS]

  1. 0 days
  2. 1 day
  3. 2 days
  4. 3 to 5 days
  5. 6 to 10 days
  6. 11 to 15 days
  7. 16 to 20 days
  8. More than 20 days

Q65. As a first time user of the Brave VPN this week, did I enable it again the following day?

Brave.VPN.NewUserReturning [D] [A] [iOS]

  1. I have never enabled the Brave VPN
  2. I have enabled the Brave VPN, but I'm not a first time Brave VPN user this week
  3. I'm a first time Brave VPN user this week but, no, I did not enable the Brave VPN the rest of the week
  4. I'm a first time Brave VPN user this week and, yes, I did enable it again the following day
  5. I'm a first time Brave VPN user this week and, yes, I enabled it again this week but not the following day

Q66. Do you have Web Discovery Project enabled?

Brave.Search.WebDiscoveryEnabled [D]

  1. No
  2. Yes

Q67. What is the default Solana wallet setting?

Brave.Wallet.DefaultSolanaWalletSetting [D] [A]

  1. AskDeprecated
  2. None
  3. CryptoWallets
  4. BraveWalletPreferExtension
  5. BraveWallet

Q68. If you have viewed the cookie consent block prompt, how did you react?

Brave.Shields.CookieListPrompt [D] [A] [iOS]

  1. Have not seen the prompt
  2. Have seen the prompt, but did not react
  3. Clicked "No thanks" on the prompt
  4. Clicked "Block cookie notices" on the prompt

Q69. Do you have cookie consent notice blocking enabled?

Brave.Shields.CookieListEnabled [D] [A] [iOS]

  1. No
  2. Yes

Q70. What is your preferred Ethereum provider?

Brave.Wallet.EthProvider.2 [D]

  1. None (native wallet not setup or third-party extension not installed)
  2. Third-party wallet extension
  3. Native wallet (wallet is setup)

Q71. How many pages did you load in the past week?

Brave.Core.PagesLoaded [D] [A] [iOS]

  1. 0 pages
  2. 1-10
  3. 11-50
  4. 51-100
  5. 101-500
  6. 501-1000
  7. Greater than 1000 pages

Q72. How many unique domains did you load in the past week?

Brave.Core.DomainsLoaded [D] [A]

  1. 0 domains
  2. 1-4
  3. 5-10
  4. 11-30
  5. 31-50
  6. 51-100
  7. Greater than 100 domains

Q73. If you have ever sent a transaction, have you sent one in the past 7 days?

Brave.Wallet.EthTransactionSent, Brave.Wallet.SolTransactionSent and Brave.Wallet.FilTransactionSent [D] [A]

  1. No
  2. Yes

Q74. As an active ETH/SOL/FIL user (that currently has an active account, or previously has had one), how many accounts do you have with a non-zero balance?

Brave.Wallet.ActiveEthAccounts, Brave.Wallet.ActiveSolAccounts and Brave.Wallet.ActiveFilAccounts [D] [A]

  1. 0 accounts
  2. 1 account
  3. 2 accounts
  4. 3 accounts
  5. 4-7 accounts
  6. 8+ accounts

Q75. As a Brave Wallet user, when was the last time I unlocked the wallet?

Brave.Wallet.LastUsageTime [D] [A]

  1. Within the last 6 days
  2. 7 - 13 days ago
  3. 14 - 20 days ago
  4. 21 - 27 days ago
  5. 28 - 59 days ago
  6. 60 days ago or more

Q76. What menu functionality group do you use the most?

Brave.Toolbar.FrequentMenuGroup [D]

  1. Tab & window actions (new tab/new window)
  2. Brave features (Wallet, Rewards, Sync)
  3. Browser views (History, Bookmarks, Extensions, Settings)

Q77. How often is the menu triggered and dismissed without an action taken in the past week?

Brave.Toolbar.MenuDismissRate [D]

  1. Menu was not opened in the past week
  2. Less than 25% (exclusive) of opens
  3. Between 25% (inclusive) and 50% (exclusive) of opens
  4. Between 50% (inclusive) and 75% (exclusive) of opens
  5. More than 75% of opens

Q78. How many times was the menu opened in the past 7 days?

Brave.Toolbar.MenuOpens [D] [iOS]

  1. 0
  2. 1-5
  3. 6-15
  4. 16-29
  5. 30-49
  6. 50+

Q79. How many News ads have I viewed in the past 7 days?

Brave.Today.WeeklyDisplayAdsViewedCount [D] [A] [iOS]

  1. 0
  2. 1
  3. 2-4
  4. 5-12
  5. 13-20
  6. 21-40
  7. 41-80
  8. 81+

Q80. How many days did you use the browser in the previous ISO week?

Brave.Core.WeeklyUsage [D] [A]

  1. 0 days
  2. 1 day
  3. 2 days
  4. 3 days
  5. 4 days
  6. 5 days
  7. 6 days
  8. 7 days

Metrics Proposed/Under Development

Metrics in various states of development can be found in the brave-browser issue log with the feature/new-metric label:

https://github.com/brave/brave-browser/labels/feature%2Fnew-metric

Clone this wiki locally