Изменения

На данный момент , несмотря на все многообразие, в официальном репозитории CRAN нет пакетов для работы с API Google Analytics <ref>Возможно в скором времени там появится, по крайней, мере два пакета: <code>rga</code> и <code>ganalytics</code>.</ref>Однако на сторонних ресурсах, тем не менее, но в сети можно обнаружить три рабочих решения: [https://code.google.com/p/r-google-analytics/ <code>RGoogleAnalytics</code>], [http://skardhamar.github.io/rga/ <code>rga</code>] и , [https://github.com/jdeboer/ganalytics <code>ganalytics</code>]и [https://bitbucket.org/unikum/rga RGA]. <ref>Пакеты <code>rga</code>, <code>ganalytics</code> и <code>RGA</code> в ближайшее время могут появиться и в CRAN, работы в этом направлении уже ведутся.</ref>

Сравнительная таблицапактов для работы с API Google Analytics:

! colspan=4 5 | Общая информация

| style="text-align:center" | 251.0506.2014<ref>Дата последнего коммита последней правки на данный момент, т.к. стабильные выпуски релизы данного пакета отсутствуют.</ref>| style="text-align:center" | 244.0508.2014<ref>Дата последнего коммита последней правки на данный момент, т.к. стабильные выпуски релизы данного пакета отсутствуют.</ref>| style="text-align:center" | 5.08.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>

| style="text-align:center" | GPLGPL2

| style="text-align:center" | <code>bitopsRCurl</code>, <code>RCurlhttr</code>, <code>jsonlite</code>, <code>lubridate</code>, | style="text-align:center" | <code>httr</code>, <code>plyr</code>, <code>stringr</code>, <code>jsonlite</code>, <code>httpuv</code>| style="text-align:center" | <code>httrRCurl</code>, <code>plyrhttr</code>, <code>stringrjsonlite</code>

! colspan=4 5 | Авторизация

| Авторизация [https://developers.google.com/accounts/docs/OAuth2OAuth2]<ref>Авторизация по Client ID и Client secret, полученным в [[API Consolehttpshttps://console.developers.google.com|API Console]].</ref>| style="text-align:center" | +

! colspan=4 5 | Доступ к API

| Доступ к [https://developers.google.com/analytics/devguides/reporting/core/v3/ API базовых отчётов]| style="text-align:center" | +

| Доступ к APIотчётов[https://developers.google.com/analytics/devguides/reporting/mcf/v3/ API отчётов<br />многоканальных последовательностей]

| Доступ к API<br [https:/>/developers.google.com/analytics/devguides/config/mgmt/v3/ API конфигурации]<ref>Информация по аккаунтам, профилям, представлениям, сегментам и целям.</ref>

С точки зрения внутренней Помимо технических различий пакеты различаются еще рядом параметров, в частности методологией организации кода пакеты можно охарактеризовать следующим образом. <code>RGoogleAnalytics</code> основан на использовании простых функции и S3-методов, но по внутренней организации похож на RC<ref>RC - Reference classes.</ref>. <code>rga</code> целиком основан на использовании RC. <code>ganalytics</code> основан на использовании S4 классов документированностью функций, общей дружелюбностью и методов. Получить обобщённое представление об ООП системе простотой в R можно в [http://adv-r.had.co.nz/OO-essentials.html#rc этом] материале. Отметим, что все пакеты основываются на использовании пакета <code>httr</code>.

В плане подробности документацииТак, бесспорно, выигрывает пакет <code>ganalyticsRGoogleAnalytics</code>основан на использовании простых функции и S3-методов, но по внутренней организации похож на RC (Reference classes). Он обладает довольно подробным Пакет <code>READMErga</code> файлом, описывающим практически всю функциональность пакета. Помимо этого, пакет также содержит полную документацию всех функций, которая поставляется вместе с пакетомцеликом основан на использовании RC. Пакет <code>rgaganalytics</code> обладает основан на использовании S4 классов и методов, что обеспечивает более точный контроль над вводимыми аргументами <coderef>READMEПолучить обобщённое представление об принципах и реализации ООП в R можно [http://adv-r.had.co.nz/OO-essentials.html#rc здесь]</coderef> файлом. При определенных различиях в реализации доступа к GA API, описывающем лишь основы работы с пакетом и все пакеты, тем не включает в себя описание ряда возможностей пакета. При установке пакета документация содержит только краткое описание инициализации пакета. Документация менее, основываются на функционале пакета <code>RGoogleAnalyticshttr</code> включает файл README, в котором пошагово описан процесс работы с пакетом, включающим весь функционал.

Таким образом, основным источником В плане подробности документации для рассматриваемых пакетов являются файлы RESDME, размещённые бесспорно, выигрывает пакет <code>ganalytics</code>. Он обладает довольно подробным <code>README</code> файлом, расположенном на сайтах разработчиковстранице проекта [https://github.com/jdeboer/ganalytics ganalytics], и описывающим практически весь функционал пакета. Помимо этого, пакет также содержит полную документацию всех функций, которая поставляется вместе с пакетом. Пакет <code>rga</code> обладает <code>README</code> файлом, описывающем лишь основы работы с пакетом и не включает в себя описание ряда возможностей пакета. Справка по функциям, доступная при установке пакета, содержит только краткое описание процедуры получения доступа к GA API и описание структуры запроса к API. Другие полезные функции, в частности, получение списка доступных профилей GA-аккаунта, приходится искать вслепую. Документация пакета <code>RGoogleAnalytics</code> также имеет файл <code>README</code>, в котором пошагово описан процесс работы с пакетом, включающим весь функционал.

Устанавливаем и подключаем пакет {{r-package|devtools}}, == Получение ключей для доступа к [https://github.com/ github] (требуется только в первый раз, для установки пакета {{r-package|rga}}):API Google Analytics ==

{{r-code|code=<nowiki>> installПрежде чем приступить к работе с пакетами, предназначенными для работы с Google Analytics API, необходимо создать новое приложение в [https://console.packagesdevelopers.google.com Google Developers Console] и получить '''Client ID''' ("devtools"идентификатор клиента)> libraryи '''Client secret''' (devtoolsсекретный ключ клиента)для доступа к API Google Analytics. Не смотря на то, что некоторые пакеты, например <code>rga</nowikicode>}}, предоставляют ключи доступа, сгенерированные автором пакета, мы всё же рекомендуем получить собственные ключи, т.к. сторонние ключи могут быть в любой момент отозваны автором.

Устанавливаем пакет <code>rga</code>Пошаговая инструкция приведена ниже:

{{r-code|code=<nowiki>> install_github# Создание нового проекта ("rga"можно пропустить, "skardhamar"если проект уже создан)<:#* Откройте страницу https:/nowiki>}}/console.developers.google.com/project;#* В левой верхней части страницы нажмите на красную кнопку с надписью '''Create Project''';#* Во всплывающем окне в поле '''PROJECT NAME''' введите название проекта;#* Подтвердите создание проекта, нажав на кнопку '''Create'''.# Активация доступа к API Google Analytics:#* Выберите проект в списке проектов на странице https://console.developers.google.com/project;#* На боковой панели слева выберите пункт '''APIs & auth''';#* на вкладке '''APIs''' активируйте '''Analytics API''', нажав на кнопку с надписью `OFF` (убедитесь, что вместо надписи `OFF` появилось `ON`).# Создание нового приложения:#* В боковой панели слева выберите пункт '''APIs & auth''', подпункт '''Credentials''';#* В левой части страницы нажмите на кнопку с надписью '''Create new Client ID''';#* Во всплывающем окне выберите пункт '''Installed application''' в списке '''APPLICATION TYPE''' и пункт '''Other''' в списке '''INSTALLED APPLICATION TYPE'''.#* Подтвердите создание приложения, нажав на кнопку с надписью '''Create Client ID'''.# Получение Client ID и Client secret:#* Выберите проект в списке проектов на странице https://console.developers.google.com/project;#* В боковой панели слева выберите пункт '''APIs & auth''', подпункт '''Credentials''';#* В таблице с названием '''Client ID for native application''' скопируйте значения полей '''Client ID''' и '''Client secret'''.

{{r-code|code=<nowiki>> library(rga)</nowiki>}}== Установка пакета ===

Запрет верификации SSL-соединения (требуется только для ОС WindowsИсходный код пакета <code>rga</code> располагается на [https://github.com github], чтобы избежать ошибок при аутентификации)поэтому установить его можно с помощью функции <code>install_github</code> из пакета {{r-package|devtools}}:

{{r-code|code=<nowiki>> options(RCurlOptions = list(capath = system.filedevtools::install_github("CurlSSLrga", "cacert.pemskardhamar", package = "RCurl"), ssl.verifypeer = FALSE))</nowiki>}}

{{r-Перед началом работы необходимо загрузить пакет <code|code=<nowiki>> rga.open(instance = "ga", where = "ga.rga")</nowikicode>}}(требуется только в начале работы при запуске новой R-сессии):

Видим, что в директории проекта появился файл <{{r-code>ga.rga</|code>=<refnowiki>Можно указать любой удобный путь и имя файла.</ref>. Теперь при повторном использовании этой команды будет осуществляться проверка наличия файла <code>ga.library(rga)</codenowiki> в рабочей директории и, если такой файл будет найден, то данные для аутентификации будут взяты из данного файла.}}

Второй вариант аутентификации с созданием собственного клиента API и ключей Для предоставления доступак данным Google Analytics API из пакета <code>rga</code> неободимо пройти процедуру авторизации. Для этого используется функция <code>rga.open</code>, которая принимает следующие аргументы:

# Необходимо создать проект на странице https:* <code>instance<//console.developers.google.com/projectcode> - имя переменной, которая будет содержать информацию о доступе к APi Google Analytics;# На вкладке APIs & auth на вкладке APIs надо активировать Analytics API, нажав на кнопку, где написано * <code>OFFwhere</code>.# Во вкладке APIs & auth перейти во вкладку Credentials- путь и/или имя файла, где выбрать Create new Client IDкоторый будет использоваться для кэширования информации;# При создании Client * <code>client.id</code> - ID выбрать APPLICATION TYPE: Installed application, INSTALLED APPLICATION TYPE: other, и нажать createклиента;# В результате будет Client ID = и Client * <code>client.secret = ;# На вкладке Consent screen необходимо выбрать рабочий email и дать название приложению (Product name), сохранить;</code> - секретный ключ.

Создаем постоянный ключ (откроется Для получения токена доступа потребуется переход в браузер, где надо будет выбрать свой почтовый аккаунт подтверждение доступа и подтвердить вход копирование код доступа в API, тогда выдадут кодконсоль. Опционально команда создает отдельный файл, который надо будет вставить потом можно использовать для аутентификации без перехода в консоль):браузер<ref>Аргумент <code>where</code> с указанием пути и имени файла.</ref>.

{{r-code|code=<nowiki>> rga.open(instance = "ga", client.id = "", client.secret = "", where = "apiga.rga")</nowiki>}}

* <Второй вариант аутентификации с использованием собственных ключей доступа: {{r-code|code=<nowiki>> rga.open(instance = "ga", client.id</code> необходимо вставить сюда Client ID;* <code>= "XXXXXX", client.secret= "XXXXXXX", where = "ga.rga")</codenowiki> необходимо вставить сюда Client secret}} После выполнения данной команды будет открыт интернет браузер со страницей запроса подтверждения разрешения на доступ к данным Google Analytics. Необходимо авторизоваться под своей учётной записью Google и подтвердить разрешение на доступ к данным Google Analytics. Отметим, что пакет `RGA` запрашивает доступ '''только для чтения''' данных.

# Элемент нумерованного списка=== Получение данных === Пакет <code>rga</code> позволяет получить доступ к различным API Google Analytics. Поскольку объекты, формируемые пакетом <code>rga</code>, относятся к классу <code>refClass</code>, что не является широко распространённой системой в данный момент, то ниже мы проведём небольшой обзор доступных функций и методов.

Получить общую информацию о классе <code>rga</code> можно с помощью функции <code>getRefClass()</code>:

Наиболее полезными являются:

Получить справку по тому или иному мтеоду методу можно с помощью команды <code>rga$help(topic)</code>, где вместо <code>topic</code> нужно подставить название интересующего метода:

* <code>ids</code> - номер ID профиля, из которого нужно выгрузить данные;* <code>start.date</code> - символьная строка, которая задаёт стартовое время в формате <code>%YYYYY-%mMM-%dDD</code><ref>Получить начальную дату сбора статистики в GA можно с помощью команды <code> ga$getFirstDate(id)</code>.</ref>. Допускаются также значения "today", "yesterday", "ndaysAgo", где <code>n</code> - это количество дней;* <code>end.date</code> - символьная строка, которая задаёт конечное время в формате <code>%YYYYY-%mMM-%dDD</code><ref>В данном случае используется функция <code>Sys.Date()</code>, которая выводит текущую дату.</ref>. Допускаются также значения "today", "yesterday", "ndaysAgo", где <code>n</code> - это количество дней;

Аргументы <code>ids</code>, <code>start.date</code>, <code>end.date</code> и <code>metrics</code> являются обязательными для запроса к GA Google Analytics API. Прм этом функция <code>getData()</code> требует только <code>id</code> профиля, т.к. остальные аргументы имеют значения по умолчанию. Все аргументы метода <code>getData</code>, а также значения по умолчанию , можно посмотреть с помощью команды <code>args(ga$getData)</code>.

Получить доступ к API GA Google Analytics можно также с помощью веб-сервисов Google по следующей ссылке: https://developers.google.com/apis-explorer/?hl=ru#p/analytics/v3/. Для получения данных необходимо авторизоваться и задать требуемые параметры для запроса к API.

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

'data.frame': 34 obs. of 4 variables: