RGA
This package is designed to work with the API Google Analytics in R.
Key features:
- OAuth 2.0 authorization;
- Auto refresh an expired OAuth access token;
- Access to all the accounts which the user has access to;
- API responses is converted directly into R objects;
- Access to the following Google Analytics APIs:
- Management API: access to configuration data for accounts, web properties, views (profiles), goals and segments;
- Core Reporting API: query for dimensions and metrics to produce customized reports;
- Multi-Channel Funnels Reporting API: query the traffic source paths that lead to a user's goal conversion;
- Real Time Reporting API: report on activity occurring on your property at the moment;
- Metadata API: access the list of API dimensions and metrics and their attributes;
- Auto-pagination to return more than 10,000 rows of the results by combining multiple data requests;
- Split the query by date ranges to avoid a sampling data;
- Shiny app to explore all the dimensions and metrics available through the Core Reporting API.
Installation
To install the latest release version from CRAN with:
install.packages("RGA")
To install the development version the install_github()
function from devtools
package can be used:
devtools::install_github("artemklevtsov/RGA")
Another method to install the package RGA
(using the command line):
git clone https://github.com/artemklevtsov/RGA.git
R CMD build RGA
R CMD INSTALL RGA_*.tar.gz
Usage
Once you have the package loaded, there are 3 steps you need to use to get data from Google Analytics:
- Authorize this package to access your Google Analytics data with the
authorize()
function; - Determine the profile ID which you want to get access to with the
list_profiles()
function; - Get the anaytics data from the API with one of these functions:
get_ga()
for the Core Reporting APIget_mcf()
for the Multi-Channel Funnels Reporting APIget_realtime()
for the Real Time Reporting API
For details about this steps please type into R:
library(help = "RGA")
browseVignettes(package = "RGA")
Bug reports
First check the changes in the latest version of the package. Type type into R:
news(package = "RGA", Version == packageVersion("RGA"))
Try reproduce a bug with the latest development version from Git.
Before posting a bug please try execute your code with the httr::with_verbose()
wrapper. It will be useful if you attach verbose output to the bug report.
httr::with_verbose(list_profiles())
httr::with_verbose(get_ga("XXXXXXXX"))
Post the traceback()
and sessionInfo()
output also may be helpful.
To report a bug please type into R:
utils::bug.report(package = "RGA")