Skip to content
This repository has been archived by the owner on Mar 23, 2021. It is now read-only.

artemklevtsov/RGA

Repository files navigation

RGA

Travis-CI Build Status CRAN_Status_Badge

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:
  • 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")