README.md

RGA

This package is designed to work with the Google Analytics API V3 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:

1. Authorize this package to access your Google Analytics data with the authorize() function;
2. Determine the profile ID which you want to get access to with the list_profiles() function;
3. Get the anaytics data from the API with one of these functions:
   • get_ga() for the Core Reporting API
   • get_mcf() for the Multi-Channel Funnels Reporting API
   • get_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")