Skip to content

Latest commit

 

History

History
75 lines (58 loc) · 1.92 KB

README.md

File metadata and controls

75 lines (58 loc) · 1.92 KB

Legato

Legato provides query access through the official Google Analytics Reporting API v4

Installation

Available in Hex, the package can be installed as:

  1. Add legato to your list of dependencies in mix.exs:
```elixir
def deps do
  [{:legato, "~> 0.2.0"}]
end
```
  1. Ensure legato is started before your application:
```elixir
def application do
  [applications: [:legato]]
end
```

Get an oauth access token from Google

"Authorization: Bearer token_here"

HTTPoison.post "https://analyticsreporting.googleapis.com/v4/reports:batchGet", "{}", [{"Authorization", "Bearer token_here"}]

  • Collect data into Query struct
  • Convert query into Request JSON, encode with Poison
  • Send request to GA
  • Decode response
  • Parse data into struct
  • support metric expression strings
  • add filters to Query
  • add date ranges to Query
  • add order by to Query
  • add segment_id to Query
  • add Sampling
  • put report struct into named struct
  • add segments to Query (long goal)
profile = %Legato.Profile{access_token: oauth2_access_token, view_id: view_id}
defmodule ExitReport do
  defstruct :exits, :pageviews, :country
end
import Legato.Query

alias Legato.Request
alias Legato.Report

profile |>
  metrics([:exits, :pageviews]) |>
  dimensions([:country]) |>
  filter(:exits, :gt, 10) |>
  between(start_date, end_date) |> # first date range for the query
  between(another_start_date, another_end_date) |> # adds subsequent date ranges
  order_by(:pageviews, :descending) |>
  segment(-3) |>
  sampling(:small) |>
Request.all |>
Report.as(ExitReport)

If you'd like to use relative dates, I suggest trying timex. segment with an integer will clear any segments, cannot be mixed with dynamic segments.