diff --git a/.circleci/config.yml b/.circleci/config.yml
index f05c65e..b8b04ac 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -8,7 +8,7 @@ version: 2.1
jobs:
Linting:
docker:
- - image: cimg/node:14.13.1
+ - image: cimg/python:3.8.8-node
steps:
- checkout
- run:
@@ -23,7 +23,7 @@ jobs:
Firefox integration tests:
docker:
- - image: cimg/node:14.13.1
+ - image: cimg/python:3.8.8-node
steps:
- checkout
- run:
diff --git a/.eslintignore b/.eslintignore
index 1521c8b..37aba94 100644
--- a/.eslintignore
+++ b/.eslintignore
@@ -1 +1,2 @@
dist
+tests/integration/webarchive
diff --git a/.eslintrc.js b/.eslintrc.js
index b5302c3..6942f33 100644
--- a/.eslintrc.js
+++ b/.eslintrc.js
@@ -40,6 +40,7 @@ module.exports = {
"mocha"
],
root: true,
+ ignorePatterns: [ "compiled-ts/**/*.js" ],
rules: {
"node/no-deprecated-api": "error",
"node/no-extraneous-require": "off",
@@ -47,7 +48,6 @@ module.exports = {
"node/no-unpublished-import": "off",
"node/no-unpublished-require": "off",
"node/no-unsupported-features/es-syntax": "off",
-
"no-multi-spaces": "error",
"no-unused-vars": [ "error", { vars: "all", args: "none", ignoreRestSiblings: false } ],
"no-var": "warn",
diff --git a/.github/story.md b/.github/story.md
new file mode 100644
index 0000000..4eb7e5f
--- /dev/null
+++ b/.github/story.md
@@ -0,0 +1,19 @@
+---
+name: Story
+about: Use this to file a new story for a cycle
+title: "[story]"
+assignees: ''
+
+---
+
+## Story
+
+*fill this out*: as a **PERSONA**, I want to **BE ABLE TO DO SOME TASK** so that I can **ACHIEVE AN INTENDED OUTCOME**.
+
+## Definition of Done (optional)
+
+*Write out the concrete deliverable here in a sentence.*
+
+## Tasks (optional)
+
+*List all the tasks needed to close this story. You can follow the [task list](https://docs.github.com/en/github/managing-your-work-on-github/about-task-lists) syntax. Feel free to link to each task as its own github issue!*
diff --git a/.gitignore b/.gitignore
index 69c21cb..8b74c08 100644
--- a/.gitignore
+++ b/.gitignore
@@ -105,3 +105,15 @@ dist
# Generated study files
web-ext-artifacts/
+
+# Compiled Typescript .js
+compiled-ts/
+
+.DS_Store
+
+# Testing output files
+tests/output/
+
+# Glean-related files
+.venv/
+src/generated/
diff --git a/.taskcluster.yml b/.taskcluster.yml
new file mode 100644
index 0000000..db0ea57
--- /dev/null
+++ b/.taskcluster.yml
@@ -0,0 +1,308 @@
+---
+version: 1
+reporting: checks-v1
+policy:
+ pullRequests: collaborators
+tasks:
+ - $let:
+ # XXX Set to `true` for private repos
+ privateRepo: false
+ # XXX Use
+ # `system` for system add-on,
+ # `privileged` for AMO or self-hosted privileged add-on,
+ # `mozillaonline-privileged` for Mozilla China add-on,
+ # `normandy-privileged` for normandy add-on
+ # to enable siging on push/PR.
+ xpiSigningType: "privileged"
+ # The below doesn't need changing on initial repo setup
+ template:
+ repo: https://github.com/mozilla-extensions/xpi-template
+ branch: main
+ trustDomain: xpi
+ in:
+ $if: 'tasks_for in ["github-pull-request", "github-push", "action", "cron"]'
+ then:
+ $let:
+ # Github events have this stuff in different places...
+ ownerEmail:
+ $if: 'tasks_for == "github-push"'
+ then: '${event.pusher.email}'
+ # Assume Pull Request
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.user.login}@users.noreply.github.com'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${tasks_for}@noreply.mozilla.org'
+ project:
+ $if: 'tasks_for == "github-push"'
+ then: '${event.repository.name}'
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.head.repo.name}'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${repository.project}'
+ head_branch:
+ $if: 'tasks_for == "github-pull-request"'
+ then: ${event.pull_request.head.ref}
+ else:
+ $if: 'tasks_for == "github-push"'
+ then: ${event.ref}
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${push.branch}'
+ head_sha:
+ $if: 'tasks_for == "github-push"'
+ then: '${event.after}'
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.head.sha}'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${push.revision}'
+ ownTaskId:
+ $if: '"github" in tasks_for'
+ then: {$eval: as_slugid("decision_task")}
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${ownTaskId}'
+ repoFullName:
+ $if: 'tasks_for in "github-push"'
+ then: '${event.repository.full_name}'
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.base.repo.full_name}'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ # Trim https://github.com/
+ then: '${repository.url[19:]}'
+ baseRepoUrl:
+ $if: '!privateRepo' # public repo
+ then:
+ $if: 'tasks_for == "github-push"'
+ then: '${event.repository.html_url}'
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.base.repo.html_url}'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${repository.url}'
+ else:
+ $if: 'tasks_for == "github-push"'
+ then: '${event.repository.ssh_url}'
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.base.repo.ssh_url}'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${repository.url}'
+ repoUrl:
+ $if: '!privateRepo' # public repo
+ then:
+ $if: 'tasks_for == "github-push"'
+ then: '${event.repository.html_url}'
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.head.repo.html_url}'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${repository.url}'
+ else:
+ $if: 'tasks_for == "github-push"'
+ then: '${event.repository.ssh_url}'
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then: '${event.pull_request.base.repo.ssh_url}'
+ else:
+ $if: 'tasks_for in ["cron", "action"]'
+ then: '${repository.url}'
+ in:
+ $let:
+ level: 1
+ in:
+ taskId:
+ $if: 'tasks_for != "action"'
+ then: '${ownTaskId}'
+ taskGroupId:
+ $if: 'tasks_for == "action"'
+ then:
+ '${action.taskGroupId}'
+ else:
+ '${ownTaskId}' # same as taskId; this is how automation identifies a decision task
+ schedulerId: '${trustDomain}-level-${level}'
+ created: {$fromNow: ''}
+ deadline: {$fromNow: '1 day'}
+ expires: {$fromNow: '1 year 1 second'} # 1 second so artifacts expire first, despite rounding errors
+ metadata:
+ $merge:
+ - owner: "${ownerEmail}"
+ - $if: '!privateRepo' # public repo
+ then:
+ source: '${repoUrl}/raw/${head_sha}/.taskcluster.yml'
+ else:
+ source: 'ssh://github.com/${repoUrl[15:-4]}/raw/${head_sha}/.taskcluster.yml'
+ - $if: 'tasks_for in ["github-push", "github-pull-request"]'
+ then:
+ name: "Decision Task"
+ description: 'The task that creates all of the other tasks in the task graph'
+ else:
+ $if: 'tasks_for == "action"'
+ then:
+ name: "Action: ${action.title}"
+ description: '${action.description}'
+ else:
+ name: "Decision Task for cron job ${cron.job_name}"
+ description: 'Created by a [cron task](https://tools.taskcluster.net/tasks/${cron.task_id})'
+ provisionerId: "xpi-${level}"
+ workerType: "decision"
+ tags:
+ $if: 'tasks_for in ["github-push", "github-pull-request"]'
+ then:
+ kind: decision-task
+ else:
+ $if: 'tasks_for == "action"'
+ then:
+ kind: 'action-callback'
+ else:
+ $if: 'tasks_for == "cron"'
+ then:
+ kind: cron-task
+ routes:
+ $flatten:
+ - checks
+ - $if: 'tasks_for == "github-push"'
+ then:
+ - "index.${trustDomain}.v2.${project}.revision.${head_sha}.taskgraph.decision"
+ else: []
+ scopes:
+ $if: 'tasks_for == "github-push"'
+ then:
+ $let:
+ short_head_branch:
+ $if: 'head_branch[:10] == "refs/tags/"'
+ then: {$eval: 'head_branch[10:]'}
+ else:
+ $if: 'head_branch[:11] == "refs/heads/"'
+ then: {$eval: 'head_branch[11:]'}
+ else: ${head_branch}
+ in:
+ - 'assume:repo:github.com/${repoFullName}:branch:${short_head_branch}'
+
+
+ else:
+ $if: 'tasks_for == "github-pull-request"'
+ then:
+ - 'assume:repo:github.com/${repoFullName}:pull-request'
+
+ else:
+ $if: 'tasks_for == "action"'
+ then:
+ # when all actions are hooks, we can calculate this directly rather than using a variable
+ - '${action.repo_scope}'
+ else:
+ - 'assume:repo:github.com/${repoFullName}:cron:${cron.job_name}'
+
+
+ requires: all-completed
+ priority: lowest
+ retries: 5
+
+ payload:
+ env:
+ # run-task uses these to check out the source; the inputs
+ # to `mach taskgraph decision` are all on the command line.
+ $merge:
+ - XPI_BASE_REPOSITORY: '${baseRepoUrl}'
+ XPI_HEAD_REPOSITORY: '${repoUrl}'
+ XPI_HEAD_REF: '${head_branch}'
+ XPI_HEAD_REV: '${head_sha}'
+ XPI_REPOSITORY_TYPE: git
+ XPI_SIGNING_TYPE: '${xpiSigningType}'
+ TEMPLATE_BASE_REPOSITORY: '${template.repo}'
+ TEMPLATE_HEAD_REPOSITORY: '${template.repo}'
+ TEMPLATE_HEAD_REV: '${template.branch}'
+ TEMPLATE_HEAD_REF: '${template.branch}'
+ TEMPLATE_REPOSITORY_TYPE: git
+ TEMPLATE_PIP_REQUIREMENTS: taskcluster/requirements.txt
+ REPOSITORIES: {$json: {xpi: "XPI Manifest", template: "XPI Template"}}
+ HG_STORE_PATH: /builds/worker/checkouts/hg-store
+ - $if: 'privateRepo'
+ then:
+ XPI_SSH_SECRET_NAME: project/xpi/xpi-github-clone-ssh
+ - $if: 'tasks_for in ["github-pull-request"]'
+ then:
+ XPI_PULL_REQUEST_NUMBER: '${event.pull_request.number}'
+ - $if: 'tasks_for == "action"'
+ then:
+ ACTION_TASK_GROUP_ID: '${action.taskGroupId}' # taskGroupId of the target task
+ ACTION_TASK_ID: {$json: {$eval: 'taskId'}} # taskId of the target task (JSON-encoded)
+ ACTION_INPUT: {$json: {$eval: 'input'}}
+ ACTION_CALLBACK: '${action.cb_name}'
+ features:
+ taskclusterProxy: true
+ chainOfTrust: true
+ # Note: This task is built server side without the context or tooling that
+ # exist in tree so we must hard code the hash
+ image: mozillareleases/taskgraph:decision-cf4b4b4baff57d84c1f9ec8fcd70c9839b70a7d66e6430a6c41ffe67252faa19@sha256:425e07f6813804483bc5a7258288a7684d182617ceeaa0176901ccc7702dfe28
+
+ maxRunTime: 1800
+
+ command:
+ - /usr/local/bin/run-task
+ - '--xpi-checkout=/builds/worker/checkouts/src'
+ - '--template-checkout=/builds/worker/checkouts/template'
+ - '--task-cwd=/builds/worker/checkouts/src'
+ - '--'
+ - bash
+ - -cx
+ - $let:
+ extraArgs: {$if: 'tasks_for == "cron"', then: '${cron.quoted_args}', else: ''}
+ in:
+ $if: 'tasks_for == "action"'
+ then: >
+ cd /builds/worker/checkouts/src &&
+ rm -rf taskcluster &&
+ ln -s /builds/worker/checkouts/template/taskcluster taskcluster &&
+ ln -s /builds/worker/artifacts artifacts &&
+ ~/.local/bin/taskgraph action-callback
+ else: >
+ rm -rf taskcluster &&
+ ln -s /builds/worker/checkouts/template/taskcluster taskcluster &&
+ ln -s /builds/worker/artifacts artifacts &&
+ ~/.local/bin/taskgraph decision
+ --pushlog-id='0'
+ --pushdate='0'
+ --project='${project}'
+ --message=""
+ --owner='${ownerEmail}'
+ --level='${level}'
+ --base-repository="$XPI_BASE_REPOSITORY"
+ --head-repository="$XPI_HEAD_REPOSITORY"
+ --head-ref="$XPI_HEAD_REF"
+ --head-rev="$XPI_HEAD_REV"
+ --repository-type="$XPI_REPOSITORY_TYPE"
+ --tasks-for='${tasks_for}'
+ ${extraArgs}
+
+ artifacts:
+ 'public':
+ type: 'directory'
+ path: '/builds/worker/artifacts'
+ expires: {$fromNow: '1 year'}
+
+ extra:
+ $merge:
+ - $if: 'tasks_for == "action"'
+ then:
+ parent: '${action.taskGroupId}'
+ action:
+ name: '${action.name}'
+ context:
+ taskGroupId: '${action.taskGroupId}'
+ taskId: {$eval: 'taskId'}
+ input: {$eval: 'input'}
+ - $if: 'tasks_for == "cron"'
+ then:
+ cron: {$json: {$eval: 'cron'}}
+ - tasks_for: '${tasks_for}'
diff --git a/OpenSearch/Brave.xml b/OpenSearch/Brave.xml
new file mode 100644
index 0000000..9452ba8
--- /dev/null
+++ b/OpenSearch/Brave.xml
@@ -0,0 +1,10 @@
+
+
+ Brave
+ Brave
+ Brave Search: private, independent, open
+ UTF-8
+ https://cdn.search.brave.com/serp/v1/static/brand/eebf5f2ce06b0b0ee6bbd72d7e18621d4618b9663471d42463c692d019068072-brave-lion-favicon.png
+
+
+
diff --git a/README.md b/README.md
index 8090fca..3e75ab4 100644
--- a/README.md
+++ b/README.md
@@ -1,80 +1,14 @@
-# Mozilla Rally study template.
-The purpose of this repository is to provide a starting point to build a Rally study. It contains:
+# Search Engine Usage Study [DECOMMISSIONED]
+A study to assess how individuals interact with their search engines.
-1. an example [`manifest.json`](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json) file.
-2. an example background and content script in `src/`.
-3. a rollup config file that builds the files needed for the web extension using the source files in `src/` (the background & content scripts).
-4. an example integration test that launches a browser & installs the add-on.
-5. a `web-ext-config.js` file & an eslint configuration.
-
-## Getting started
-
-1. Fork this repository.
-2. Customize the [manifest.json](./manifest.json) file:
- * change the `name`, `author`, and `description` properties;
- * swap the value of `application.gecko.id` (e.g. `ion-basic-study@mozilla.org`) with the one provided you by the Rally team;
-3. Customize the [package.json](./package.json) file. At a bare minimum, change the `name`,`description`, `version`, `author`, `repository`, `bugs`, and `homepage` properties;
-4. Provide the encryption data to the `Rally` class constructor in the [src/background.js](./src/background.js) file:
-
-```js
-rally.initialize(
- // A sample key id used for encrypting data.
- "sample-invalid-key-id",
- // A sample *valid* JWK object for the encryption.
- {
- "kty":"EC",
- "crv":"P-256",
- "x":"f83OJ3D2xF1Bg8vub9tLe1gHMzV76e8Tus9uPHvRVEU",
- "y":"x_FEzRu9m36HLN_tue659LNpXW6pCyStikYjKIWI5a0",
- "kid":"Public key used in JWS spec Appendix A.3 example"
- },
- // ... other required arguments ...
-);
-```
-
-4. From the forked repository directory, install all the NPM dependencies:
-
-```bash
-fork-dir> npm install .
-```
-
-5. Test the customized study in Firefox and commit your changes: doing this right after the initial fork provides a nice and clean cutting point with the original repository, which will simplify future updates (if needed).
-
-## Building upon this template
-This template uses [rollup.js](https://rollupjs.org/) as a module bundler and NPM for dependency management. The [manifest.json](./manifest.json) file already includes a sample background scripts.
-
-Dependencies can be added using the [`npm install`](https://docs.npmjs.com/cli/v6/commands/npm-install) command, using the appropriate `--save-dev` or `--save-prod` switch. This command will take care of automatically updating the [package.json](./package.json) file.
-
-New modules can be added in the `src/` directory. Modules need to expose the exported functions using the `module.exports` syntax. For example, a class can be exported as follows in a `MyClass.js` file:
-
-```js
-module.exports = class MyClass {
- myFunc() {
- console.log("Testing!");
- }
-}
-```
-
-And then be imported in another file with `const MyClass = require("./MyClass.js");`.
-
-Plain functions can be exposed as follows in a `MyFuncs.js` file:
-
-```js
-module.exports = {
- myTest() {
- //... something!
- },
- otherFunc() {
- // ... other function!
- }
-};
-```
-
-And then be imported in another file with `const {myTest, otherFunc} = require("./MyFuncs.js");`.
+## Requirements
+* [Node.js](https://nodejs.org/en/), available via [Homebrew](https://brew.sh/) on macOS
+* [Mozilla web-ext](https://extensionworkshop.com/documentation/develop/getting-started-with-web-ext/)
## Supported NPM commands
-The template comes with a set of pre-defined NPM commands (to run as `npm run `) to help study authors:
+The repo comes with a set of pre-defined NPM commands (to run as `npm run `):
+* `compile-typescript`: Compiles the Typescript source code. The compiled code is saved in the `src/` directory.
* `build`: assembles the final addon. The bundler generated code is saved in the `dist/` directory.
* `dev`: assembles the addon in _developer mode_. In this mode data doesn't get submitted but, instead, is dumped to the [Browser Console](https://developer.mozilla.org/en-US/docs/Tools/Browser_Console). This mode allows for a smoother development process.
* `lint`: run linting on the add-on code.
@@ -85,3 +19,5 @@ The template comes with a set of pre-defined NPM commands (to run as `npm run
+
+# Metrics
+
+This document enumerates the metrics collected by this project using the [Glean SDK](https://mozilla.github.io/glean/book/index.html).
+This project may depend on other projects which also collect metrics.
+This means you might have to go searching through the dependency tree to get a full picture of everything collected by this project.
+
+# Pings
+
+- [ballot-interaction](#ballot-interaction)
+- [deletion-request](#deletion-request)
+- [events](#events)
+- [modal-interaction](#modal-interaction)
+- [notice-interaction](#notice-interaction)
+- [online-service-navigation](#online-service-navigation)
+- [serp-visit](#serp-visit)
+- [study-enrollment](#study-enrollment)
+- [study-initialization](#study-initialization)
+
+## ballot-interaction
+
+This ping is sent for users in the search engine ballot treatment group
+once they've made a selection, or if they have refused to make a
+selection three times.
+
+
+**Data reviews for this ping:**
+
+-
+
+**Bugs related to this ping:**
+
+-
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| ballot_interaction.attempt_details |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |Details for each of the ballot attempts. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
attempt_number: What number attempt this was.
attention_duration: How long the presentation of the ballot had the user's attention.
details_expanded: The names of search engines on the ballot for which the participant expanded details (only relevant in Condition 5).
dwell_time: How long the presentation of the ballot was open.
see_more_selected: If the user clicked the “See More Search Engines” button (only relevant in Condition 7).
treatment_time: The time that the ballot was presented to the participant.
|never | |
+| ballot_interaction.attempts |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of times that a choice ballot was presented to the participant. If a selection is not made after 3 attempts, the ballot is not shown again. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: attempts
|never | |
+| ballot_interaction.ballot_ordering |[string_list](https://mozilla.github.io/glean/book/user/metrics/string_list.html) |The ordering of the search engines on the ballot. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| ballot_interaction.new_search_engine |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The search engine that the participant selected and the default was changed to. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| ballot_interaction.old_search_engine |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The participant's default search engine in web browser settings, before the treatment was applied. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| ballot_interaction.ping_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the data submission ping was generated. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| ballot_interaction.treatment_completion_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the treatment was completed. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## deletion-request
+
+This is a built-in ping that is assembled out of the box by the Glean SDK.
+
+See the Glean SDK documentation for the [`deletion-request` ping](https://mozilla.github.io/glean/book/user/pings/deletion-request.html).
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## events
+
+This is a built-in ping that is assembled out of the box by the Glean SDK.
+
+See the Glean SDK documentation for the [`events` ping](https://mozilla.github.io/glean/book/user/pings/events.html).
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## modal-interaction
+
+This ping is sent for users in the modal treatment group once the user
+interacts with the modal.
+
+
+**Data reviews for this ping:**
+
+-
+
+**Bugs related to this ping:**
+
+-
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| modal_interaction.ping_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the data submission ping was generated. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| modal_interaction.revert_selected |[boolean](https://mozilla.github.io/glean/book/user/metrics/boolean.html) |Whether the participant chose to revert the search engine change. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| modal_interaction.treatment_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the modal dialog was presented to the participant. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## notice-interaction
+
+This ping is sent after completion of the default condition treatment.
+We consider the treatment to be complete when the participant closes the
+default change notice, either by closing the notice window with the menu
+bar X, clicking on the “Close” button, clicking on the “Revert” button if
+it is present, or exiting the browser.
+
+
+**Data reviews for this ping:**
+
+-
+
+**Bugs related to this ping:**
+
+-
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| notice_interaction.attention_duration |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |How long the treatment notice had the participant's attention. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: milliseconds
|never | |
+| notice_interaction.dwell_time |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |How long the treatment notice was open. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: milliseconds
|never | |
+| notice_interaction.new_search_engine |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The search engine that the default was changed to. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| notice_interaction.old_search_engine |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The participant's default search engine in web browser settings, before the treatment was applied. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| notice_interaction.ping_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the data submission ping was generated. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| notice_interaction.revert_selected |[boolean](https://mozilla.github.io/glean/book/user/metrics/boolean.html) |Whether the participant selected the revert button. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| notice_interaction.treatment_completion_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the treatment was completed. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| notice_interaction.treatment_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the treatment was applied. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## online-service-navigation
+
+This ping is sent on around a daily basis and contains details
+about participant navigation to the tracked online services.
+
+
+**Data reviews for this ping:**
+
+-
+
+**Bugs related to this ping:**
+
+-
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| online_service_navigation.aggregation_period_start_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The start time of the current aggregation period. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| online_service_navigation.online_service_data |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |Accumulated participant navigation data for each of the tracked Google services and online services. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
attention_time: Total attention time during the current aggregation period.
completed_transaction_count: Count of transactions completed during the current aggregation period.
dwell_time: Total dwell time during the current aggregation period.
page_visit_count: Count of pages visited during the current aggregation period.
service_name: The name of the service.
|never | |
+| online_service_navigation.ping_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the data submission ping was generated. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## serp-visit
+
+This ping is sent when there is a visit to a search engine results page.
+
+
+**Data reviews for this ping:**
+
+-
+
+**Bugs related to this ping:**
+
+-
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.attention_duration |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |How long the SERP had the participant's attention. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: milliseconds
|never | |
+| serp_visit.attribution |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |How the user navigated to the search engine. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.attribution_id |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |A randomly generated unique ID that associates related SERPs. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.current_default_engine |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The participant's default search engine at the time of the SERP visit. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.dwell_time |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |How long the SERP was open in the participant's browser. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: milliseconds
|never | |
+| serp_visit.google_results_num |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of results produced for the query by Google. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: results
|never | |
+| serp_visit.modification_type |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The type of modification that the study attempted to make to the self-preferenced results on the search engine response page (None, Removal, Replacement). |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.navigational_query |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |If the search query was a navigational query to one of the tracked online services or Google services, then this will be the category of the online service it was for. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.num_ad_clicks |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of advertisements that the participant clicked on. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: clicks
|never | |
+| serp_visit.num_ads |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of advertisements on the page. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: pages
|never | |
+| serp_visit.num_internal_clicks |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of result links that the participant clicks and that lead to another page operated by the same company as the search engine. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: clicks
|never | |
+| serp_visit.num_self_preferenced_clicks |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of selections of links in the self-preferenced results. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: clicks
|never | |
+| serp_visit.organic_clicks |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |Details for each selection of an organic result on the SERP. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
attention_duration_upon_click: The attention duration when the selection occurred.
page_loaded_upon_selection: Whether the SERP completed loading when the selection occurred.
result_ranking: The ranking of the selected organic result.
|never | |
+| serp_visit.organic_details |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |Details for each of the organic results on the SERP. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
result_bottom_height: The number of pixels between the top of the page and the bottom of the organic result.
result_online_service: The online service of the result only if the result is for one of the tracked online services.
result_page_num: The page number that the organic result was on (only collected for DuckDuckGo SERPs, because they present results as one continuously scrolling page)
result_top_height: The number of pixels between the top of the page and the top of the organic result.
|never | |
+| serp_visit.page_loaded |[boolean](https://mozilla.github.io/glean/book/user/metrics/boolean.html) |Whether the SERP completed loading in the participant's browser. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.page_number |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The page number of the results for the query. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: page
|never | |
+| serp_visit.page_visit_start_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The timestamp the SERP visit started rounded down to the nearest hour. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.ping_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the data submission ping was generated. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.query_hash |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |A salted hash of the search query. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.query_vertical |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The category of online content the search query is for. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.results_num |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of results produced for the query by the search engine. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: results
|never | |
+| serp_visit.search_area_bottom_height |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of pixels between the top of the page and the bottom of the search result area. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: pixels
|never | |
+| serp_visit.search_area_top_height |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of pixels between the top of the page and the top of the search result area. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: pixels
|never | |
+| serp_visit.search_engine |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |Which search engine the user queried. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| serp_visit.self_preferenced_details |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |Details for each of the tracked self-preferenced results on the SERP. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
result_bottom_height: The number of pixels between the top of the page and the bottom of the self preferenced result.
result_top_height: The number of pixels between the top of the page and the top of the self preferenced result.
self_preferenced_result_type: The type of self-preferenced result that is on the page (flights, hotels, other travel, maps, lyrics, weather, shopping, or other direct answer).
|never | |
+| serp_visit.time_since_same_query |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The time since the participant made the same query to the same search engine. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: milliseconds
|never | |
+| serp_visit.transition |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The transition that brought the participant to this particular page. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## study-enrollment
+
+This ping is sent when the user has consented to the study.
+
+
+**Data reviews for this ping:**
+
+-
+
+**Bugs related to this ping:**
+
+-
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+
+## study-initialization
+
+This ping is sent when the study first loads in the participant's
+web browser.
+
+
+**Data reviews for this ping:**
+
+-
+
+**Bugs related to this ping:**
+
+-
+
+All Glean pings contain built-in metrics in the [`ping_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-ping_info-section) and [`client_info`](https://mozilla.github.io/glean/book/user/pings/index.html#the-client_info-section) sections.
+
+In addition to those built-in metrics, the following metrics are added to the ping:
+
+| Name | Type | Description | Data reviews | Extras | Expiration | [Data Sensitivity](https://wiki.mozilla.org/Firefox/Data_Collection) |
+| --- | --- | --- | --- | --- | --- | --- |
+| rally.id |[uuid](https://mozilla.github.io/glean/book/user/metrics/uuid.html) |The id of the Rally client. This is generated by the Rally SDKs. A value of 00000000-0000-0000-0000-000000000000 indicates a test payload. A value of 11111111-1111-1111-1111-111111111111 indicates that the Rally id was not found or properly set. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| study_initialization.ask_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to Ask.com over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: queries
|never | |
+| study_initialization.baidu_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to Baidu over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: queries
|never | |
+| study_initialization.bing_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to Bing over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: queries
|never | |
+| study_initialization.condition_type |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The randomly chosen condition group for the participant. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| study_initialization.default_search_engine |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |The participant's default search engine in web browser settings. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| study_initialization.duckduckgo_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to DuckDuckGo over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: queries
|never | |
+| study_initialization.ecosia_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to Ecosia over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: queries
|never | |
+| study_initialization.enrollment_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time when the participant joined the study. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| study_initialization.google_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to Google over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: queries
|never | |
+| study_initialization.history_age |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |How far back the browser's history goes, with a maximum of 30 days. We collect this value to account for participants who have a browser history that is shorter than 30 days. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: milliseconds
|never | |
+| study_initialization.landing_page_history |[boolean](https://mozilla.github.io/glean/book/user/metrics/boolean.html) |If the advertisement landing page is in browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| study_initialization.ping_time |[datetime](https://mozilla.github.io/glean/book/user/metrics/datetime.html) |The time that the data submission ping was generated. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| study_initialization.survey_id |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |A randomly generated unique ID that enables syncing survey data on Qualtrics with other data in the study. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)||never | |
+| study_initialization.yahoo_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to Yahoo! over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|
unit: queries
|never | |
+| study_initialization.yandex_query_count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |The number of unique search queries (the text a user enters into a search engine) to Yandex over the past 30 days from browser history. |[Review 1](https://docs.google.com/document/d/1TDfq3wwX2lPgCPVnksWaMtvEKiPCNuAQxITfob38Ga0)|