Getintent
Renta выгружает статистику рекламы Getintent в ваше хранилище данных одним отчётом, который вы собираете сами из измерений и метрик.
Измерения задают группировку: от дневных итогов по кампаниям до строк по отдельным сайтам, приложениям, креативам и сегментам пользователей. Метрики покрывают открутку и стоимость, конверсии, досмотры видео, поведение на сайте и качество трафика.
Аутентификация
Renta аутентифицируется по API key Getintent: это токен, выданный для Getintent Reporting API.
Подключение источника Getintent
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию Advertising и нажмите карточку Getintent.
В поле API key вставьте токен, выданный для Getintent Reporting API.
В поле Source name укажите название источника данных. Оно используется только в интерфейсе Renta.
Нажмите Save. Перед созданием подключения Renta проверит ключ запросом к Getintent Reporting API.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна Getintent
Когда источник подключён, свяжите его с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите Getintent в списке Already connected и нажмите Next step.
Выберите созданное ранее подключение Getintent и нажмите Next step.
На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге соберите отчёт и настройте, как Renta будет его загружать.
Параметры
Выберите поля Getintent, которые попадут в таблицу назначения. Выбранные параметры задают и группировку отчёта, и схему таблицы.
| Название | Имя в API | Описание |
|---|---|---|
OS text | os | Operating system |
Day date | day | Day timestamp |
SSP text | ssp | Supply-side platform |
City text | city | City |
Hour int | hour | Hour of the day |
Month int | month | Month of the year |
App ID text | app_id | Application ID |
Domain text | domain | Domain |
Is App boolean | is_app | Is application |
Minute int | minute | Minute of the hour |
Second int | second | Second of the minute |
Tag ID text | tag_id | Tag ID |
Browser text | browser | Browser |
Country text | country | Country |
Site ID int | site_id | Site ID |
User ID text | user_id | User ID |
Is Video boolean | is_video | Is video content |
Is Native boolean | is_native | Is native content |
Campaign ID int | campaign_id | Campaign ID |
Creative ID int | creative_id | Creative ID |
Device Type text | device_type | Device type |
Domain List expand_field | domain_list | Domain list |
Week Number int | week_number | Week number |
App Category text | app_category | Application category |
Advertiser ID int | advertiser_id | Advertiser ID |
Click Anomaly text | click_anomaly | Click anomaly |
Creative Size text | creative_size | Creative size |
User Segments int | user_segments | User segments |
Carrier ID text | carrier_id_str | Carrier ID (text) |
Unix timestamp int | unix_timestamp | Unix timestamp |
Browser Version text | browser_version | Browser version |
Conversion Name text | conversion_name | Conversion name |
Application List expand_field | application_list | Application list |
Content Category text | content_category | Content category |
Full Region Code text | full_region_code | Full region code |
Top Level Domain text | top_level_domain | Top-level domain |
Campaign Currency text | campaign_currency | Campaign currency |
Campaign Group ID int | campaign_group_id | Campaign group ID |
Video Ad Placement text | videoad_placement | Video ad placement |
DMP Segment Billed text | dmp_segment_billed | DMP segment billed |
Video Inventory Format text | video_inventory_format | Video inventory format |
| Название | Имя в API | Описание |
|---|---|---|
Impressions int | imps | Impressions |
View Rate float | view_rate | View rate |
Unique Impressions int | unique_imps | Unique impressions |
Clicks int | clicks | Clicks |
CPM float | cpm | Cost per thousand impressions |
CPC float | cpc | Cost per click |
CTR float | ctr | Click-through rate |
Budget float | budget | Budget |
PCC int | pcc | Post-click conversions |
APCC int | apcc | Additional post-click conversions |
PVC int | pvc | Post-view conversions |
CPA float | cpa | Cost per acquisition |
Agency Revenue float | ag_rev | Agency revenue |
Agency Revenue Percentage float | ag_rev_prc | Agency revenue percentage |
XClicks int | xclicks | Extra clicks |
Video Completion 25% float | video_completion_25 | Video completion rate at 25% |
Video Completion 50% float | video_completion_50 | Video completion rate at 50% |
Video Completion 75% float | video_completion_75 | Video completion rate at 75% |
Video Completion 100% float | video_completion_100 | Video completion rate at 100% |
Sessions int | an_sessions | Analytics sessions |
Bounce Rate float | an_bounce_rate | Analytics bounce rate |
Pageviews Per Session float | an_pageviews_per_session | Pageviews per session |
Avg. Session Duration float | an_avg_session_duration | Average session duration |
Robots float | robots | Robots detected |
Unique Conversions int | unique_convs | Unique conversions |
Passing Index float | passing_index | Passing index |
Anomaly Impressions int | anomaly_impression | Anomalous impressions |
Параметры разделены на вкладки Dimensions и Metrics. Select All отмечает всё на открытой вкладке.
Когда вы нажимаете Create pipeline, Renta проверяет выбранный набор тестовым запросом к Getintent. Если Getintent отклоняет сочетание измерений и метрик, Renta показывает ошибку и не создаёт пайплайн.
Имя таблицы
Назовите пайплайн и таблицу назначения.
- 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.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.
Стратегия синхронизации
Стратегия синхронизации зависит от того, включено ли в отчёт измерение 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.