Где взять API base URL и API key?

Base URL совпадает с адресом, по которому вы открываете панель Scaleo, например https://yournetwork.scaletrk.com . API key выдаётся в панели Scaleo, в настройках профиля. При нажатии **Save** Renta проверяет пару тестовым запросом к Scaleo, поэтому ошибка в адресе или просроченный ключ обнаружатся на шаге **Save**, а не на первом запуске пайплайна.

Можно ли соединить конверсии с кликами?

Да. Отчёты Clicks и Conversions используют один набор полей, и каждая конверсия содержит Click ID клика, из которого она произошла. Соединяйте таблицы по этой колонке.

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

Scaleo отдаёт даты и время в часовом поясе, настроенном для вашей сети. Значения Added Timestamp и Date в таблице назначения следуют этому часовому поясу.

Почему Payout и Revenue загружаются в текстовые колонки?

Scaleo возвращает денежные значения строками, и Renta сохраняет их без преобразования. Приведите эти колонки к числовому типу в SQL, когда строите отчёты поверх таблицы.

Scaleo

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

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

Авторизация

Renta подключается к Scaleo по двум значениям из аккаунта вашей сети: API base URL и API key.

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

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

Выполните эти шаги, чтобы добавить Scaleo как источник в Renta по API base URL и API key.

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

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

Карточка Scaleo в категории Finance каталога Renta

Укажите base URL и API keyStep 2

API base URL.
Адрес вашей панели Scaleo, например https://yournetwork.scaletrk.com.
API key.
Ключ, выданный в панели Scaleo, в настройках профиля.

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

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

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

Нажмите Save. Перед созданием подключения Renta проверит реквизиты запросом к вашей сети Scaleo.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

На последнем шаге выберите отчёт, его поля и способ загрузки.

Тип отчёта

В выпадающем списке Report Types выберите, какой отчёт Scaleo загружает пайплайн. Один пайплайн загружает один отчёт. Для каждого нужного отчёта создайте отдельный пайплайн.

Настройки пайплайна Scaleo с выпадающим списком Report Types и выбранным Conversions

Тип отчёта	Описание
Clicks (клики)	Каждый зарегистрированный в сети клик отдельной строкой.
Conversions (конверсии)	Каждая конверсия отдельной строкой вместе с Click ID клика, из которого она произошла.
Invoices (счета)	Счета на выплаты партнёрам: суммы, статусы, расчётные периоды и способы оплаты.

Параметры

Отметьте поля Scaleo, которые попадут в таблицу назначения.

Пикер параметров Scaleo со списком полей, вкладкой Selected и кнопкой Select All

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

Отчёты Clicks и Conversions используют один набор полей.

Группа	Параметры
Транзакция	Transaction ID, Added Timestamp, Click ID, Suspicious
Деньги	Payout, Profit, Revenue, Currency
Трекинговые параметры	Sub ID 1-5, Aff Param 1-5, Aff Click ID
Структура сети	Affiliate ID, Affiliate Value, Advertiser ID, Advertiser Value, Offer ID, Offer Value, Goal ID, Goal Value, Goal Parent ID, Goal Parent Value, Goal Type ID, Goal Type Value, Link ID, Link Value, Link Parent ID, Link Parent Value, Creative ID, Creative Value, Creative Parent ID, Creative Parent Value
Трафик	Source, Deep Link URL, Click Referer URL, Language
Устройство и сеть	Device Type Code, Device Type Value, Device Brand, Device Model, Device OS, Device OS Version, Browser, Browser Version, Connection Type, Mobile Operator, IP, IDFA, GAID
Геолокация	Geo Country Code, Geo Country, Geo Region, Geo City

У отчёта Invoices свой набор полей.

Группа	Параметры
Счёт	ID, Invoice Number, Status, Period, Date
Суммы	Amount Value, Amount Currency, Referral Commission Value, Referral Commission Currency
Партнёр	Affiliate ID, Affiliate Name
Способ оплаты	Payment Method ID, Payment Method Title, Payment Method Info, Payment Method Image, Payment Method Metadata
Прочее	Attachment, Internal Notes, Offers, Goal Types

Scaleo возвращает денежные значения строками, поэтому Payout, Profit, Revenue и суммы счетов загружаются в текстовые колонки. Приведите их к числовому типу в SQL, когда строите отчёты.

В отчёте Invoices поля Offers и Goal Types загружаются вложенными массивами с идентификатором и названием, а Payment Method Metadata загружается JSON-колонкой.

Включите Added Timestamp в Clicks и Conversions и Date в Invoices. С этим полем таблица назначения партиционируется по дням, и Renta загружает данные инкрементально. Без него Renta перезагружает весь диапазон дат при каждом запуске.

Имя таблицы

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

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

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

Диапазон дат

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

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

Для Clicks и Conversions диапазон охватывает момент регистрации транзакции. Для Invoices он охватывает дату счёта. Scaleo трактует даты в часовом поясе, настроенном для вашей сети.

Расписание

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

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

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

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

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

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

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

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

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

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

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальное обновление	Clicks (с выбранным Added Timestamp), Conversions (с выбранным Added Timestamp), Invoices (с выбранным Date)	Таблица назначения партиционируется по дням колонки `added_timestamp` (`date` для Invoices). При каждом запуске Renta заново запрашивает отчёт со дня последнего успешного запуска до конца диапазона дат и заменяет эти дневные партиции. Партиции за более ранние дни Renta не трогает.
Полная перезагрузка	Clicks (без Added Timestamp), Conversions (без Added Timestamp), Invoices (без Date)	В таблице нет колонки даты для партиционирования, поэтому 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.