3.6.0

selesnow · Jun 10, 2020 · bdbeb32 · bdbeb32
1 parent 0af5311
commit bdbeb32
Show file tree

Hide file tree

Showing 7 changed files with 192 additions and 23 deletions.
diff --git a/DESCRIPTION b/DESCRIPTION
@@ -1,8 +1,8 @@
 Package: ryandexdirect
 Type: Package
 Title: Load Data From 'Yandex Direct'
-Version: 3.5.0.9000
-Date: 2020-05-16
+Version: 3.6.0
+Date: 2020-06-09
 Description: Load data from 'Yandex Direct' API V5 
     <https://tech.yandex.ru/direct/doc/dg/concepts/about-docpage/> into R.
 	Provide function for load lists of campaings, ads, keywords and other 
@@ -20,7 +20,7 @@ Author: Alexey Seleznev [aut, cre] (<https://orcid.org/0000-0003-0410-7385>)
 Maintainer: Alexey Seleznev <[email protected]>
 Depends: R (>= 3.5.0)
 BugReports: https://github.com/selesnow/ryandexdirect/issues
-URL: https://selesnow.github.io/ryandexdirect, https://t.me/R4marketing
+URL: https://selesnow.github.io/ryandexdirect, https://t.me/R4marketing, https://www.youtube.com/playlist?list=PLD2LDq8edf4oUo0L9Kw77ZXf0KcV1hu67
 Imports: utils, 
          httr, 
     		 bitops, 

diff --git a/NEWS.md b/NEWS.md
@@ -1,24 +1,26 @@
-# ryandexdirect 3.5.0.9000
+# ryandexdirect 3.6.0
 
-дата: 2020-05-16
+дата: 2020-06-09
 
 * В пакет добавлена функция `yadirGetCostData()`, которая запрашивает данные о расходах, кликах и показах по рекламным кампаниям, ключевым словам и объвлениям для дальнейшей загрузки в Google Analytics.
 * Техническое обновление, исправлена опечатка в функции `yadirGetForecast()`, изза которой не корректно работал фильтр по регионам.
 * Исправлена ошибка `C stack usage 1592693 is too close to the limit`.
 * Исправлен обработчик ошибок в функции `yadirGetReport()`, который запускается аргументом `SkipErrors = FALSE`.
 * В функции `yadirGetReport()` измененно дефолтное значение аргумента `DateRangeType` с 'LAST_30_DAYS' на 'CUSTOM_DATE'.
+* Добавлена виньетка `vignette("yandex-direct-cost-data", package = "ryandexdirect")`, посвящённая функции `yadirGetCostData()`
+* Актуализирована виньетка по авторизации.
 
 # ryandexdirect 3.5.0
 
 дата: 2020-05-06
 
 * Для удобства авторизации в `ryandexdirect` были добавлены опции, и поддержка переменных среды.
     * Опции:
-	     * ryandexdirect.user - логин по умолчанию
+	   * ryandexdirect.user - логин по умолчанию
 		 * ryandexdirect.token_path - путь к папке с учётными данными по умолчанию
 		 * ryandexdirect.agency_account - агентсткий аккаунт по умолчанию
 	* Переменные среды:
-	     * RYD_USER - логин по умолчанию
+	   * RYD_USER - логин по умолчанию
 		 * RYD_TOKEN_PATH - путь к папке с учётными данными по умолчанию
 		 * RYD_AGENCY - агентсткий аккаунт по умолчанию
 * Добавлена функция `yadirGetLogins()`, с помощью которой вы можете получить список всех логинов, учётные данные по которым сохраненны в `TokenPath`, так же можно с помощью этой же функции переключиться из одного логина на другой.

diff --git a/vignettes/yandex-direct-auth.Rmd b/vignettes/yandex-direct-auth.Rmd
diff --git a/vignettes/yandex-direct-cost-data.Rmd b/vignettes/yandex-direct-cost-data.Rmd
@@ -0,0 +1,94 @@
+---
+title: "Загрузка данных о расходах на рекламу из Яндекс Директ в Google Analytics"
+author: "Алексей Селезнёв"
+date: "`r Sys.Date()`"
+output: rmarkdown::html_vignette
+vignette: >
+  %\VignetteIndexEntry{ryandexdirect: Загрузка данных о расходах на рекламу из Яндекс Директ в Google Analytics}
+  %\VignetteEngine{knitr::rmarkdown}
+  %\VignetteEncoding{UTF-8}
+---
+
+```{r setup, include = FALSE}
+knitr::opts_chunk$set(
+  eval=FALSE,
+  collapse = TRUE,
+  comment = "#>"
+)
+```
+
+Начиная с версии `ryandexdirect 3.6.0` в пакет была добавлена функция `yadirGetCostData()`, которая позволяет вам получить данные о расходах для дальнейшей их загрузки в Google Analytics.
+
+## Видео уроки
+Вы можете посмотреть видео урок по данной теме, перейдя по [этой ссылке](https://youtu.be/T9y0Iuh5EWk).
+
+## Создаём набор данных в Google Analytics
+Изначально вам необходимо создать набор данных в Google Analytics.
+
+1. Заходим в панель администратора
+2. В области ресурс выбираем пункт "Импорт данных"
+
+![Панель администратора](http://img.netpeak.ua/alsey/159056878065_kiss_43kb.png)
+
+3. Нажимае **Создать / Create**
+4. Среды предложенных вариантов выбираем **Данные о расходах / Cost Data**
+
+![Выбираем тип набора данных](http://img.netpeak.ua/alsey/159056895184_kiss_45kb.png)
+
+5. Задаём имя набора данных
+6. Выбираем из выпадающего списка представления, в которые будут импортироваться данные о расодах
+
+![Выбираем представления](http://img.netpeak.ua/alsey/159171156636_kiss_26kb.png)
+
+7. Настраиваем схему данных и выбираем перезаписывать данные если они соответвуют уже существующим строкам *Owerwrite*
+
+![Настраиваем схему данных](http://img.netpeak.ua/alsey/159056941892_kiss_43kb.png)
+
+8. Жмём сохранить.
+
+Далее в интерфейсе появится созданный набор данных.
+
+![Созданный набор данных](http://img.netpeak.ua/alsey/159171162087_kiss_25kb.png)
+
+В дальнейшем нам понадобится его идентификаторв.
+
+## Запрашиваем данные о расхода из рекламного кабинета Facebook
+Далее мы можем запросить данные о расходах из любого аккаунта к которому у нас есть доступ, и с помощью пакета `googleAnalyticsR` загрузить их в созданный источник данных.
+
+```{r}
+library(rfacebookstat)
+library(googleAnalyticsR)
+
+# fb options
+options(ryandexdirect.username = 'your_yandex_username')
+
+# auth
+fbAuth()
+ga_auth(email = "[email protected]")
+
+# read data from facebook
+cost_data <- yadirGetCostData(DateFrom        = '2020-03-01',
+                              DateTo          = '2020-03-10',
+                              Source          = 'yandex', 
+                              Medium          = 'cpc',
+                              IncludeVAT      = "YES",
+                              IncludeDiscount = "NO")
+
+# upload into GA source
+ga_custom_upload_file(accountId          = 2222222, 
+                      webPropertyId      = "UA-2222222-1", 
+                      customDataSourceId = 'M_XXXXX_Qudk-8g', 
+                      cost_data)
+```
+
+Если вы всё сделали правильно в разделе "Manage Uploads" вы увидите загруженные данные, и сообщение о статусе загрузке.
+
+![Раздел "Manage Uploads"](http://img.netpeak.ua/alsey/159171178055_kiss_29kb.png)
+
+![Статус загрузки](https://img.netpeak.ua/alsey/159057047222_kiss_16kb.png)
+
+## Где искать данные о расходах на Яндекс Директ в Google Analytics
+После загрузки в Google Analytics данные появляются не сразу, как правило должно пройти 1 - 1.5 часа.
+Найти данные о расходах можно в отчёте Анализ расходов:
+
+![Данные о расходах в Google Analytics](http://img.netpeak.ua/alsey/159178300398_kiss_26kb.png)
diff --git a/vignettes/yandex-direct-get-statistic.Rmd b/vignettes/yandex-direct-get-statistic.Rmd
@@ -4,7 +4,7 @@ author: "Alexey Seleznev"
 output: rmarkdown::html_vignette
 date: "`r Sys.Date()`"
 vignette: >
-  %\VignetteIndexEntry{Load Statistic From 'Yandex Direct' RUS}
+  %\VignetteIndexEntry{ryandexdirect: Загрузка статистики из рекламного аккаунта Яндекс Директ}
   %\VignetteEngine{knitr::rmarkdown}
   %\VignetteEncoding{UTF-8}
 ---

diff --git a/vignettes/yandex-direct-get-wordstat-forecast.Rmd b/vignettes/yandex-direct-get-wordstat-forecast.Rmd
@@ -4,7 +4,7 @@ author: "Alexey Seleznev"
 output: rmarkdown::html_vignette
 date: "`r Sys.Date()`"
 vignette: >
-  %\VignetteIndexEntry{WordStat reports and budget forecast}
+  %\VignetteIndexEntry{ryandexdirect: Прогноз бюджета и отчёты сервиса WordStat}
   %\VignetteEngine{knitr::rmarkdown}
   %\VignetteEncoding{UTF-8}
 ---
@@ -28,6 +28,9 @@ WordStat — это бесплатный сервис Яндекса, предн
 
 Функция `ydirGetWordStatReport()` возвращает те же сведения, которые доступны в сервисе [Подбор слов](https://wordstat.yandex.ru/). Статистика рассчитывается за прошедший месяц.
 
+## Видео урок
+Помимо данной виньетки данная тема рассмотренна в видео уроке, который доступен по [ссылке](https://youtu.be/g9lwjsgAhyY).
+
 ## Аргументы функции ydirGetWordStatReport
 * Phrases - Вектор ключевых фраз, по которым требуется получить статистику поисковых запросов (не более 10 фраз в кодировке UTF-8). Ключевые фразы могут содержать минус-фразы. Минус-фразу из нескольких слов следует заключить в скобки, например: `холодильник -морозильник -(морозильная камера) -ремонт`.
 * GeoID - Вектор идентификаторов регионов. Позволяет получать статистику поисковых запросов, сделанных только в указанных регионах. Чтобы исключить регион, перед его идентификатором ставят минус, например [1,-219] — получить статистику для Москвы и Московской области, кроме Черноголовки. Статистика выдается суммарно по всем плюс-регионам, из которых исключены все минус-регионы. Получить справочник регионов можно с помощью функции `yadirGetDictionary()`

diff --git a/vignettes/yandex-direct-keyword-bids.Rmd b/vignettes/yandex-direct-keyword-bids.Rmd
@@ -1,10 +1,10 @@
 ---
-title: "Управление ставками ключевых слов с помощью API Яндекс Директ."
+title: "Управление ставками ключевых слов с помощью API Яндекс Директ"
 author: "Alexey Seleznev"
 output: rmarkdown::html_vignette
 date: "`r Sys.Date()`"
 vignette: >
-  %\VignetteIndexEntry{Keyword Bids Managment by 'Yandex Direct' API RUS}
+  %\VignetteIndexEntry{ryandexdirect: Управление ставками ключевых слов с помощью API Яндекс Директ}
   %\VignetteEngine{knitr::rmarkdown}
   %\VignetteEncoding{UTF-8}
 ---