R:Google Analytics — различия между версиями
м (→Организация доступа к API) |
м (→Получение данных из GA) |
||
Строка 68: | Строка 68: | ||
{{r-code|code=<nowiki>> ga.data <- ga$getData(ids = ID, | {{r-code|code=<nowiki>> ga.data <- ga$getData(ids = ID, | ||
+ start.date = ga$getFirstDate(ID), end.date = Sys.Date(), | + start.date = ga$getFirstDate(ID), end.date = Sys.Date(), | ||
− | + metrics = "ga:pageviews, ga: | + | + metrics = "ga:pageviews, ga:sessions, ga:users", |
+ dimensions = "ga:date", | + dimensions = "ga:date", | ||
+ batch = TRUE)</nowiki>}} | + batch = TRUE)</nowiki>}} | ||
Строка 95: | Строка 95: | ||
{{r-code|code=<nowiki>> head(ga.data) | {{r-code|code=<nowiki>> head(ga.data) | ||
− | date pageviews | + | date pageviews sessions users |
− | 1 2014- | + | 1 2014-04-01 14742 6073 4845 |
− | 2 2014- | + | 2 2014-04-02 15643 6207 4858 |
− | 3 2014- | + | 3 2014-04-03 15241 6046 4726 |
− | 4 2014- | + | 4 2014-04-04 12660 5022 3978 |
− | 5 2014- | + | 5 2014-04-05 9117 3683 2903 |
− | 6 2014- | + | 6 2014-04-06 11390 4492 3465</nowiki>}} |
Структура таблицы имеют следующий вид: | Структура таблицы имеют следующий вид: | ||
{{r-code|code=<nowiki>> str(ga.data) | {{r-code|code=<nowiki>> str(ga.data) | ||
− | 'data.frame': | + | 'data.frame': 49 obs. of 4 variables: |
− | $ date : Date, format: "2014- | + | $ date : Date, format: "2014-04-01" "2014-04-02" "2014-04-03" "2014-04-04" ... |
− | $ pageviews: num | + | $ pageviews: num 14742 15643 15241 12660 9117 ... |
− | $ | + | $ sessions : num 6073 6207 6046 5022 3683 ... |
− | $ | + | $ users : num 4845 4858 4726 3978 2903 ...</nowiki>}} |
== Примечания == | == Примечания == |
Версия 23:28, 19 апреля 2014
|
Материал «R:Google Analytics», созданный авторами Филипп Управителев и Артём Клевцов, публикуется на условиях лицензии Creative Commons «Attribution» («Атрибуция») 4.0 Всемирная. | |
|
Перед использованием функций из пакетов их необходимо предварительно установить и загрузить: КодR <syntaxhighlight lang="r">> install.packages(pkgs = "pkgname") > library(package = "pkgname")</syntaxhighlight> |
Содержание
Общее описание
Пакетов для работы с API Google Analytics несколько, наиболее часто упоминающиеся - rga
и RGoogleAnalytics
. В принципе, они различаются незначительно - в процедуре аутентификации и организации доступа к API. Пакет rga
выглядит более удобным для работы, так как ключ для аутентификации создается один раз, и потом только загружается, в то время как при работе с пакетом RGoogleAnalytics
приходится в начале каждой сессии проходить аутентификацию в браузере. К тому же, пакет rga
обладает более прозрачной логикой запросов к API.
Установка необходимых пакетов
Устанавливаем и подключаем пакет devtools
, для доступа к github, требуется только в первый раз, для установки пакетов rga
. В дальнейшем он не требуется.
<syntaxhighlight lang="r">> install.packages("devtools") > library(devtools)</syntaxhighlight>
Загрузка пакета доступа к GA, требуется только в начале работы при запуске новой R-сессии:
<syntaxhighlight lang="r">> install_github("rga", "skardhamar")</syntaxhighlight>
После обновления пакета httr
до версии 0.3, функции которого используются в пакете rga
, появились ошибки с выводом данных запроса при использовании нескольких метрик. Поэтому на данный момент использование пакета rga
возможно только с установкой предыдущей версии пакета httr
(0.2) вручную. Установить пакет httr
необходимый версии можно с помощью функции install_url()
из пакет devtools
, который мы уже загрузили ранее:
<syntaxhighlight lang="r">> install_url("http://cran.r-project.org/src/contrib/Archive/httr/httr_0.2.tar.gz")</syntaxhighlight>
Организация доступа к API
Подключение пакета доступа к GA
<syntaxhighlight lang="r">> library(rga)</syntaxhighlight>
Запрет верификации SSL-соединения (требуется только для ОС Windows, чтобы избежать ошибок при аутентификации):
<syntaxhighlight lang="r">> options(RCurlOptions = list(capath = system.file("CurlSSL", "cacert.pem", package = "RCurl"), ssl.verifypeer = FALSE))</syntaxhighlight>
Для создания ключа аутентификации потребуется переход в браузер, подтверждение доступа и копирование ключа в консоль. Опционально команда создает отдельный файл, который потом можно использовать для аутентификации без перехода в браузер и т.д.
<syntaxhighlight lang="r">> rga.open(instance = "ga", where = "ga.rga")</syntaxhighlight>
Видим, что в директории проекта появился файл ga.rga
[1]. Теперь при повторном использовании этой команды будет осуществляться проверка наличия файла ga.rga
в рабочей директории и, если такой файл будет найден, то данные для аутентификации будут взяты из данного файла.
Второй вариант аутентификации с созданием собственного клиента API и ключей доступа:
- Необходимо создать проект на странице https://console.developers.google.com/project;
- Во вкладке APIs & auth выбрать Analytics API, и там перейти во вкладку Credentials, где выбрать Create new Client ID;
- При создании Client ID выбрать Installed application/other, и нажать create;
- В результате будет Client ID = и Client secret = ;
- На вкладке Consent screen необходимо выбрать рабочий email и дать название приложению (Product name), сохранить;
- На общей вкладке APIs & auth/Analytics API/APIs надо активировать API, нажав на кнопку, где написано OFF.
Создаем постоянный ключ (откроется браузер, где надо будет выбрать свой почтовый аккаунт и подтвердить вход в API, тогда выдадут код, который надо будет вставить в консоль):
<syntaxhighlight lang="r">> rga.open(instance = "ga", client.id = "", client.secret = "", where = "api.rga")</syntaxhighlight>
Пояснения по значениям аргументов:
-
client.id
необходимо вставить сюда Client ID; -
client.secret
необходимо вставить сюда Client secret.
После успешной аутентификации информацию о установленном подключении можно получит с помощью команды a$status()
или более подробную информацию ga$.self
.
Получение данных из GA
Получение списка аккаунтов/сайтов в GA и их ID, которые используется для сбора данных:
<syntaxhighlight lang="r">> ga$getProfiles()</syntaxhighlight>
Пример сбора данных по выбранным метрикам и измерениям приведён ниже.
<syntaxhighlight lang="r">> ga.data <- ga$getData(ids = ID, + start.date = ga$getFirstDate(ID), end.date = Sys.Date(), + metrics = "ga:pageviews, ga:sessions, ga:users", + dimensions = "ga:date", + batch = TRUE)</syntaxhighlight>
Пояснения по значениям аргументов:
-
ids
- номер профиля, из которого нужно выгрузить данные; -
start.date
- задает стартовое время в формате, указанном с помощью аргументаdate.format
(по умолчаниюformat(Sys.time(), "%Y-%m-%d")
)[2]; -
end.date
- задает конечное время в формате, указанном с помощью аргументаdate.format
(по умолчаниюformat(Sys.time(), "%Y-%m-%d")
)[3]; -
metrics
- определяет показатели (столбцы), которые будут входить в таблицу с данными (по умолчанию"ga:visits"
)[4]; -
dimensions
- определяет параметры (строки) таблицы, которые будут входить в таблицу с данными; -
segment
- определяет сегмент данных (как правило, страницы/разделы сайта); -
sort
- определяет, по какому из столбцов будет производиться сортировка данных в таблице; -
filters
- определяет фильтры, которые накладываются на данные (в определенной мере аналог сегментов); -
batch = TRUE
собирает все данные, а не только первые 10000 строк (необходимо, если предполагается, что строк может быть много).
Аргументы ids
, start.date
, end.date
и metrics
являются обязательными для запроса к GA API.
Детальную информацию можно найти на соответствующих страницах справочного руководства по GA API:
- по параметрам запроса к API: https://developers.google.com/analytics/devguides/reporting/core/v3/reference#q_summary
- по метрикам и измерениям: https://developers.google.com/analytics/devguides/reporting/core/dimsmets
- по сегментам: https://developers.google.com/analytics/devguides/reporting/core/v3/segments.
После получения данных мы можем работать с переменной ga.data
как с обычной таблицей данных (data.frame
). Таблица данных, полученных на предыдущем этапе выглядит следующим образом (значения взяты произвольно):
<syntaxhighlight lang="r">> head(ga.data) date pageviews sessions users 1 2014-04-01 14742 6073 4845 2 2014-04-02 15643 6207 4858 3 2014-04-03 15241 6046 4726 4 2014-04-04 12660 5022 3978 5 2014-04-05 9117 3683 2903 6 2014-04-06 11390 4492 3465</syntaxhighlight>
Структура таблицы имеют следующий вид:
<syntaxhighlight lang="r">> str(ga.data) 'data.frame': 49 obs. of 4 variables: $ date : Date, format: "2014-04-01" "2014-04-02" "2014-04-03" "2014-04-04" ... $ pageviews: num 14742 15643 15241 12660 9117 ... $ sessions : num 6073 6207 6046 5022 3683 ... $ users : num 4845 4858 4726 3978 2903 ...</syntaxhighlight>
Примечания
- ↑ Можно указать любой удобный путь и имя файла.
- ↑ Получить начальную дату сбора статистики в GA можно с помощью команды
ga$getFirstDate(ID)
. - ↑ В данном случае используется функция
Sys.Date()
, которая выводит текущую дату. - ↑ Внимание, нельзя использовать больше 7 метрик одновременно!
Ссылки
- R Google Analytics: An easy API connector to Google Analytics in R - http://skardhamar.github.io/rga/
- r-google-analytics: Google Analytics For The R Statistical Programming Language - https://code.google.com/p/r-google-analytics/
- Google Analytics: Dimensions & Metrics Reference - https://developers.google.com/analytics/devguides/reporting/core/dimsmets
- Google Analytics Query Explorer 2 - https://ga-dev-tools.appspot.com/explorer/?csw=1
- Google Analytics: Core Reporting API - Segments - https://developers.google.com/analytics/devguides/reporting/core/v3/segments