LeOS-Ice-browser/android-components/components/feature/fxsuggest/README.md

3.6 KiB

Android Components > Feature > Firefox Suggest

A component for accessing Firefox Suggest search suggestions.

Firefox Suggest provides suggestions for sponsored and web content in the address bar. Suggestions are downloaded, stored, and matched on-device.

Usage

Setting up the dependency

Use Gradle to download the library from maven.mozilla.org (Setup repository):

implementation "org.mozilla.components:feature-fxsuggest:{latest-version}"

Facts

This component emits the following Facts:

Action Item Extras Description
INTERACTION amp_suggestion_clicked suggestion_clicked_extras The user clicked on a Firefox Suggestion from adMarketplace.
DISPLAY amp_suggestion_impressed suggestion_impressed_extras A Firefox Suggestion from adMarketplace was visible when the user finished interacting with the awesomebar.
INTERACTION wikipedia_suggestion_clicked suggestion_clicked_extras The user clicked on a Firefox Suggestion for a Wikipedia page.
DISPLAY wikipedia_suggestion_impressed suggestion_impressed_extras A Firefox Suggestion for a Wikipedia page was visible when the user finished interacting with the awesomebar.

suggestion_clicked_extras

Key Type Value
interaction_info FxSuggestInteractionInfo Type-specific information to record for this suggestion.
position Long The 1-based position of this suggestion in the awesomebar.

suggestion_impressed_extras

Key Type Value
interaction_info FxSuggestInteractionInfo Type-specific information to record for this suggestion.
position Long The 1-based position of this suggestion in the awesomebar.
is_clicked Boolean Whether the user clicked on this suggestion after it was shown.
engagement_abandoned Boolean Whether the user dismissed the awesomebar without navigating to a destination after this suggestion was shown.

License

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/