В пакет ryandexdirect добавлена возможность работы с сервисом Reports, и возможность загрузки справочной информации.

1. Релиз сервиса Reports и возможность работы с ним из ryandexdirect.

22 марта 2017 года в официальном блоге Яндекс Директ был объявлен релиз сервиса Reports.

В API Директа появился долгожданный сервис Reports для выгрузки статистики по рекламным кампаниям.

Описания параметров и инструкции по работе с сервисом подробно описаны в документации. Мы разработали несколько типов отчетов: от статистики по отдельным объявлениям до сводки по всему аккаунту рекламодателя. Есть и возможность получения статистики по поисковым запросам. А с помощью отчета CUSTOM_REPORT вы можете собрать отчет с любой комбинацией полей и условий отбора данных.

Отзывы и вопросы, как и всегда, можно отправить через форму обратной связи.

Успешной работы!

В связи с чем в пакет ryandexdirect была добавлена функция yadirGetReport для работы с этим сервисом.

Пример работы с функцией yadirGetReport

library(ryandexdirect)
myToken <- yadirGetToken()
My_report <- yadirGetReport(ReportType = "CAMPAIGN_PERFORMANCE_REPORT", 
                            DateRangeType = "CUSTOM_DATE", 
                            DateFrom = '2017-01-01', 
                            DateTo = '2017-01-31', 
                            FieldNames = c("CampaignName","Impressions","Clicks"), 
                            FilterList = c("Clicks GREATER_THAN 49","Impressions LESS_THAN 1001"), 
                            Login = <YourLogin>, 
                            Token = myToken)

Вместо YourLogin подставьте в виде строки ваш логин на Яндексе, для примеры работы с фильтрами данный запрос вернёт рекламные кампании по которым за выбранный период было более 49 кликов и менее 1001 показа.

Данные в отчете можно агрегировать по различным периодам. Для этого укажите в аргументе FieldNames одно из значений Date, Week, Month, Quarter или Year.

2. Функция yadirGetDictionary для загрузки справочников из API Директа версии 5.

В пакет ryandexdirect добавлена функция yadirGetDictionary с помощью которой можно получить любой доступный в 5 версии API Директа справочник.

Пример работы с функцией yadirGetDictionary для загрузки справочников из API v.5. Яндекс Директ.

library(ryandexdirect)
myToken <- yadirGetToken()
Regions <- yadirGetDictionary(DictionaryName = "GeoRegions", 
                              Language = "ru", 
                              login = <YourLogin>, 
                              token = myToken

Вместо YourLogin подставьте в виде строки ваш логин на Яндексе, данный запрос загрузит в R справочник регионов Яндекс Директ.

На данный момент в API Директа версии 5, доступны следующие справочники.

Название справочника	Описание справочника
AdCategories	Особые категории рекламируемых товаров и услуг.
Constants	Ограничения на значения параметров.
Currencies	Курсы валют, валютные параметры и ограничения.
GeoRegions	Регионы.
MetroStations	Станции метрополитена (только для Москвы, Санкт-Петербурга и Киева).
OperationSystemVersions	мобильных приложений.
ProductivityAssertions	Рекомендации по повышению продуктивности.
TimeZones	Часовые пояса.
SupplySidePlatforms	Внешние сети (SSP).
Interests	Интересы к категориям мобильных приложений.

Более подробно посмотреть информацию доступную в каждом из справочников можно по ссылке.

Добавлена возможность работы с Logs API Яндекс Метрики.

В пакет ryandexdirec добавлена функция yadirGetLogsData, с помощью которой можно получить в R сырые данные собранные Яндекс Метрикой.

Пример работы функции:

library(ryandexdirect)
myToken <- yadirGetToken()
rawmetrikdata <- yadirGetLogsData(counter = "00000000",
                                  date_from = "2016-12-01",
                                  date_to = "2016-12-20",
                                  fields = "ym:s:visitID,ym:s:date,ym:s:bounce,ym:s:clientID,ym:s:networkType",
                                  source = "visits",
                                  token = myToken)

Информация о функции добавлена в README.

Добавлена функция yadirCurrencyRates.

В пакет добавлена новая функция yadirCurrencyRates(login = NULL, token = NULL) с помощью которой вы можете загрузить актуальную информацию по курсам валют из Яндекс.Директ в R.

Структура дата фрейма возвращаемого функцией yadirCurrencyRates.

Поле	Тип данных	Описание
curName	chr	Код валюты
fullName	chr	Полное название валюты
RateWithVAT	num	стоимость 1 у. е. с учетом НДС.
Rate	num	стоимость 1 у. е. без учета НДС.

Переход функции yadirGetCampaignList на API v.5

В связи с тем что метод GetCampaignsList, который использовался в прошлой версии функции в ближайшие две недели будет отключен Яндексом, и уже сейчас в связи с введёнными ограничениями периодически возвращает ошибку 59 был осуществлён переход на работу с методом get сервиса Campaigns, в связи с чем была расширен дата фрейм который возвращает данная функция возвращает.

Структура дата фрейма.

Поле	Тип данных	Описание
Id	chr	Идентификатор кампании.
Name	chr	Название кампании.
Type	Factor	Тип кампании ("TEXT_CAMPAIGN" | "MOBILE_APP_CAMPAIGN" | "DYNAMIC_TEXT_CAMPAIGN" | "UNKNOWN").
Status	Factor	Статус кампании ( "ACCEPTED" | "DRAFT" | "MODERATION" | "REJECTED" | "UNKNOWN" ).
State	Factor	Состояние кампании ( "ARCHIVED" | "CONVERTED" | "ENDED" | "OFF" | "ON" | "SUSPENDED" | "UNKNOWN" ).
DailyBudgetAmount	num	Дневной бюджет кампании в валюте рекламодателя.
DailyBudgetMode	chr	DISTRIBUTED — распределять дневной бюджет равномерно на весь день. STANDARD — дневной бюджет может исчерпаться, а показы завершиться ранее окончания дня.
Currency	Factor	Валюта кампании. Совпадает с валютой рекламодателя для всех кампаний.
StartDate	Date	Дата начала показов объявлений.
int	Количество показов за время существования кампании..
Clicks	int	Количество кликов за время существования кампании.
ClientInfo	chr	Название клиента. Значение по умолчанию — наименование из настроек рекламодателя.
login	chr	Логин пользователя на Яндексе.