R:Google Analytics - История изменений

Артём Клевцов: /* Общее описание */

2014-08-06T08:27:17Z

‎Общее описание

Артём Клевцов: /* Общее описание */

2014-08-06T08:15:29Z

‎Общее описание

Артём Клевцов: /* Общее описание */

2014-08-06T08:12:54Z

‎Общее описание

Артём Клевцов: /* Общее описание */

2014-08-06T08:11:18Z

‎Общее описание

Артём Клевцов: /* Общее описание */

2014-08-06T08:10:52Z

‎Общее описание

Артём Клевцов: /* Организация доступа к API */

2014-07-01T17:23:53Z

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

Артём Клевцов: /* Установка необходимых пакетов */

2014-07-01T17:13:10Z

‎Установка необходимых пакетов

Артём Клевцов в 16:45, 1 июля 2014

2014-07-01T16:45:00Z

Артём Клевцов: /* Получение данных */

2014-06-22T18:42:23Z

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

Артём Клевцов: /* Получение данных */

2014-06-22T18:38:35Z

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

@@ Строка 44: / Строка 44: @@
 | Зависимости
 | style="text-align:center" | <code>RCurl</code>, <code>rjson</code>, <code>lubridate</code>
-| style="text-align:center" | <code>RCurl</code>, <code>jsonlite</code>, <code>lubridate</code>, <code>httr</code>
+| style="text-align:center" | <code>RCurl</code>, <code>httr</code>, <code>jsonlite</code>, <code>lubridate</code>
-| style="text-align:center" | <code>httr</code>, <code>plyr</code>, <code>stringr</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>RCurl</code>, <code>httr</code>, <code>jsonlite</code>
 |-

@@ Строка 5: / Строка 5: @@
 == Общее описание ==
-На данный момент, несмотря на все многообразие, в официальном репозитории CRAN нет пакетов для работы с API Google Analytics. Однако на сторонних ресурсах, тем не менее, можно обнаружить три рабочих решения: [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>]. <ref>Пакеты <code>rga</code> и <code>ganalytics</code> в ближайшее время могут появиться и в CRAN, работы в этом направлении уже ведутся.</ref>
+На данный момент, несмотря на все многообразие, в официальном репозитории CRAN нет пакетов для работы с API Google Analytics. Однако на сторонних ресурсах, тем не менее, можно обнаружить три рабочих решения: [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>
-Сравнительная таблица пактов для работы с GA API:
+Сравнительная таблица пактов для работы с API Google Analytics:
 {| class="wikitable sortable" width="800px"

@@ Строка 32: / Строка 32: @@
 | Дата последней стабильной версии
 | style="text-align:center" | 9.09.2013<ref>В апреле 2014 были внесены значительные изменения в код проекта, но после их внесения стабильного выпуска пока нет.</ref>
-| style="text-align:center" | 25.05.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>
+| style="text-align:center" | 1.06.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>
-| style="text-align:center" | 24.05.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>
+| style="text-align:center" | 4.08.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>
 | style="text-align:center" | 5.08.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>
 |-

@@ Строка 16: / Строка 16: @@
 ! width="20%" | [https://bitbucket.org/unikum/rga RGA]
 |-
-! colspan=4 | Общая информация
+! colspan=5 | Общая информация
 |-
 | Размещение
@@ Строка 48: / Строка 48: @@
 | style="text-align:center" | <code>RCurl</code>, <code>httr</code>, <code>jsonlite</code>
 |-
-! colspan=4 | Авторизация
+! colspan=5 | Авторизация
 |-
 | Авторизация по логину и паролю
@@ Строка 62: / Строка 62: @@
 | style="text-align:center" | +
 |-
-! colspan=4 | Доступ к API
+! colspan=5 | Доступ к API
 |-
 | Доступ к [https://developers.google.com/analytics/devguides/reporting/core/v3/ API базовых отчётов]

@@ Строка 14: / Строка 14: @@
 ! width="20%" | [https://github.com/skardhamar/rga rga]
 ! width="20%" | [https://github.com/jdeboer/ganalytics ganalytics]
 |-
 ! colspan=4 | Общая информация
@@ Строка 21: / Строка 22: @@
 | style="text-align:center" | [https://github.com/skardhamar/rga GitHub]
 | style="text-align:center" | [https://github.com/jdeboer/ganalytics GitHub]
 |-
 | Дата публикации
@@ Строка 26: / Строка 28: @@
 | style="text-align:center" | 27.11.2012
 | style="text-align:center" | 25.05.2013
 |-
 | Дата последней стабильной версии
@@ Строка 31: / Строка 34: @@
 | style="text-align:center" | 25.05.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>
 | style="text-align:center" | 24.05.2014<ref>Дата последней правки на данный момент, т.к. релизы данного пакета отсутствуют.</ref>
 |-
 | Лицензия
@@ Строка 36: / Строка 40: @@
 | style="text-align:center" | GPL2
 | style="text-align:center" | MIT
 |-
 | Зависимости
@@ Строка 41: / Строка 46: @@
 | style="text-align:center" | <code>RCurl</code>, <code>jsonlite</code>, <code>lubridate</code>, <code>httr</code>
 | style="text-align:center" | <code>httr</code>, <code>plyr</code>, <code>stringr</code>
 |-
 ! colspan=4 | Авторизация
@@ Строка 46: / Строка 52: @@
 | Авторизация по логину и паролю
 | style="text-align:center" | +
 | style="text-align:center" | -
 | style="text-align:center" | -
 |-
 | Авторизация [https://developers.google.com/accounts/docs/OAuth2 OAuth2]<ref>Авторизация по Client ID и Client secret, полученным в [https://console.developers.google.com API Console].</ref>
 | style="text-align:center" | +
 | style="text-align:center" | +
@@ Строка 57: / Строка 65: @@
 |-
 | Доступ к [https://developers.google.com/analytics/devguides/reporting/core/v3/ API базовых отчётов]
 | style="text-align:center" | +
 | style="text-align:center" | +
@@ Строка 65: / Строка 74: @@
 | style="text-align:center" | +
 | style="text-align:center" | -
 |-
 | Доступ к [https://developers.google.com/analytics/devguides/config/mgmt/v3/ API конфигурации]<ref>Информация по аккаунтам, профилям, представлениям, сегментам и целям.</ref>
@@ Строка 70: / Строка 80: @@
 | style="text-align:center" | +
 | style="text-align:center" | -
 |-
 | Пакетная обработка запросов<ref>Pagination - получение данных, превышающих ограничения Google (1000 на один запрос) путем организации нескольких запросов.</ref>
 | style="text-align:center" | +
 | style="text-align:center" | +

@@ Строка 120: / Строка 120: @@
 {{r-code|code=<nowiki>> devtools::install_github("rga", "skardhamar")</nowiki>}}
-=== Организация доступа к API ===
+=== Авторизация ===
-Загрузка пакета <code>rga</code> (требуется только в начале работы при запуске новой R-сессии):
+Перед началом работы необходимо загрузить пакет <code>rga</code> (требуется только в начале работы при запуске новой R-сессии):
 {{r-code|code=<nowiki>> library(rga)</nowiki>}}
-Для создания токена доступа потребуется переход в браузер, подтверждение доступа и копирование ключа в консоль. Опционально команда создает отдельный файл, который потом можно использовать для аутентификации без перехода в браузер<ref>Аргумент <code>where</code> с указанием пути и имени файла.</ref>.
+Для предоставления доступа к данным Google Analytics API из пакета <code>rga</code> неободимо пройти процедуру авторизации. Для этого используется функция <code>rga.open</code>, которая принимает следующие аргументы:
 {{r-code|code=<nowiki>> rga.open(instance = "ga", where = "ga.rga")</nowiki>}}
@@ Строка 134: / Строка 141: @@
 Второй вариант аутентификации с использованием собственных ключей доступа:
-{{r-code|code=<nowiki>> rga.open(instance = "ga", client.id = "", client.secret = "", where = "ga.rga")</nowiki>}}
+{{r-code|code=<nowiki>> rga.open(instance = "ga", client.id = "XXXXXX", client.secret = "XXXXXXX", where = "ga.rga")</nowiki>}}
-−
-Пояснения по значениям аргументов:
-−
-* <code>client.id</code> необходимо вставить сюда Client ID;
-* <code>client.secret</code> необходимо вставить сюда Client secret.
 После выполнения данной команды будет открыт интернет браузер со страницей запроса подтверждения разрешения на доступ к данным Google Analytics. Необходимо авторизоваться под своей учётной записью Google и подтвердить разрешение на доступ к данным Google Analytics. Отметим, что пакет `RGA` запрашивает доступ '''только для чтения''' данных.

@@ Строка 114: / Строка 114: @@
 == Пакет <code>rga</code> ==
-=== Установка необходимых пакетов ===
+=== Установка пакета ===
-Устанавливаем и подключаем пакет {{r-package|devtools}}, для доступа к [https://github.com/ github] (требуется только в первый раз, для установки пакета {{r-package|rga}}):
+Исходный код пакета <code>rga</code> располагается на [https://github.com github], поэтому установить его можно с помощью функции <code>install_github</code> из пакета {{r-package|devtools}}:
-{{r-code|code=<nowiki>> install.packages("devtools")
+{{r-code|code=<nowiki>> devtools::install_github("rga", "skardhamar")</nowiki>}}
-> library(devtools)</nowiki>}}
-−
-Устанавливаем пакет <code>rga</code>:
-−
-{{r-code|code=<nowiki>> install_github("rga", "skardhamar")</nowiki>}}
 === Организация доступа к API ===

@@ Строка 84: / Строка 84: @@
 В плане простоты использования, в свою очередь. лидирует пакет <code>rga</code>. В отличие от <code>ganalytics</code>, пакет <code>rga</code> позволяет указывать метрики, измерения, узкие сегменты и фильтры в виде аргументов сразу, в одной функции, что упрощает понимание структуры запроса и сегмента, и позволяет обрабатывать множество однотипных сегментов (например, страниц сайта) в цикле или <code>[a-z]pply</code>-функциях. Также <code>ganalytics</code> не имеет внутренних инструментов получения ID профилей, а их получение из web-интерфейса Google Analytics с последующей вставкой в запросы <code>ganalytics</code> трудоемко и, самое главное, неинтуитивно. <code>RGoogleAnalytics</code>, несмотря на достаточно подробную документацию и достаточный для полноценной работы функционал, обладает несколько непрозрачной и неочевидной структурой запросов к GA API.
 == Пакет <code>rga</code> ==
@@ Строка 110: / Строка 137: @@
 Видим, что в директории проекта появился файл <code>ga.rga</code><ref>Можно указать любой удобный путь и имя файла.</ref>. Теперь при повторном использовании этой команды будет осуществляться проверка наличия файла <code>ga.rga</code> в рабочей директории и, если такой файл будет найден, то данные для аутентификации будут взяты из данного файла.
-Второй вариант аутентификации с созданием собственного клиента API и ключей доступа:
+Второй вариант аутентификации с использованием собственных ключей доступа:
-−
-# Необходимо создать проект на странице https://console.developers.google.com/project;
-# На вкладке APIs & auth на вкладке APIs надо активировать Analytics API, нажав на кнопку, где написано <code>OFF</code>.
-# Во вкладке APIs & auth перейти во вкладку Credentials, где выбрать Create new Client ID;
-# При создании Client ID выбрать APPLICATION TYPE: Installed application, INSTALLED APPLICATION TYPE: other, и нажать create;
-# В результате будет Client ID = и Client secret = ;
-# На вкладке Consent screen необходимо выбрать рабочий email и дать название приложению (Product name), сохранить;
-−
-Получаем токен доступа (откроется браузер, где надо будет выбрать свой почтовый аккаунт и подтвердить вход в API, тогда выдадут код, который надо будет вставить в консоль):
 {{r-code|code=<nowiki>> rga.open(instance = "ga", client.id = "", client.secret = "", where = "ga.rga")</nowiki>}}
@@ Строка 127: / Строка 145: @@
 * <code>client.id</code> необходимо вставить сюда Client ID;
 * <code>client.secret</code> необходимо вставить сюда Client secret.
 После успешной аутентификации информацию о установленном подключении можно получить с помощью команды <code>ga$status()</code> или более подробную информацию <code>ga$show()</code>.
@@ Строка 258: / Строка 278: @@
 {{r-code|code=<nowiki>> str(ga.data)
-'data.frame':	34 obs. of  4 variables:
+'data.frame':   34 obs. of  4 variables:
   $ date     : Date, format: "2014-03-19" "2014-03-20" "2014-03-21" "2014-03-22" ...
   $ pageviews: num  9032 11914 10494 7173 8561 ...

@@ Строка 213: / Строка 213: @@
 Пояснения по значениям аргументов для метода <code>getData</code>:
-* <code>ids</code> - номер профиля, из которого нужно выгрузить данные;
+* <code>ids</code> - ID профиля, из которого нужно выгрузить данные;
-* <code>start.date</code> - символьная строка, которая задаёт стартовое время в формате <code>YYYY-MM-DD</code><ref>Получить начальную дату сбора статистики в GA можно с помощью команды <code> ga$getFirstDate(id)</code>.</ref>;
+* <code>start.date</code> - символьная строка, которая задаёт стартовое время в формате <code>YYYY-MM-DD</code><ref>Получить начальную дату сбора статистики в GA можно с помощью команды <code> ga$getFirstDate(id)</code>.</ref>. Допускаются также значения "today", "yesterday", "ndaysAgo", где <code>n</code> - это количество дней;
-* <code>end.date</code> - символьная строка, которая задаёт конечное время в формате <code>YYYY-MM-DD</code><ref>В данном случае используется функция <code>Sys.Date()</code>, которая выводит текущую дату.</ref>;
+* <code>end.date</code> - символьная строка, которая задаёт конечное время в формате <code>YYYY-MM-DD</code><ref>В данном случае используется функция <code>Sys.Date()</code>, которая выводит текущую дату.</ref>. Допускаются также значения "today", "yesterday", "ndaysAgo", где <code>n</code> - это количество дней;
 * <code>date.format</code> - символьная строка, которая задаёт формат даты, который используется для преобразования дат, полученных в результате запроса (по умолчанию <code>%Y-%m-%d</code>);
 * <code>metrics</code> - символьная строка, которая определяет показатели (столбцы), которые будут входить в таблицу с данными (по умолчанию <code>"ga:visits"</code>)<ref>Можно использовать не больше 10 метрик одновременно.</ref>;
@@ Строка 225: / Строка 225: @@
 * <code>walk = TRUE</code> - позволяет получить исходные, а не агрегированные данные.
-Аргументы <code>ids</code>, <code>start.date</code>, <code>end.date</code> и <code>metrics</code> являются обязательными для запроса к GA API. Прм этом функция <code>getData()</code> требует только <code>id</code> профиля, т.к. остальные аргументы имеют значения по умолчанию. Все аргументы метода <code>getData</code>, а также значения по умолчанию можно посмотреть с помощью команды <code>args(ga$getData)</code>.
+Аргументы <code>ids</code>, <code>start.date</code>, <code>end.date</code> и <code>metrics</code> являются обязательными для запроса к Google Analytics API. Все аргументы метода <code>getData</code>, а также значения по умолчанию, можно посмотреть с помощью команды <code>args(ga$getData)</code>.
 Детальную информацию  можно найти на соответствующих страницах справочного руководства по GA API:
@@ Строка 235: / Строка 235: @@
 * по сегментам: https://developers.google.com/analytics/devguides/reporting/core/v3/segments
-Получить доступ к API GA можно также с помощью веб-сервисов Google по следующей ссылке: https://developers.google.com/apis-explorer/?hl=ru#p/analytics/v3/. Для получения данных необходимо авторизоваться и задать требуемые параметры для запроса к API.
+Получить доступ к API Google Analytics можно также с помощью веб-сервисов Google по следующей ссылке: https://developers.google.com/apis-explorer/?hl=ru#p/analytics/v3/. Для получения данных необходимо авторизоваться и задать требуемые параметры для запроса к API.
 Пример сбора данных по выбранным метрикам и измерениям приведён ниже.
 {{r-code|code=<nowiki>> ga.data <- ga$getData(ids = id,

@@ Строка 132: / Строка 132: @@
 === Получение данных ===
-Пакет <code>rga</code> позволяет получить доступ к различной информации. Поскольку объекты, формируемые пакетом <code>rga</code>, относятся к классу <code>refClass</code>, что не является широко распространённой системой в данный момент, то ниже мы проведём небольшой обзор доступных функций и методов.
+Пакет <code>rga</code> позволяет получить доступ к различным API Google Analytics. Поскольку объекты, формируемые пакетом <code>rga</code>, относятся к классу <code>refClass</code>, что не является широко распространённой системой в данный момент, то ниже мы проведём небольшой обзор доступных функций и методов.
 Получить общую информацию о классе <code>rga</code> можно с помощью функции <code>getRefClass()</code>: