Tiles: Difference between revisions

Latest revision as of 22:40, 12 May 2015

Tiles

Every time a user opens up a new tab in Firefox, the browser displays a number of boxes, or Tiles. Frequent Firefox users see screenshots of the websites they visit most often in their Tiles. What appears in Tiles is currently based on “frecency” (an algorithm that combines your recency of visiting a site and your frequency of visiting a site). Sites that have been visited with the most recency and frequency appear in a user’s Tile.

Default tiles and Enhanced tiles have been running for all current versions of Firefox and pre-release versions where Enhanced tiles are only visible to users who would have seen a history tile for that site in the new tab page. Suggested tiles are available to en-US Firefox 38 users and all Firefox 39 users where suggestions are shown if the user's top sites match a list of sites.

NOTE: Information about the progress and plans for Tiles can be found in the Content services page.

History Tile

History Tiles are chosen based on the most-visited sites for a user. Only one tile from each domain is shown.

Default Tiles

New users to Firefox are given a set of tiles, default tiles, as suggestions for sites of interest until they generate their own history tiles based off their browsing experience. The list of default tiles given to new users is built from popular tiles and other tiles Mozilla chooses.

Firefox periodically downloads a list of tiles to use as default tiles, based on basic information such as the user locale and geographic location (determined by IP address). As the user gains browsing history, the default tiles will be mixed and replaced by History Tiles. Feature bug and dependent code changes

Suggested Tiles

For users with certain top sites in their new tab page, Firefox may suggest a new tile for users to visit. The suggestion will explain why it's being shown, e.g., "Suggested for wiki.mozilla.org visitors." These suggestions will only be shown a fixed number of times before they're automatically removed. Feature bug and dependent code changes

Enhanced Tiles

For users with existing tiles (history tiles) in their new tab page, Firefox may substitute a better image for the screenshot generated by default. The enhanced tile would not be displayed to a user unless that website would already have appeared on their new tab page, based on their browsing history. The improved image is supplied by the site or partner and can include a logo plus a rollover image. Feature bug and dependent code changes

How to control Tiles?

Mozilla has support pages if you're looking to customize the new tab page, as well as a page that explains how tiles work.

Technical Details

Source Code

Firefox code related to the new tab page that powers Tiles.

Onyx is a link server and engagement metrics aggregator for Firefox Tiles handling the delivery and receiving the metrics of Tiles via 3 data endpoints.
- https://github.com/mozilla/onyx

Infernyx contains the rules to extract the metrics data and handles the immediate data processing of raw received data into aggregate data.
- https://github.com/mozilla/infernyx

Splice is our ingestion, validation, and authoring tool that makes sure tiles are processed, then published to the correct locale and country for Firefox users. It also contains the schemas for the metrics data.
- https://github.com/mozilla/splice

@@ Line 1: / Line 1: @@
 == Tiles ==
-Every time a user opens up a new tab in Firefox, the browser displays a number of boxes, or Tiles. Frequent Firefox users see screenshots of the websites they visit most often in their Tiles.  What appears in Tiles is currently based on a “frecency” algorithm: your recency of visiting a site and your frequency of visiting a site.  Sites that have been visited with the most recency and frequency appear in a user’s Tile.
+Every time a user opens up a new tab in Firefox, the browser displays a number of boxes, or Tiles. Frequent Firefox users see screenshots of the websites they visit most often in their Tiles.  What appears in Tiles is currently based on “frecency” (an algorithm that combines your recency of visiting a site and your frequency of visiting a site).  Sites that have been visited with the most recency and frequency appear in a user’s Tile.
-Directory tiles have been running for new users in Nightly, Aurora, and Beta but not yet in production.  Enhanced tiles are now available to users on the en-US versions of Firefox Nightly, Aurora and Beta, and will be visible only to users who frequently and recently visit the site of participating partners.
+Default tiles and Enhanced tiles have been running for all current versions of Firefox and pre-release versions where Enhanced tiles are only visible to users who would have seen a history tile for that site in the new tab page. Suggested tiles are available to en-US Firefox 38 users and all Firefox 39 users where suggestions are shown if the user's top sites match a list of sites.
 '''NOTE''': ''Information about the progress and plans for Tiles can be found in the [[Content services]] page.''
+=== History Tile ===
-=== Directory Tiles ===
+History Tiles are chosen based on the most-visited sites for a user. Only one tile from each domain is shown.
-New users to Firefox are given a set of tiles, directory tiles, as suggestions for sites of interest until they generate their own history tiles based off their browsing experience.  The list of directory tiles given to new users is built from popular tiles and other tiles Mozilla chooses.
+=== Default Tiles ===
+[[File:Directory-tiles-new-tab-page-screenshot.png|thumbnail|Default Tiles]]
+New users to Firefox are given a set of tiles, default tiles, as suggestions for sites of interest until they generate their own history tiles based off their browsing experience.  The list of default tiles given to new users is built from popular tiles and other tiles Mozilla chooses.
+Firefox periodically downloads a list of tiles to use as default tiles, based on basic information such as the user locale and geographic location (determined by IP address). As the user gains browsing history, the default tiles will be mixed and replaced by History Tiles. ''[https://bugzilla.mozilla.org/show_bug.cgi?id=972913 Feature bug and dependent code changes]''
+=== Suggested Tiles ===
+For users with certain top sites in their new tab page, Firefox may suggest a new tile for users to visit. The suggestion will explain why it's being shown, e.g., "Suggested for wiki.mozilla.org visitors." These suggestions will only be shown a fixed number of times before they're automatically removed. ''[https://bugzilla.mozilla.org/show_bug.cgi?id=1120311 Feature bug and dependent code changes]''
 === Enhanced Tiles ===
-For users with existing tiles (history tiles) in their new tab page, Firefox may substitute a better image for the screenshot generated by default. The enhanced tile would not be displayed to a user unless that website would already have appeared on their new tab page, based on their browsing history. The improved image is supplied by the site or partner and can include a logo plus a rollover image.
+For users with existing tiles (history tiles) in their new tab page, Firefox may substitute a better image for the screenshot generated by default. The enhanced tile would not be displayed to a user unless that website would already have appeared on their new tab page, based on their browsing history. The improved image is supplied by the site or partner and can include a logo plus a rollover image. ''[https://bugzilla.mozilla.org/show_bug.cgi?id=1030832 Feature bug and dependent code changes]''
 === How to control Tiles? ===
@@ Line 23: / Line 34: @@
 === Technical Details ===
-To learn more about the technical details of Tiles, please see the [[Directory Tiles]] document.
+* [http://gecko.readthedocs.org/en/latest/browser/browser/DirectoryLinksProvider.html In-Tree Technical Documentation]
+* [https://github.com/oyiptong/onyx/blob/master/README.md Payload Schema Documentation]
+* [[/Testing Notes|Testing notes on Tiles]]
+==== Source Code ====
+* '''Firefox''' code related to the new tab page that powers Tiles.
+**https://mxr.mozilla.org/mozilla-central/source/browser/base/content/newtab/
+**https://mxr.mozilla.org/mozilla-central/source/browser/modules/DirectoryLinksProvider.jsm
+**https://mxr.mozilla.org/mozilla-central/source/toolkit/modules/NewTabUtils.jsm
+* '''Onyx''' is a link server and engagement metrics aggregator for Firefox Tiles handling the delivery and receiving the metrics of Tiles via 3 data endpoints.
+** https://github.com/mozilla/onyx
+* '''Infernyx''' contains the rules to extract the metrics data and handles the immediate data processing of raw received data into aggregate data.
+** https://github.com/mozilla/infernyx
+* '''Splice''' is our ingestion, validation, and authoring tool that makes sure tiles are processed, then published to the correct locale and country for Firefox users. It also contains the schemas for the metrics data.
+** https://github.com/mozilla/splice
+[[Category:Content Services]]