## FAQ

__How can I track the bandwidth?__

Log analytics:

The bandwidth will be automatically tracked when using the [log importer](http://piwik.org/log-analytics/) as long as 
your log format is supported.

Tracking API:

If you are using the [HTTP Tracking API](http://developer.piwik.org/api-reference/tracking-api) 
you can specify the bandwidth in bytes by appending the URL parameter `bw_bytes=1234` to the tracking URL. In this case 
a bandwidth of 1234 bytes will be tracked.

__Which actions support tracking of bandwidth?__

Pageviews (Page URLs and Page Titles) as well as Downloads.

__In which reports is the used bandwidth displayed?__

* Page URLs 
* Page Titles
* Downloads

All reports will show a column `Average Bandwidth` and `Sum Bandwidth`

The "Visitors => Overview" report shows a total bandwidth overview and it is possible to view the evolution over period.

__Which APIs does this plugin define or enrich?__

There is a report `Bandwidth.get` returning the total bandwidth (across all actions).

It also enriches varies reports such as `Actions.get`, `Actions.getPageUrls`, `Actions.getPageTitles` and `Actions.getDownloads`.
For example it adds columns such as `avg_bandwidth`, `sum_bandwidth`, `min_bandwidth`, `max_bandwidth` to each page view.

__Why are the bandwidth columns are not displayed in the UI?__

Make sure the Bandwidth plugin is activated by going to `Administration => Plugins`. Also the bandwidth columns are not 
displayed if no bandwidth was tracked in the current selected month.

__Is it possible to track bandwidth using the Matomo JavaScript Tracker?__

Yes, you can set the `bw_bytes` value manually in JavaScript using `_paq.push(['appendToTrackingUrl', 'bw_bytes=1234']);` to track the bandwidth of your pages.