Display & Video 360
Renta выгружает в ваше хранилище данных статистику Display & Video 360 вместе с кампаниями, заказами на ра змещение, строками заказа, креативами и другими объектами аккаунта.
Отчёт со статистикой вы собираете сами из измерений и метрик Bid Manager, поэтому в одной строке лежит одна комбинация выбранных измерений.
Объектные типы отчётов описывают аккаунт таким, какой он сейчас: идентификаторы, названия, статусы, бюджеты, сроки и стратегии ставок.
Аутентификация
Renta использует OAuth для аутентификации в Google. Вас перенаправит на страницу Google, где вы дадите Renta доступ к аккаунту Display & Video 360.
У Google одно общее разрешение на сущности и отчёты, поэтому на экране согласия упоминаются изменение и удаление. В структуру ваших кампаний Renta ничего не пишет. Она создаёт временный запрос отчёта, скачивает результат и удаляет запрос.
Подключение Display & Video 360 как источника
- В консоли Renta откройте Connections > Catalog в левом меню.
- Раскройте категорию Advertising и нажмите на карточку Display & Video 360.
Нажмите Log in to your Display & Video 360 account. Renta перенаправит вас в Google, где вы выбираете аккаунт с доступом к нужным партнёрам и рекламодателям.
Google перечисляет два разрешения, которые запрашивает Renta: сущности и отчёты Display & Video 360 и отчёты в DoubleClick Bid Manager. Нажмите Allow, чтобы вернуться в Renta.
Завершите настройку:
- Source name.
Название подключения, оно используется только внутри консоли Renta. - Access granted.
Почта аккаунта Google, который выдал доступ.
Нажмите Save.
Подключение появляется в списке Sources со статусом Active и готово к использованию в пайплайнах.
Создание пайплайна
Пайплайн связывает подключение Display & Video 360 с назначением, куда попадут данные.
Создание пайплайна Display & Video 360
В левом меню нажмите New pipeline. Оставьте выбранной вкладку ETL, найдите Display & Video 360 в разделе Already connected и нажмите Next step.
Выберите созданное подключение Display & Video 360 и нажмите Next step. На карточке виден аккаунт Google, которому она принадлежит. Это выручает, когда в воркспейсе лежат подключения от нескольких аккаунтов.
На шаге Destination выберите хранилище, куда пойдут данные, и нажмите Next step.
Выберите подключение назначения и нажмите Next step.
Настройка пайплайна
Последний шаг мастера собирает все настройки в одну прокручиваемую форму.
Партнёры
Партнёры ограничивают пайплайн частью вашего аккаунта Display & Video 360.
В списке партнёры, доступные авторизованному аккаунту Google, под названием каждого стоит числовой идентификатор. Отметьте хотя бы одного для любого типа отчёта, кроме Partners: он охватывает весь аккаунт сам по себе.
Рекламодатели
Рекламодатели определяют, чьи кампании, объекты и статистику загрузит пайплайн.
Отмечайте столько, сколько нужно. Все они попадут в одну таблицу. Типы отчётов Partners и Advertisers эту настройку игнорируют, остальным она обязательна.
Тип отчёта
Тип отчёта определяет, что именно выгружает пайплайн.
| Тип отчёта | Описание |
|---|---|
Custom Report | Статистика по выбранным рекламодателям с группировкой по вашим измерениям. Собирается через Bid Manager, поэтому охватывает те же поля, что и отчёт, построенный в интерфейсе Display & Video 360. |
Partners | Партнёрские аккаунты, доступные авторизованному аккаунту Google, с часовым поясом, валютой, платёжным профилем, настройками рекламного сервера и доступа к данным и списком включённых бирж. |
Advertisers | Рекламодатели выбранных партнёров с доменом, часовым поясом, валютой, платёжным профилем и настройками креативов и показов. |
Campaigns | Кампании выбранных рекламодателей с типом цели, целевым показателем, планируемым расходом, сроками и ограничением частоты. |
Insertion Orders | Заказы на размещение с сегментами бюджета, темпом расхода, KPI, партнёрскими издержками, стратегией ставок и сроками. |
Line Items | Строки заказа с типом, сроками, распределением бюджета, темпом расхода, ограничением частоты, моделью дохода партнёра, привязанными креативами и стратегией ставок. |
Creatives | Креативы с типом, источником хостинга, размерами в пикселях, статусом модерации и результатами проверки на каждой бирже. |
Параметры
Отметьте поля Display & Video 360, которые станут колонками таблицы назначения.
Для Custom Report в списке лежит весь справочник Bid Manager: сначала измерения, по которым группируется отчёт, затем метрики. Записей там сотни, поэтому до знакомого поля быстрее всего добраться через строку поиска. В отчёте должна быть хотя бы одна метрика.
Date и Advertiser Currency отмечены заранее, снять их нельзя. По Date партиционируется таблица назначения. Advertiser Currency требует API для любого отчёта с метрикой расходов или дохода.
Денежные метрики кастомного отчёта приходят в валюте рекламодателя. Процентные метрики теряют по дороге знак процента, поэтому CTR 0,601% сохраняется числом 0.601.
Объектные типы отчётов сохраняют форму API Display & Video 360. Денежные поля в них приходят в микроединицах, то есть в одной миллионной валюты, поэтому дневное ограничение расхода 25 придёт как 25000000. Настройки, которые API возвращает одним из нескольких вариантов объекта, например Bid Strategy и Integration Details, сохраняются как JSON, а повторяющиеся блоки вроде Budget Segments и Partner Costs становятся массивами записей.
Имя интеграции и таблицы
Задайте название пайплайна в Renta и имя таблицы в назначении.
- Integration name.
Название пайплайна в консоли Renta. - Table name.
Таблица в вашем назначении. Оставьте сгенерированное имя или впишите своё.
Диапазон дат
Диапазон дат задаёт историю, которую пайплайн загрузит на первом запуске.
- Date start.
Первый день статистики. - Date end.
Последний день, фиксированная дата или подвижная граница вроде Today.
Период перезаписи
Период перезаписи определяет, насколько глубоко каждый запуск по расписанию перезагружает уже загруженные дни.
Display & Video 360 продолжает уточнять свежие дни, пока досчитываются конверсии и уточняются расходы. Именно окно перезаписи переносит эти правки в таблицу, поэтому берите окно не короче срока, за который у вас досчитываются конверсии. Вариант Without overwrite data загружает только дни, появившиеся после прошлого запуска.
Расписание
Расписание определяет, как часто запускается пайплайн. Время, указанное здесь, Renta читает в UTC.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную из консоли Renta или через API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается с заданным интервалом. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время начала каждого запуска) и нажмите Create pipeline.
Сохранение пайплайна занимает на несколько секунд больше обычного: в этот момент Renta проверяет вашу подборку полей в Display & Video 360. После проверки пайплайн появляется в разделе Pipelines на вкладке ETL вместе с именем таблицы назначения, прогрессом запуска и числом выгруженных строк.
Стратегия синхронизации
В таблице ниже описано, как Renta синхронизирует каждый тип отчёта Display & Video 360.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Custom Report | Таблица назначения партиционируется по Date. Каждый запуск охватывает дни, появившиеся после прошлого запуска, плюс окно перезаписи, удаляет партиции этих дней и записывает их заново с теми цифрами, которые Display & Video 360 отдаёт сейчас. |
| Полная перезагрузка | Partners, Advertisers, Campaigns, Insertion Orders, Line Items, Creatives | Эти типы отчётов содержат текущие атрибуты объектов, партиционировать их не по чему, поэтому каждый запуск заменяет всю таблицу состоянием аккаунта на этот момент. |
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.