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

29 марта 201729 березня 201729 Mar 2017 3 мин чтения3 хв читання3 min read RU
Материал опубликован в 2017 году — описанные инструменты и интерфейсы могли измениться.Матеріал опубліковано у 2017 році — описані інструменти та інтерфейси могли змінитися.Published in 2017 — the tools and interfaces described may have changed since.

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

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

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

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

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

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

В связи с чем в пакет 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 перейдя по ссылке.

Ко всем материаламДо всіх матеріалівAll posts

Telegram-канал R4marketingTelegram-канал R4marketingR4marketing on Telegram

Новые статьи, видео и заметки по R — первыми.Нові статті, відео та нотатки з R — першими.New articles, videos and R notes — first.

YouTube-канал R4marketingYouTube-канал R4marketingR4marketing on YouTube

Видеоуроки по R, аналитике и AI-инструментам.Відеоуроки з R, аналітики та AI-інструментів.Video lessons on R, analytics and AI tools.