3482
правки
Изменения
м
Нет описания правки
В плане простоты использования, в свою очередь. лидирует пакет <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.
== Получение ключей для доступа к API Google Analytics ==
Прежде чем приступить к работе с пакетами, предназначенными для работы с Google Analytics API, необходимо создать новое приложение в [https://console.developers.google.com Google Developers Console] и получить '''Client ID''' (идентификатор клиента) и '''Client secret''' (секретный ключ клиента) для доступа к API Google Analytics. Не смотря на то, что некоторые пакеты, например <code>rga</code>, предоставляют ключи доступа, сгенерированные автором пакета, мы всё же рекомендуем получить собственные ключи, т.к. сторонние ключи могут быть в любой момент отозваны автором.
Пошаговая инструкция приведена ниже:
# Создание нового проекта (можно пропустить, если проект уже создан):
#* Откройте страницу https://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'''.
Теперь вы в любой момент можете вернуться на страницу '''Credentials''' и узнать '''Client ID''' и '''Client secret'''.
== Пакет <code>rga</code> ==
Видим, что в директории проекта появился файл <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>}}
* <code>client.id</code> необходимо вставить сюда Client ID;
* <code>client.secret</code> необходимо вставить сюда Client secret.
После выполнения данной команды будет открыт интернет браузер со страницей запроса подтверждения разрешения на доступ к данным Google Analytics. Необходимо авторизоваться под своей учётной записью Google и подтвердить разрешение на доступ к данным Google Analytics. Отметим, что пакет `RGA` запрашивает доступ '''только для чтения''' данных.
После успешной аутентификации информацию о установленном подключении можно получить с помощью команды <code>ga$status()</code> или более подробную информацию <code>ga$show()</code>.
{{r-code|code=<nowiki>> str(ga.data)
'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 ...
