v1.x Project Roadmap

Tentative first draft:

v1.0 Objectives

#1111342: Fatal error: Call to a member function getMetrics() on a non-object
#1111348: warning: Invalid argument supplied for foreach()
#1111350: Invalid argument supplied for foreach() #2
#1111352: Reduce drupal_set_message() calls, replace with watchdog()
#1111356: Update project page with new copy and screenshot of report interface
#1111358: Create automated tests
#1111360: Investigate locking API to help control quota
#1111362: Polish report output
#804768: No output
#551146: Division by zero error when viewing a report and bounce rate is zero
#877860: make google_analytics_api_profile_id a optional parameter
#733376: A Google Analytics API method has been called that requires access to a Google account.
#934334: Wrong link to the administration page
#695480: Improve permissions for api and reports modules
#1089484: hook_perm() has the wrong hook
#550948: Automatically select correct site
#679008: Cache requests
#1021792: Error granting access during setup "Malformed request"
#1063532: Support Domain Access
#679028: Why is report generator hidden?
#1016668: Port to Drupal 7

v1.1 Objectives

#1111364: Restart module as "Google Analytics Reports"

v1.2 Objectives

#1111368: Move to OAuth
#757504: Integrate with Statistics
#760592: Integrate with Views so Views can use Google Analytics as a data source

I've written a new, smaller class to replace gapi. It uses OAuth, caches results, produces more useful and public objects, and supports users with multiple domains verified with Google.

Check it out: http://drupalcode.org/project/google_analytics_api.git/commitdiff/d50f5e8

Here is a basic sample report using the new library. This code is just to get the juices flowing :)

    /* Pageviews over the past 2 weeks */
    $params = array(
      'dimensions' => array('date'),
      'metrics' => array('pageviews'),
      'sort_metric' => array('date'),
      'start_date' => strtotime('-16 days')
    );
    
    /* Refresh => TRUE for debugging purposes only */
    $GAFeed = google_analytics_api_report_data($params, array('refresh' => TRUE));

    /* In general, metrics will be $data, and dimensions will be x labels. */
    foreach ($GAFeed->results as $row) {
      $data[] = $row['pageviews'];
      $x_labels[] = date('M d', strtotime($row['date']));
    }
    
    $chart = array(
      '#chart_id' => 'pageviews_2weeks',
      '#title' => chart_title(t('Pageviews over the past two weeks'), '027AC6', 15),
      '#data' => $data,
      '#type' => CHART_TYPE_LINE,
      '#size' => chart_size(800, 300),
      '#adjust_resolution' => TRUE,
      '#data_colors' => array('027AC6'),
      '#chart_fill' => chart_fill('bg', 'EDF5FA'),
      '#line_styles' => array(chart_line_style(3, 10, 0)),
      '#shape_markers' => array(chart_shape_marker(0, -1, 'o', 6, '027AC6')),
      '#grid_lines' => chart_grid_lines(0, 20, 1, 3),
    );
    $chart['#mixed_axis_labels'][CHART_AXIS_Y_LEFT][0][] = chart_mixed_axis_range_label(0, max($data));
    foreach ($x_labels as $label) {
      $chart['#mixed_axis_labels'][CHART_AXIS_X_BOTTOM][1][] = chart_mixed_axis_label($label);
    }
    $output = chart_render($chart);
    return $output;

No worries - things have changed a bit since that post above. Namely, we use Google's own naming scheme rather than our own. So instead of "date", you'd use "ga:date". We're trying to reduce the abstraction. To learn more about the fields available to you, visit: http://code.google.com/apis/analytics/docs/gdata/gdataExplorer.html

Development is reaching our v1.0 objectives, and near release, I'll write some documentation and samples to produce a variety of reports.

Yes, please do! In fact, if you figure out a cool report or funky trick while creating your widgets, please message me or post here, and I'll add your idea to the new documentation. I'm excited to see the smart things people do with this code.