Какой тип отчёта выбрать?

Выбирайте фиксированный тип отчёта, когда нужна стандартная разбивка: Campaign performance report группирует по кампаниям, Ad performance report по объявлениям, Search query performance report по поисковым запросам. Выбирайте Custom report , когда нужна своя комбинация группировок или UTM-метки: это единственный тип отчёта, в котором доступны UTM-поля и ссылка объявления.

Почему я не вижу выпадающий список Ad accounts?

Список **Ad accounts** содержит логины клиентов агентского аккаунта. Если вы подключили обычный рекламный аккаунт, выбирать нечего: Renta скрывает этот список и выгружает данные по самому подключённому аккаунту.

Yandex Direct

Yandex Direct отдаёт статистику набором типов отчётов: от сводки по аккаунту до поисковых запросов, плюс произвольный отчёт с собственной группировкой. Renta выгружает любой из них в хранилище данных вместе с метаданными кампаний и групп объявлений: показы, клики, расход, конверсии, доход и видеометрики.

Аутентификация

Renta использует OAuth для аутентификации в Яндексе. Вы будете перенаправлены на страницу Яндекса, чтобы предоставить Renta ограниченный доступ к аккаунту Yandex Direct.

Ваши учётные данные шифруются при передаче и хранении и не сохраняются в прикладной базе данных Renta. Вы сохраняете контроль и можете отозвать доступ в настройках аккаунта Яндекса в любой момент.

Подключение источника Yandex Direct

Выполните эти шаги, чтобы добавить Yandex Direct как источник в Renta через OAuth-аутентификацию.

Перейдите в каталогStep 1

Откройте раздел Connections > Catalog в левом меню.
Откройте категорию Advertising и нажмите карточку Yandex Direct.

Карточка Yandex Direct в категории Advertising каталога Renta

Авторизуйте подключениеStep 2

Нажмите Log in to your Yandex Direct account. Вы будете перенаправлены на страницу Яндекса для предоставления доступа.

Страница авторизации подключения Yandex Direct в Renta

Выберите аккаунт ЯндексаStep 3

Яндекс покажет экран входа со списком прав, которые запрашивает Renta, включая использование API Яндекс.Директа. Выберите аккаунт с доступом к вашим рекламным кампаниям и подтвердите. После этого вы вернётесь в Renta.

Страница входа Яндекса с выбором аккаунта и списком запрашиваемых прав

Назовите подключение и сохранитеStep 4

Завершите настройку:

Source name.
Укажите имя источника данных. Оно используется только в интерфейсе Renta.
Access granted.
Убедитесь, что аккаунт подключён успешно.

Нажмите Save, чтобы завершить.

Если авторизация в Яндексе изменится (например, после смены пароля), нажмите Re-authorize на этом источнике. Подключение обновится на месте, и все построенные на нём пайплайны продолжат работать.

Настройка подключения Yandex Direct с именем источника и предоставленным доступом

Источник созданStep 5

Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.

Список источников с новым источником Yandex Direct

Создание пайплайна

После подключения источника создайте пайплайн, чтобы выгружать данные Yandex Direct в назначение.

Создание пайплайна Yandex Direct

Свяжите источник Yandex Direct с назначением и настройте пайплайн.

Выберите Yandex Direct как источникStep 1

В левом меню нажмите New pipeline. На шаге Source выберите Yandex Direct в разделе Already connected и нажмите Next step.

Шаг выбора источника с Yandex Direct в разделе Already connected

Выберите подключение Yandex DirectStep 2

Выберите созданное ранее подключение Yandex Direct и нажмите Next step.

Выберите назначениеStep 3

На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.

Выберите подключение назначенияStep 4

Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.

Настройка пайплайна

На последнем шаге выберите, какие данные Yandex Direct выгружать и как Renta будет их загружать.

Конфигурация отчёта

Сначала выберите тип отчёта. Он определяет группировку статистики и набор полей, доступных в списке Parameters.

Выбор типа отчёта Yandex Direct с настройками Parameters, Include VAT и Include discount

Тип отчёта	Описание
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	Атрибуты объекта группы объявлений: имя, кампания, тип, подтип, статус, статус показов и параметры отслеживания.

Над типом отчёта появляется список Ad accounts, если подключён агентский аккаунт: в нём перечислены логины клиентов агентства, и пайплайн выгружает данные по выбранному логину. Для обычного рекламного аккаунта выбирать нечего, поэтому Renta скрывает этот список и выгружает данные по самому подключённому аккаунту.

Параметры

Выберите поля для таблицы назначения. Схема набора данных определяется выбранными здесь параметрами.

Выбор параметров Yandex Direct со вкладками Parameters и Selected и кнопкой Select All

Каждая строка списка показывает отображаемое имя, а под ним имя в API: Campaign Id для CampaignId. Именно имя в API становится именем колонки в таблице назначения, а значения, которые Yandex Direct отдаёт пустыми, попадают туда как NULL.

Отметьте нужные поля, найдите поле по имени через поиск или нажмите Select All. Вкладка Selected показывает весь выбор со счётчиком, а список Selected Parameters под выбором позволяет удалить поле.

В отчётах со статистикой доступны календарные поля: с ними можно группировать данные без функций работы с датами на стороне хранилища. Поля по неделям идут в двух вариантах: недели с воскресенья и недели по 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-колонки у них останутся пустыми.

Включите в отчёт параметр Date. С ним таблица назначения партиционируется по колонке date, и Renta загружает данные инкрементально. Он же включает настройку Overwrite Period, которая появляется под диапазоном дат. Без него Renta перезагружает весь диапазон дат при каждом запуске.

Поля Criteria, Criteria Id и Criteria Type нельзя сочетать с UTM-полями и ссылкой объявления. Кроме того, Reports API поддерживает не любую комбинацию полей, поэтому при создании пайплайна Renta проверяет выбранные параметры тестовым запросом. Если комбинация не поддерживается, вы получите ошибку конфигурации: уберите конфликтующие поля и попробуйте снова.

Динамические параметры в ссылках объявлений

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 и Include discount под списком выбранных параметров

Настройка	По умолчанию	Описание
Include VAT	YES	Включать ли НДС в стоимостные метрики. Именно эта настройка меняет Cost, Avg Cpc, Cost Per Conversion и остальные денежные поля.
Include discount	NO	Устаревшая настройка. Yandex Direct отменил агентскую скидку с 1 сентября 2015 года и помечает соответствующий параметр API как устаревший, поэтому на цифры он больше не влияет.

Стоимостные метрики приходят в валюте рекламодателя с двумя знаками после запятой.

Изменение Include VAT меняет стоимостные цифры, которые возвращает Яндекс, но не данные, уже загруженные в таблицу. Исторические строки сохраняют те значения, с которыми были загружены, пока Renta их не перезагрузит.

Имя таблицы и диапазон дат

Задайте имя пайплайна и исторический период для загрузки. Широкий диапазон при первом запуске загружается заметно дольше, чем несколько дней.

Integration name.
Имя пайплайна. Используется только в интерфейсе Renta.
Table name.
Имя таблицы назначения. Можно оставить сгенерированное имя или ввести своё.
Date start.
Первая дата периода выгрузки.
Date end.
Последняя дата периода выгрузки. Можно выбрать фиксированную дату или относительный вариант, например Today.

Период перезаписи

Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске. Настройка появляется после выбора параметра Date.

Выбор периода перезаписи Yandex Direct со значением Last 1 day

При каждом запуске Renta заново запрашивает данные начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, более старые данные не затрагиваются. Варианты идут от Without overwrite data до Overwrite all data; по умолчанию выбран Last 1 day.

Yandex Direct продолжает корректировать статистику задним числом, прежде всего когда отфильтровывает недействительные клики и возвращает их стоимость на баланс кампании. Яндекс указывает, что обычно данные стабилизируются в течение трёх дней, а в редких случаях корректируются и более старые цифры. Задайте период перезаписи не меньше Last 3 days, а для запаса Last 7 days.

Расписание

Выберите, как часто запускать пайплайн.

Тип расписания	Описание
Manual	Пайплайн запускается только вручную через интерфейс или по API.
Daily	Пайплайн запускается раз в сутки в указанное время обновления.
Interval	Пайплайн запускается через заданные интервалы времени.
Cron Expression	Пайплайн запускается по расписанию, заданному cron-выражением.

Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.

Выбор времени обновления и кнопка Create pipeline

Renta также поддерживает запуск по API и интеграцию с внешними оркестраторами, такими как Apache Airflow, Dagster и Prefect. Подробности в документации по расписаниям.

Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.

Список пайплайнов с новой интеграцией Yandex Direct

Ограничения

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.