Yandex Direct
Yandex Direct отдаёт статистику набором типов отчётов: от сводки по аккаунту до поисковых запросов, плюс произвольный отчёт с собственной группировкой. Renta выгружает любой из них в хранилище данных вместе с метаданными кампаний и групп объявлений: показы, клики, расход, конверсии, доход и видеометрики.
Аутентификация
Renta использует OAuth для аутентификации в Яндексе. Вы будете перенаправлены на страницу Яндекса, чтобы предоставить Renta ограниченный доступ к аккаунту Yandex Direct.
Подключение источника Yandex Direct
Выполните эти шаги, чтобы добавить Yandex Direct как источник в Renta через OAuth-аутентификацию.
- Откройте раздел Connections > Catalog в левом меню.
- Откройте категорию Advertising и нажмите карточку Yandex Direct.
Нажмите Log in to your Yandex Direct account. Вы будете перенаправлены на страницу Яндекса для предоставления доступа.
Яндекс покажет экран входа со списком прав, которые запрашивает Renta, включая использование API Яндекс.Директа. Выберите аккаунт с доступом к вашим рекламным кампаниям и подтвердите. После этого вы вернётесь в Renta.
Завершите настройку:
- Source name.
Укажите имя источника данных. Оно используется только в интерфейсе Renta. - Access granted.
Убедитесь, что аккаунт подключён успешно.
Нажмите Save, чтобы завершить.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
После подключения источника создайте пайплайн, чтобы выгружать данные Yandex Direct в назначение.
Создание пайплайна Yandex Direct
Свяжите источник Yandex Direct с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите Yandex Direct в разделе Already connected и нажмите Next step.
Выберите созданное ранее подключение Yandex Direct и нажмите Next step.
На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите, какие данные Yandex Direct выгружать и как Renta будет их загружать.
Конфигурация отчёта
Сначала выберите тип отчёта. Он определяет группировку статистики и набор полей, доступных в списке Parameters.
| Тип отчёта | Описание |
|---|---|
| Account performance report | Статистика по всему рекламному аккаунту, без разбивки по кампаниям и объявлениям. |
| Campaign performance report | Статистика с группировкой по кампаниям. |
| Ad Group performance report | Статистика с группировкой по группам объявлений. |
| Ad performance report | Статистика с группировкой по объявлениям. |
| Criteria performance report | Статистика с группировкой по условиям показа: группа объявлений, идентификатор и тип условия. |
| Custom report | Статистика с произвольной группировкой. Единственный тип отчёта, в котором доступны UTM-метки и ссылка объявления. |
| Reach and frequency performance report | Статистика по медийным кампаниям, включая видеометрики: просмотры, квартили и досмотры. Кампании других типов игнорируются. |
| Search query performance report | Статистика с группировкой по группам объявлений и поисковым запросам, с ключевой фразой, по которой прошёл показ. |
| Campaign objects data | Атрибуты объекта кампании: имя, тип, статус, валюта, дневной бюджет, даты начала и окончания, менеджер и агентство. |
| Ad group objects data | Атрибуты объекта группы объявлений: имя, кампания, тип, подтип, статус, статус показов и параметры отслеживания. |
Параметры
Выберите поля для таблицы назначения. Схема набора данных определяется выбранными здесь параметрами.
Каждая строка списка показывает отображаемое имя, а под ним имя в API: Campaign Id для CampaignId. Именно имя в API становится именем колонки в таблице назначения, а значения, которые Yandex Direct отдаёт пустыми, попадают туда как NULL.
Отметьте нужные поля или нажмите Select All. Вкладка Selected показывает выбор со счётчиком.
В отчётах со статистикой доступны календарные поля: с ними можно группировать данные без функций работы с датами на стороне хранилища. Поля по неделям идут в двух вариантах: недели с воскресенья и недели по ISO, с понедельника.
| Поле | Колонка | Описание |
|---|---|---|
| Year | year | Год даты. |
| Year & month | yearmonth | Год и месяц вместе. |
| Quarter | quarter | Квартал года. |
| Month | month | Месяц года. |
| Year of week (Sun-Sat) | yearofweek | Год, к которому относится неделя, недели с воскресенья. |
| Year of week (Mon-Sun) | yearofweekiso | Год, к которому относится неделя, недели по ISO. |
| Year & week (Sun-Sat) | yearweek | Год и номер недели, недели с воскресенья. |
| Year & week (Mon-Sun) | yearweekiso | Год и номер недели, недели по ISO. |
| Week (Sun-Sat) | week | Номер недели, недели с воскресенья. |
| Week (Mon-Sun) | weekiso | Номер недели по ISO. |
| Day of week (Sun-Sat) | dayOfWeekName | Название дня недели, недели с воскресенья. |
| Day of week | dayOfWeekNameIso | Название дня недели, недели по ISO. |
| Day of month | dayOfMonth | День месяца. |
| Date | date | Дата строки статистики. |
| Today | date_today | Сегодняшняя дата. |
В типе отчёта Custom report также доступны utm_source, utm_medium, utm_campaign, utm_content, utm_term и Ad URL. Renta заполняет эти колонки из ссылки объявления, поэтому в них попадают метки, которые вы задали в Yandex Direct. Они работают для текстовых кампаний, динамических текстовых кампаний и медийных кампаний с оплатой за показы; строки по кампаниям других типов выгружаются со своей статистикой, но UTM-колонки у них останутся пустыми.
Динамические параметры в ссылках объявлений
Yandex Direct позволяет подставлять в ссылку объявления динамические параметры, чтобы ссылка передавала в аналитику кампанию, ключевую фразу или устройство. Renta подставляет значения строки, поэтому в выгруженных колонках оказываются читаемые данные, а не плейсхолдеры.
Объявление с меткой utm_campaign={campaign_id} даст идентификатор кампании в колонке utm_campaign.
| Динамический параметр | Значение в выгруженной строке |
|---|---|
{ad_id}, {banner_id} | Идентификатор объявления. |
{gbid} | Идентификатор группы объявлений. |
{campaign_id} | Идентификатор кампании. |
{campaign_name}, {campaign_name_lat} | Имя кампании. |
{campaign_type} | Тип кампании. |
{keyword} | Ключевая фраза, очищенная от операторов соответствия. Для показов по ретаргетингу остаётся пустой. |
{phrase_id}, {adtarget_id} | Идентификатор условия показа. |
{adtarget_name} | Само условие показа. |
{retargeting_id} | Идентификатор условия показа, заполняется только для аудиторных условий и ключевых фраз. |
{coef_goal_context_id} | Идентификатор корректировки ставок для ретаргетинга. |
{match_type} | Тип соответствия поискового запроса ключевой фразе. |
{addphrases} | yes, если показ прошёл по дополнительной релевантной фразе, иначе no. |
{device_type} | Тип устройства в нижнем регистре: desktop, mobile или tablet. |
{position} | Средняя позиция клика, округлённая до целого. |
{position_type} | premium для позиций с 1 по 4, none для позиции 0 и other в остальных случаях. |
{source} | Площадка, на которой показано объявление. Для показов на поиске Яндекса подставляется none. |
{source_type} | Тип сети в нижнем регистре: search или context. |
{region_name} | Имя региона присутствия. |
{region_id} | Идентификатор региона присутствия. |
Параметр, которого нет в этом списке, останется в выгруженном значении в том виде, в каком он записан в ссылке.
НДС и скидка
Выберите, как Yandex Direct считает стоимостные метрики перед передачей в Renta. Обе настройки действуют на весь отчёт.
| Настройка | По умолчанию | Описание |
|---|---|---|
| Include VAT | YES | Включать ли НДС в стоимостные метрики. Именно эта настройка меняет Cost, Avg Cpc, Cost Per Conversion и остальные денежные поля. |
| Include discount | NO | Устаревшая настройка. Yandex Direct отменил агентскую скидку с 1 сентября 2015 года и помечает соответствующий параметр API как устаревший, поэтому на цифры он больше не влияет. |
Стоимостные метрики приходят в валюте рекламодателя с двумя знаками после запятой.
Имя таблицы и диапазон дат
Задайте имя пайплайна и исторический период для загрузки. Широкий диапазон при первом запуске загружается заметно дольше, чем несколько дней.
- Integration name.
Имя пайплайна. Используется только в интерфейсе Renta. - Table name.
Имя таблицы назначения. Можно оставить сгенерированное имя или ввести своё. - Date start.
Первая дата периода выгрузки. - Date end.
Последняя дата периода выгрузки. Можно выбрать фиксированную дату или относительный вариант, например Today.
Период перезаписи
Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске. Настройка появляется после выбора параметра Date.
При каждом запуске Renta заново запрашивает данные начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, более старые данные не затрагиваются. Варианты идут от Without overwrite data до Overwrite all data; по умолчанию выбран Last 1 day.
Расписание
Выберите, как часто запускать пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.
Ограничения
Reports API задаёт границы, которые действуют для любого пайплайна на этом источнике.
| Ограничение | Описание |
|---|---|
| Глубина истории | Статистика доступна за предыдущие три года от текущего месяца. Более ранний Date start вернёт пустоту за ту часть диапазона, которая выходит за это окно. |
| История поисковых запросов | Поле поискового запроса ограничено последними 180 днями, поэтому Search query performance report нельзя загрузить глубже этого срока. |
| Campaign Id в медийных отчётах | Reach and frequency performance report требует идентификатор кампании, поэтому оставьте Campaign Id среди выбранных параметров. |
| Единая атрибуция | Любой тип отчёта относит показ или клик ровно к одному условию показа, региону и атрибуту аудитории. |
| В отчётах по объектам нет истории | Campaign objects data и Ad group objects data возвращают текущее состояние, поэтому удалённый в Yandex Direct объект пропадёт из таблицы при следующем запуске. |
Стратегия синхронизации
Стратегия синхронизации зависит от того, включён ли в отчёт параметр Date.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Account performance report, Campaign performance report, Ad Group performance report, Ad performance report, Criteria performance report, Custom report, Reach and frequency performance report, Search query performance report (с выбранным параметром Date) | Каждая строка содержит свою дату, таблица назначения партиционируется по колонке date. При каждом запуске Renta запрашивает окно от даты последнего успешного запуска минус период перезаписи до конца диапазона дат: затронутые дневные партиции удаляются и вставляются заново, более старые партиции не затрагиваются. |
| Полная перезагрузка | Account performance report, Campaign performance report, Ad Group performance report, Ad performance report, Criteria performance report, Custom report, Reach and frequency performance report, Search query performance report (без параметра Date) | В таблице нет колонки даты для партиционирования, поэтому Renta запрашивает отчёт за весь настроенный диапазон дат и заменяет набор данных при каждом запуске. |
| Полная перезагрузка | Campaign objects data, Ad group objects data | Эти отчёты возвращают текущее состояние кампаний и групп объявлений, поля даты в них нет вообще, поэтому Renta перезагружает весь набор данных при каждом запуске. |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.