gem 'gattica', :git => 'git://github.com/chrisle/gattica.git'

$ bundle install

# Include the gem
require 'gattica'

# Login
ga = Gattica.new({ 
    :email => '[email protected]', 
    :password => 'password'
})

# Get a list of accounts
accounts = ga.accounts

# Choose the first account
ga.profile_id = accounts.first.profile_id

# Get the data
data = ga.get({ 
    :start_date   => '2011-01-01',
    :end_date     => '2011-04-01',
    :dimensions   => ['month', 'year'],
    :metrics      => ['visits', 'bounces'],
})

# Show the data
puts data.inspect

ga = Gattica.new({ :email => '[email protected]', :password => 'password' })
puts ga.token   # => returns a big alpha-numeric string

# Retrieve a list of accounts
accounts = ga.accounts

# Show information about accounts
puts "---------------------------------"
puts "Available profiles: " + accounts.count.to_s
accounts.each do |account|
  puts "   --> " + account.title
  puts "   last updated: " + account.updated.inspect
  puts "   web property: " + account.web_property_id
  puts "     profile id: " + account.profile_id.inspect
  puts "          goals: " + account.goals.count.inspect
end

# Tell Gattica to query profile ID 5555555
ga.profile_id = 5555555 

# Get the number of visitors by month from Jan 1st to April 1st.
data = ga.get({ 
    :start_date   => '2011-01-01',
    :end_date     => '2011-04-01',
    :dimensions   => ['month', 'year'],
    :metrics      => ['visitors']
})

# Sorting by number of visits in descending order (most visits at the top)
data = ga.get({ 
    :start_date   => '2011-01-01',
    :end_date     => '2011-04-01',
    :dimensions   => ['month', 'year'],
    :metrics      => ['visits'],
    :sort         => ['-visits']
})

# Limit the number of results to 25.
data = ga.get({ 
    :start_date   => '2011-01-01',
    :end_date     => '2011-04-01',
    :dimensions   => ['month', 'year'],
    :metrics      => ['visits'],
    :max_results  => 25 
})

my_hash = data.to_h['points']

# => 
#   [{
#     "xml"         => "<entry gd:etag=\"W/&quot;....  </entry>", 
#     "id"          => "http://www.google.com/analytics/feeds/data?...", 
#     "updated"     => Thu, 31 Mar 2011 17:00:00 -0700, 
#     "title"       => "ga:month=01 | ga:year=2011", 
#     "dimensions"  => [{:month=>"01"}, {:year=>"2011"}], 
#     "metrics"     => [{:visitors=>6}]
#   },
#   {
#     "xml"         => ...
#     "id"          => ...
#     "updated"     => ...
#     ...
#   }]

# Return data as a json string. (Useful for NoSQL databases)
my_json = data.to_h['points'].to_json

# => 
#   "[{
#       \"xml\":\"<entry> .... </entry>\",
#       \"id\":\"http://www.google.com/analytics/feeds/data? ...",
#       \"updated\":\"2011-03-31T17:00:00-07:00\",
#       \"title\":\"ga:month=01 | ga:year=2011\",
#       \"dimensions\":[{\"month\":\"01\"},{\"year\":\"2011\"}],
#       \"metrics\":[{\"visitors\":6}]
#     },
#     { 
#       \"xml\":\"<entry> .... </entry>\",
#       \"id\":\"http://www.google.com/analytics/feeds/data? ...",
#       ...
#   }]"

# Return the data in CSV format.  (Useful for using in Excel.)

# Short CSV will only return your dimensions and metrics:
short_csv = data.to_csv(:short)   

# => "month,year,visitors\n\n01,2011, ...."

# Long CSV will get you a few additional columns:
long_csv = data.to_csv            

# => "id,updated,title,month,year,visitors\n\nhttp:// ..."

# You can work directly with the 'point' method to return data.
data.points.each do |data_point|
  month = data_point.dimensions.detect { |dim| dim.key == :month }.value
  year = data_point.dimensions.detect { |dim| dim.key == :year }.value
  visitors = data_point.metrics.detect { |metric| metric.key == :visitors }.value
  puts "#{month}/#{year} got #{visitors} visitors"
end

# => 
#   01/2011 got 34552 visitors
#   02/2011 got 36732 visitors
#   03/2011 got 45642 visitors
#   04/2011 got 44456 visitors

# Get all the profiles that have goals
profiles_with_goals = accounts.select { |account| account.goals.count > 0 }

# => 
#   [{
#     "id"                => "http://www.google.com/analytics/feeds/accounts/ga:...",
#     "updated"           => Mon, 16 May 2011 16:40:30 -0700, 
#     "title"             => "Profile Title", 
#     "table_id"          => "ga:123456", 
#     "account_id"        => 123456, 
#     "account_name"      => "Account name", 
#     "profile_id"        =>  123456, 
#     "web_property_id"   => "UA-123456-3", 
#     "goals"=>[{
#         :active   => "true", 
#         :name     => "Goal name", 
#         :number   => 1, 
#         :value    => 0.0
#     }]
#   }, 
#   {
#     "id"                => "http://www.google.com/analytics/feeds/accounts/ga:...",
#     "updated"           => Mon, 16 May 2011 16:40:30 -0700, 
#     "title"             => "Profile Title", 
#     ...
#   }]

# Get all the segments that are available to you
segments = ga.segments

# Segments with negative gaid are default segments from Google. Segments
# with positive gaid numbers are custom segments that you created.
# =>
#   [{
#     "id"          => "gaid::-1", 
#     "name"        => "All Visits", 
#     "definition"  => " "
#   }, 
#   {
#     "id"          => "gaid::-2", 
#     "name"        => "New Visitors", 
#     "definition"  => "ga:visitorType==New Visitor"
#   }, 
#   {
#     "id"          => ... # more default segments
#     "name"        => ...
#     "definition"  => ...
#   },
#   {
#     "id"          => "gaid::12345678", 
#     "name"        => "Name of segment", 
#     "definition"  => "ga:keyword=...."
#   }, 
#   {
#     "id"          => ... # more custom segments
#     "name"        => ...
#     "definition"  => ...
#   }]

# Return visits and bounces for mobile traffic 
# (Google's default user segment gaid::-11)

mobile_traffic = ga.get({ 
  :start_date   => '2011-01-01', 
  :end_date     => '2011-02-01', 
  :dimensions   => ['month', 'year'],
  :metrics      => ['visits', 'bounces'],
  :segment      => 'gaid::-11'
})

# Filter by Firefox users
firefox_users = ga.get({
  :start_date   => '2010-01-01', 
  :end_date     => '2011-01-01',
  :dimensions   => ['month', 'year'],
  :metrics      => ['visits', 'bounces'],
  :filters      => ['browser == Firefox']
})

# Filter where visits is >= 10000
lots_of_visits = ga.get({
  :start_date   => '2010-01-01', 
  :end_date     => '2011-02-01',
  :dimensions   => ['month', 'year'],
  :metrics      => ['visits', 'bounces'],
  :filters      => ['visits >= 10000']
})

# Firefox users and visits >= 10000
firefox_users_with_many_pageviews = ga.get({
  :start_date   => '2010-01-01', 
  :end_date     => '2011-02-01',
  :dimensions   => ['month', 'year'],
  :metrics      => ['visits', 'bounces'],
  :filters      => ['browser == Firefox', 'visits >= 10000']
})

# Get the top 25 keywords that drove traffic
data = ga.get({ 
  :start_date => '2011-01-01',
  :end_date => '2011-04-01',
  :dimensions => ['keyword'],
  :metrics => ['visits'],
  :sort => ['-visits'],
  :max_results => 25 
})

# Output our results
data.points.each do |data_point|
  kw = data_point.dimensions.detect { |dim| dim.key == :keyword }.value
  visits = data_point.metrics.detect { |metric| metric.key == :visits }.value
  puts "#{visits} visits => '#{kw}'"
end

# =>
#   19667 visits => '(not set)'
#   1677 visits => 'keyword 1'
#   178 visits => 'keyword 2'
#   165 visits => 'keyword 3'
#   161 visits => 'keyword 4'
#   112 visits => 'keyword 5'
#   105 visits => 'seo company reviews'
#   ...

ga = Gattica.new({ 
    :email => '[email protected]', 
    :password => 'password',
    :timeout => 600  # Set timeout for 10 minutes!
})

my_token = ga.token # => 'DSasdf94...'

# Sometime later, you can initialize Gattica with the same token
ga = Gattica.new({ :token => my_token })

ga = Gattica.new({
    :token => 'DSasdf94...', 
    :headers => {'My-Special-Header':'my_custom_value'}
})

ga = Gattica.new({ 
    :email => '[email protected]', 
    :password => 'password',
    :http_proxy => { :host => 'proxy.example.com', :port => 8080, :user => 'username', :password => 'password' }
})