Почему конверсии за последние дни изменились после первой загрузки?

LinkedIn относит конверсии к кликам и просмотрам задним числом, в пределах окон атрибуции до 30 дней. Конверсия, которая произошла сегодня, добавляется к статистике того дня, когда по объявлению кликнули. Задайте **Overwrite Period** не меньше **Last 7 days**, чтобы Renta перезагружала эти дни при каждом запуске и подхватывала пересчитанные значения.

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

Нет, пайплайн выгружает данные одного рекламного аккаунта. Чтобы загрузить несколько аккаунтов, создайте по пайплайну на аккаунт: они могут использовать одно и то же подключение LinkedIn.

Нужно ли периодически переподключать LinkedIn?

Нет. Renta автоматически обновляет токен доступа LinkedIn при каждом запуске. Если LinkedIn отзовёт доступ (например, вы сменили пароль или удалили приложение), запуски будут завершаться ошибкой об истёкшем доступе к аккаунту LinkedIn Ads. Нажмите **Re-authorize** на источнике, и построенные на нём пайплайны продолжат работать.

LinkedIn Ads

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

Renta выгружает любой из четырёх в хранилище данных. Готовый шаблон загружает таблицы статистики и метаданных вместе.

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

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

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

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

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

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

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

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

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

Нажмите Log in to your LinkedIn Ads account. Вы будете перенаправлены в LinkedIn, чтобы войти и подтвердить права, которые запрашивает Renta. Если в браузере уже есть авторизованная сессия LinkedIn, подтверждение проходит сразу, и вы возвращаетесь в Renta.

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

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

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

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

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

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

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

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

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

Список источников с новым источником LinkedIn Ads

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Тип интеграции

Выберите способ настройки пайплайна: собрать отчёт самостоятельно или начать с шаблона.

Выбор типа интеграции LinkedIn Ads: Custom report и Pre-built templates

Тип интеграции	Описание
Custom report	Вы сами выбираете тип отчёта, поля и настройки загрузки. Дальше в статье описан именно этот путь.
Pre-built templates	Предопределённый набор пайплайнов с фиксированным набором полей. Вы выбираете только рекламный аккаунт и шаблон.

Renta предлагает один шаблон: LinkedIn Ads Performance report. Он создаёт сразу три пайплайна: дневной Ad statistics report с полями date, Creative ID и 19 метриками расходов, конверсий и вовлечённости, а также снимки Campaign metadata report и Ad metadata report.

Пайплайн статистики создаётся с периодом перезаписи Last 7 days. Таблицы в назначении получают префикс la_.

Шаблон Performance report

Три пайплайна шаблона, список полей каждой таблицы и ключи соединения.

Настройка отчёта

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

Выбор рекламного аккаунта и типа отчёта LinkedIn Ads

Ad accounts Список содержит все рекламные аккаунты, доступные авторизованному профилю LinkedIn. Для выгрузки статистики достаточно роли Viewer на аккаунте. Пайплайн выгружает данные одного аккаунта, поэтому для нескольких аккаунтов создайте по пайплайну на каждый.

Report Types Выберите тип отчёта для выгрузки.

Тип отчёта	Описание
Ad statistics report	Дневная статистика по каждому объявлению: показы, клики, расход, конверсии, лиды, вовлечённость, метрики видео, каруселей и документов.
Ad metadata report	Текущие атрибуты каждого объявления: имя, идентификаторы кампании и аккаунта, статус модерации, статус показа, даты создания и изменения.
Campaign metadata report	Текущие атрибуты каждой кампании: имя, статус, цель, формат, тип оплаты, бюджет, расписание и флаги настроек.
Account metadata report	Текущие атрибуты подключённого рекламного аккаунта: имя, идентификатор, тип, статус и валюта.

Ad statistics report всегда группируется по объявлению и дню. Итоги по кампаниям и аккаунту считаются агрегацией выгруженных строк в хранилище. Отчёты метаданных присоединяются по идентификаторам кампании и аккаунта.

Параметры

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

Список параметров LinkedIn Ads с вкладками Parameters и Selected и кнопкой Select All

Каждая строка списка показывает имя поля, а под ним имя колонки в таблице назначения: actionClicks становится колонкой action_clicks.

Отметьте поля для выгрузки, ищите поле по имени через поиск и проверяйте выбор на вкладке Selected. Список Selected Parameters под пикером позволяет убрать поле.

Ad statistics report содержит расход в двух полях: cost_in_local_currency (валюта рекламного аккаунта) и cost_in_usd.

Идентификаторы вроде Creative ID и Campaign ID выгружаются простыми числами, поэтому таблица статистики соединяется с таблицами метаданных напрямую.

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

API отчётности LinkedIn возвращает не больше 20 полей за запрос, поэтому в Ad statistics report помимо date и Creative ID может входить не больше 19 полей с метриками. Select All выбирает весь список из 71 поля, и создание завершается ошибкой: Too many fields requested. Maximum possible fields to request: 20. Renta проверяет выбор тестовым запросом при создании пайплайна, поэтому ошибку видно сразу, а не на первом запуске.

Имя таблицы

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

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

Диапазон дат

Задайте исторический период загрузки. По умолчанию Date start равен первому дню текущего месяца, а Date end установлен в Today.

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

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

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

Выбор периода перезаписи LinkedIn Ads со значением Last 3 days

При каждом запуске Renta заново запрашивает данные начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, а более старые данные остаются нетронутыми.

Варианты: от Without overwrite data до Overwrite all data. По умолчанию выбран Last 3 days.

LinkedIn относит конверсии к кликам и просмотрам задним числом, в пределах окон атрибуции до 30 дней, поэтому конверсии за последние дни продолжают меняться после загрузки. Задайте период перезаписи не меньше Last 7 days, а чтобы покрыть самое длинное окно атрибуции, выберите Last 30 days.

Расписание

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

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

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

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

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

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

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

Ограничения

API отчётности LinkedIn задаёт рамки, которые действуют для каждого пайплайна на этом источнике.

Ограничение	Описание
Полей в отчёте	API возвращает не больше 20 полей за запрос. На практике в Ad statistics report помещаются `date`, `Creative ID` и до 19 полей с метриками.
Глубина дневной статистики	LinkedIn хранит статистику с дневной детализацией примерно за последние шесть месяцев. Более ранний Date start ничего не вернёт за ту часть диапазона, которая выходит за это окно.
Гранулярность статистики	Ad statistics report всегда группируется по объявлению с дневной детализацией. Итоги по кампаниям и аккаунту агрегируются в хранилище.
Нет истории в отчётах метаданных	Ad metadata report, Campaign metadata report и Account metadata report возвращают текущее состояние объектов, без истории изменений.

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

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

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальное обновление	Ad statistics report (с выбранным параметром date)	Каждая строка несёт свою дату, и таблица назначения партиционируется по колонке `date`. При каждом запуске Renta запрашивает окно от последнего успешного запуска минус период перезаписи: затронутые дневные партиции удаляются и вставляются заново, а более старые остаются нетронутыми.
Полная перезагрузка	Ad statistics report (без параметра date)	В таблице нет колонки даты для партиционирования, поэтому Renta запрашивает статистику за весь настроенный диапазон дат и заменяет датасет при каждом запуске.
Полная перезагрузка	Ad metadata report, Campaign metadata report, Account metadata report	Эти отчёты возвращают текущее состояние объявлений, кампаний и аккаунта и не имеют поля даты, поэтому 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.