R:Google Analytics

Материал Psylab.info - энциклопедии психодиагностики
Версия от 17:38, 15 апреля 2014; Артём Клевцов (обсуждение | вклад) (→‎Получение данных из GA)

Перейти к: навигация, поиск
Creative Commons
указание авторства 		Материал «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. В дальнейшем он не требуется.

КодR

<syntaxhighlight lang="r">> install.packages("devtools") > library(devtools)</syntaxhighlight>

Загрузка пакета доступа к GA, требуется только в начале работы при запуске новой R-сессии:

КодR

<syntaxhighlight lang="r">> install_github("rga", "skardhamar")</syntaxhighlight>

После обновления пакета httr до версии 0.3, функции которого используются в пакете rga, появились сложности и ошибки с выводом данных запроса при использовании нескольких метрик. Поэтому на данный момент использование пакета rga возможно только с установкой предыдущей версии пакета httr (0.2) вручную. Установить пакет httr необходимый версии можно с помощью функции install_url() из пакет devtools, который мы уже загрузили ранее:

КодR

<syntaxhighlight lang="r">> install_url("http://cran.r-project.org/src/contrib/Archive/httr/httr_0.2.tar.gz")</syntaxhighlight>

Организация доступа к API

Подключение пакета доступа к GA

КодR

<syntaxhighlight lang="r">> library(rga)</syntaxhighlight>

Запрет верификации SSL-соединения (требуется только для ОС Windows, чтобы избежать ошибок при аутентификации):

КодR

<syntaxhighlight lang="r">> curl <- getCurlHandle() > options(RCurlOptions = list(capath = system.file("CurlSSL", "cacert.pem", package = "RCurl"), ssl.verifypeer = FALSE))</syntaxhighlight>

Для создания ключа аутентификации потребуется переход в браузер, подтверждение доступа и копирование ключа в консоль. Команда создает отдельный файл, который потом можно использовать для аутентификации без перехода в браузер и т.д.

КодR

<syntaxhighlight lang="r">> rga.open(instance = "ga", where = "ga.rga")</syntaxhighlight>

Видим, что в директории проекта появился файл ga.rga[1].

Второй вариант аутентификации, с созданием собственного клиента API и ключей доступа:

  1. Необходимо создать проект на странице https://console.developers.google.com/project/;
  2. Во вкладке APIs & auth выбрать Analytics API, и там перейти во вкладку Credentials, где выбрать Create new Client ID;
  3. При создании Client ID выбрать Installed application/other, и нажать create;
  4. В результате будет Client ID = и Client secret = ;
  5. На вкладке Consent screen необходимо выбрать рабочий email и дать название приложению (Product name), сохранить;
  6. На общей вкладке APIs & auth/Analytics API/APIs надо активировать API, нажав на кнопку, где написано OFF.

Создаем постоянный ключ (откроется браузер, где надо будет выбрать свой почтовый аккаунт и подтвердить вход в API, тогда выдадут код, который надо будет вставить в консоль):

КодR

<syntaxhighlight lang="r">> rga.open(instance = "ga", + client.id = "", + client.secret = "", + where = "api.rga")</syntaxhighlight>

Пояснения по значениям аргументов:

  • client.id необходимо вставить сюда Client ID;
  • client.secret необходимо вставить сюда Client secret.

Получение данных из GA

Получение списка аккаунтов/сайтов в GA и их ID, ID используется в дальнейших процедурах (для сбора данных):

КодR

<syntaxhighlight lang="r">> ga$getProfiles()</syntaxhighlight>

Задаем временные рамки сбора информации - это необходимо, если запросов предполагается много и по разным параметрам, но по одному временному периоду:

КодR

<syntaxhighlight lang="r">> startdate <- "2014-01-01" > enddate <- "2014-03-31"</syntaxhighlight>

Пример сбора данных по выбранным метрикам и измерениям приведён ниже.

КодR

<syntaxhighlight lang="r">> ga.data <- ga$getData(ids = ID, + start.date = "2014-01-01", end.date = Sys.Date(), + metrics = "ga:pageviews, ga:visits, ga:visitors", + dimensions = "ga:date", + batch = TRUE)</syntaxhighlight>

Пояснения по значениям аргументов:

  • start.date - задает стартовое время в формате "ГГГГ-ММ-ДД"[2];
  • end.date - задает конечное время в формате "ГГГГ-ММ-ДД" (в данном случае используется функция Sys.Date(), которая выводит сегодняшнее число);
  • metrics - определяет показатели (столбцы), которые будут входить в таблицу с данными;
  • dimensions - определяет параметры (строки) таблицы, которые будут входить в таблицу с данными;
  • segment - определяет сегмент, который может накладываться на данные;
  • sort - определяет, по какому из столбцов будет производиться сортировка данных в таблице;
  • filters - определяет фильтры, которые накладываются на данные;
  • batch = TRUE собирает все данные, а не только первые 10000 строк (необходимо, если предполагается, что строк может быть много).

Детальнее по метрикам, сегментам и фильтрам смотреть здесь: https://developers.google.com/analytics/devguides/reporting/core/dimsmets. Внимание, нельзя использовать больше 7 метрик одновременно! Гайд по сегментам здесь: https://developers.google.com/analytics/devguides/reporting/core/v3/segments.

После получения данных мы можем работать с переменной ga.data как с обычной таблицей данных (data.frame).

Примечания

  1. ↑ Можно указать любой удобный путь и имя файла.
  2. ↑ Получить начальную дату сбора статистики в GA следующим образом: ga$getFirstDate(ID).
Источник — «https://psylab.info/index.php?title=R:Google_Analytics&oldid=8381»