Где взять API-ключ Getintent?

Ключ выдаёт Getintent для своего Reporting API. При сохранении подключения Renta проверяет ключ тестовым запросом к Getintent, поэтому недействительный или истёкший ключ отклоняется на шаге **Save**, а не на первом запуске пайплайна.

Почему не видна настройка Overwrite Period?

Настройка **Overwrite Period** появляется только при выбранном измерении **Day**. Без **Day** в таблице назначения нет колонки с датой, перезаписывать нечего, и Renta перезагружает весь диапазон дат при каждом запуске.

В каком часовом поясе статистика?

Getintent отдаёт отчёты по московскому времени (UTC+3). Значения **Day** и **Hour** в таблице назначения соответствуют этому часовому поясу, поэтому цифры за календарный день могут отличаться от дашбордов с другим часовым поясом.

Можно ли изменить выбранные измерения и метрики после создания пайплайна?

Да, отредактируйте пайплайн и измените набор параметров. Изменение обновляет схему таблицы назначения, поэтому следующий запуск перезагрузит весь настроенный диапазон дат.

Getintent

Getintent, DSP-платформа для программатик-закупки рекламы, отдаёт статистику через Reporting API одним отчётом. Его форму вы задаёте сами: измерения определяют группировку, метрики определяют показатели. Метрики покрывают открутку и стоимость (показы, клики, CPM, CPC, CPA), post-click и post-view конверсии, досмотры видео по квартилям, поведение на сайте (сессии, показатель отказов) и качество трафика (роботы, аномальные показы).

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

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

Renta аутентифицируется по API key Getintent: это токен, выданный для Getintent Reporting API.

При сохранении подключения Renta проверяет ключ тестовым запросом к Getintent Reporting API, поэтому недействительный или истёкший ключ сразу вернёт ошибку, а не сломает первый запуск пайплайна.

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

Выполните эти шаги, чтобы добавить Getintent как источник в Renta по API-ключу.

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

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

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

Укажите API-ключStep 2

В поле API key вставьте токен, выданный для Getintent Reporting API.

Страница добавления подключения Getintent с полем API key

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

В поле Source name укажите название источника данных. Оно используется только в интерфейсе Renta.

Нажмите Save. Перед созданием подключения Renta проверит ключ запросом к Getintent Reporting API.

Настройка подключения Getintent с полем имени источника и кнопкой Save

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

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

Список источников с новым источником Getintent в статусе Active

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

После подключения источника создайте пайплайн, чтобы синхронизировать данные Getintent с вашим назначением.

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

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

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

В левом меню нажмите New pipeline. На шаге Source выберите Getintent в списке Already connected и нажмите Next step.

Шаг выбора источника с Getintent в списке Already connected

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

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

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

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

Шаг выбора назначения с Google BigQuery в списке Already connected

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

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

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

На последнем шаге соберите отчёт и настройте, как Renta будет его загружать.

Параметры

Выберите поля Getintent, которые попадут в таблицу назначения. Выбранные параметры задают и группировку отчёта, и схему таблицы.

Выбор параметров Getintent с вкладками Dimensions, Metrics и Selected и кнопкой Select All

Параметры разделены на вкладки Dimensions и Metrics. Ищите параметр по названию через поле поиска или нажмите Select All. Вкладка Selected показывает всё выбранное, а список Selected Parameters под полем позволяет убрать параметр.

На вкладке Dimensions отметьте поля, задающие группировку отчёта.

Группа	Измерения
Время	Day, Hour, Minute, Second, Month, Week Number, Unix timestamp
Структура кампаний	Advertiser ID, Campaign Group ID, Campaign ID, Campaign Currency, Creative ID, Creative Size
Инвентарь	SSP, Site ID, Tag ID, Domain, Top Level Domain, Domain List, App ID, App Category, Application List, Content Category, Is App, Is Video, Is Native, Video Ad Placement, Video Inventory Format
Аудитория и окружение	Country, City, Full Region Code, OS, Browser, Browser Version, Device Type, Carrier ID, User ID, User Segments, DMP Segment Billed
Конверсии и качество трафика	Conversion Name, Click Anomaly

На вкладке Metrics отметьте показатели для выгрузки.

Группа	Метрики
Открутка	Impressions, Unique Impressions, Clicks, XClicks, CTR, View Rate
Стоимость	CPM, CPC, CPA, Budget, Agency Revenue, Agency Revenue Percentage
Конверсии	PCC (post-click конверсии), APCC (дополнительные post-click конверсии), PVC (post-view конверсии), Unique Conversions
Видео	Video Completion 25%, Video Completion 50%, Video Completion 75%, Video Completion 100%
Поведение на сайте	Sessions, Bounce Rate, Pageviews Per Session, Avg. Session Duration
Качество трафика	Robots, Anomaly Impressions, Passing Index

Включите измерение Day. С ним каждая строка таблицы назначения соответствует одному дню, таблица партиционируется по колонке day, и Renta загружает данные инкрементально. Без него Renta перезагружает весь диапазон дат при каждом запуске.

Когда вы нажимаете Create pipeline, Renta проверяет выбранный набор тестовым запросом к Getintent. Если Getintent отклоняет сочетание измерений и метрик, Renta показывает ошибку и не создаёт пайплайн.

Имя таблицы

Назовите пайплайн и таблицу назначения.

Поля имени интеграции и имени таблицы Getintent

Integration name.
Название пайплайна. Используется только в интерфейсе Renta.
Table name.
Имя таблицы назначения. Можно оставить автоматически сгенерированное имя или ввести своё.

Диапазон дат

Задайте исторический период загрузки.

Date start.
Первая дата периода выгрузки.
Date end.
Последняя дата периода выгрузки. Оставьте Today, чтобы продолжать собирать новые данные при каждом запуске.

Getintent отдаёт отчёты по московскому времени (UTC+3). Значения Day и Hour в таблице назначения соответствуют этому часовому поясу.

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

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

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

Настройка Overwrite Period появляется только при выбранном измерении Day. Getintent атрибуцирует post-view конверсии к показам прошлых дней, поэтому держите период перезаписи в несколько дней, если выгружаете PVC или другие метрики конверсий.

Расписание

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

Выбор типа расписания Getintent с отмеченным вариантом Daily

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

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

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

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

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

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

Стратегия синхронизации

Стратегия синхронизации зависит от того, включено ли в отчёт измерение Day.

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальное обновление	Отчёт Getintent (с выбранным измерением Day)	Каждая строка соответствует одному дню, таблица назначения партиционируется по колонке `day`. При каждом запуске Renta перезагружает окно от последнего успешного запуска минус период перезаписи до конца диапазона дат: эти дневные партиции удаляются и вставляются заново, более старые партиции не меняются.
Полная перезагрузка	Отчёт Getintent (без измерения Day)	В таблице нет колонки с датой для партиционирования, поэтому 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.