Part Two on capturing media metrics (Part one and some examples)
Taking advantage of the APIs is easy; they are all HTTP-based.
1. Adding a new item to track - after you have uploaded a new media file (e.g. video) to either YouTube, Revver and/or Grouper, simply point your browser to the following URL:
http://www.davehodson.com/cm/chart/l/?URL=[URL]
where [URL] is the full URL of the video. For example, adding a YouTube's "Happy New Year" video would look like this:
http://www.davehodson.com/cm/chart/l/?URL=http://www.youtube.com/watch?v=BPsfbV9t8Vw
Once the item has been added, the system will begin tracking the available metrics.
2. Number of views - produces a chart showing the number of times the media was viewed. To view the chart, use the following URL:
http://www.davehodson.com/cm/chartviews/[size]/?URL=[URL]
where [size] is the size of the image (see "Size" below). For example, the page views for "Home" would look like this
http://www.davehodson.com/cm/chartviews/l/?URL=http://www.youtube.com/watch?v=_nZQOKGXhlk
3. Number of comments - produces a chart showing the number of comments posted about the media. To view, use the following URL:
http://www.davehodson.com/cm/chartcomments/[size]/?URL=[URL]
For example, the page comments with a size of medium for "Home" would look like this
http://www.davehodson.com/cm/chartcomments/m/?URL=http://www.youtube.com/watch?v=_nZQOKGXhlk
4. Number of times favorited - shows the number of times the media was marked as a "favorite" (currently only supported by YouTube). To view, use the following URL:
http://www.davehodson.com/cm/chartfavorited/[size]/?URL=[URL]
For example, the number of times the media was marked as favorite with a size of small for "Home" would look like this
http://www.davehodson.com/cm/chartfavorited/s/?URL=http://www.youtube.com/watch?v=_nZQOKGXhlk
5. Number of ratings - details the number of times the media was rated by viewers. To view, use the following URL:
http://www.davehodson.com/cm/chartratings/[size]/?URL=[URL]
For example, the number of times the media was rated with a size of small for "Home" would look like this
http://www.davehodson.com/cm/chartratings/s/?URL=http://www.youtube.com/watch?v=_nZQOKGXhlk
6. Average Rating - shows the average rating for the media. To view, use the following URL:
http://www.davehodson.com/cm/chartavgrating/[size]/?URL=[URL]
For example, the average rating for the media was rated with a size of large for "Tornado Chasers Get Chased" would look like this
7. Combination - if you want to produce a chart that combines different metrics (#2-6 above), use the following URL:
http://www.davehodson.com/cm/chart/[size]/?URL=[URL][&numviews=1][&numcomments=1][&numratings=1][&avgrating=1][&numfavorited=1]
For example, a combination of ratings and comments with a size of large for "Home" would look like this
Notes:
Size - You can create 3 different sized charts:
Large: 300 x 600, includes a legend detailing each metric
Medium: 150 x 300, includes a legend
Small: 100 x 200
Duration - currently, all charts will show the last 30 days of data, if it is available. For example, if you added media to track on 12/1/2006, the chart produced for 1/3/2007 would include data from 12/2/2006 to 1/2/2007.