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

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

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

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

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

Отзывы и вопросы, как и всегда, можно отправить через [форму обратной связи](https://tech.yandex.ru/direct/doc/support/troubleshooting/other-docpage/).

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

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

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

 library(ryandexdirect)
 myToken My_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  Regions  Language = "ru",
 login = <YourLogin>,
 token = myToken

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

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

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

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

Более подробно узнать о пакете функций ryandexdirect для загрузки данных из API Яндекс Директ и Яндекс Метрики в R можно получить на моём репозитории на GitHub перейдя по ссылке.