Scaleo
Renta выгружает в ваше хранилище данных три отчёта Scaleo: клики, конверсии и счета на выплаты партнёрам.
Каждый клик и каждая конверсия загружается отдельной строкой: в ней суммы, трекинговые параметры и данные об устройстве и местоположении посетителя. Счета содержат суммы выплат, их статусы и способы оплаты.
Авторизация
Renta подключается к Scaleo по двум значениям из аккаунта вашей сети: API base URL и API key.
Подключение источника Scaleo
Перейдите в каталогStep 1
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию Finance и нажмите карточку Scaleo.
Укажите base URL и API keyStep 2
- API base URL.
Адрес вашей панели Scaleo, напримерhttps://yournetwork.scaletrk.com. - API key.
Ключ, выданный в панели Scaleo, в настройках профиля.
Назовите подключение и сохранитеStep 3
В поле Source name укажите имя источника. Оно используется только в интерфейсе Renta.
Нажмите Save. Перед созданием подключения Renta проверит реквизиты запросом к вашей сети Scaleo.
Источник созданStep 4
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна Scaleo
Выберите Scaleo как источникStep 1
В левом меню нажмите New pipeline. На шаге Source выберите Scaleo в списке Already connected и нажмите Next step.
Выберите подключение ScaleoStep 2
Выберите созданное ранее подключение Scaleo и нажмите Next step.
Выберите назначениеStep 3
На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назн аченияStep 4
Выберите подключение назначения, в которое загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите отчёт, его поля и способ загрузки.
Тип отчёта
В выпадающем списке Report Types выберите, какой отчёт Scaleo загружает пайплайн. Один пайплайн загружает один отчёт. Для каждого нужного отчёта создайте отдельный пайплайн.
| Тип отчёта | Описание |
|---|---|
| Clicks (клики) | Каждый зарегистрированный в сети клик отдельной строкой. |
| Conversions (конверсии) | Каждая конверсия отдельной строкой вместе с Click ID клика, из которого она произошла. |
| Invoices (счета) | Счета на выплаты партнёрам: су ммы, статусы, расчётные периоды и способы оплаты. |
Параметры
Отметьте поля Scaleo, которые попадут в таблицу назначения.
| Название | Имя в API | Описание |
|---|---|---|
ID int | id | Unique identifier of the invoice. |
Invoice Number text | invoice_number | Human-readable invoice number (e.g. INV-AFF-0037-002). |
Status text | status | Current status of the invoice (e.g. paid, unpaid, draft). |
Period text | period | Human-readable billing period covered by the invoice (e.g. Feb 1 - Feb 28, 2026). |
Date datetime | date | Date and time the invoice was created. |
Amount Value text | amount_value | Invoice amount as a string (e.g. '1941.00'). Extracted from amount.value. |
Amount Currency text | amount_currency | Currency of the invoice amount (e.g. USD). Extracted from amount.currency. |
Referral Commission Value text | referral_commission_value | Referral commission amount as a string. Extracted from referral_commission.value. |
Referral Commission Currency text | referral_commission_currency | Currency of the referral commission. Extracted from referral_commission.currency. |
Affiliate ID int | affiliate_id | Unique identifier of the affiliate. Extracted from affiliate.id. |
Affiliate Name text | affiliate_name | Display name of the affiliate. Extracted from affiliate.name. |
Payment Method ID int | payment_method_id | Unique identifier of the payment method. Extracted from payment_method.id. |
Payment Method Title text | payment_method_title | Title of the payment method (e.g. USDT TRC-20). Extracted from payment_method.title. |
Payment Method Info text | payment_method_info | Payment destination details such as wallet address. Extracted from payment_method.info. |
Payment Method Image text | payment_method_image | URL of the payment method logo image. Extracted from payment_method.image. |
Payment Method Metadata json | payment_method_metadata | Metadata about the payment method change — who changed it and when. Stored as JSON due to deep nesting. |
Attachment text | attachment | URL or path to an attached file for the invoice. Empty string if no attachment. |
Internal Notes text | internal_notes | Internal notes for the invoice, may contain transaction URLs or free text. |
Offers structure | offers | List of offers associated with the invoice. |
Goal Types structure | goal_types | List of goal types (conversion types) associated with the invoice. |
| Название | Имя в API | Описание |
|---|---|---|
Transaction ID text | transaction_id | Unique identifier of the click transaction. |
Added Timestamp datetime | added_timestamp | Date and time when the click was registered (tenant timezone). |
Click ID text | click_id | Internal Scaleo click identifier. |
Payout text | payout | Affiliate payout amount as a string (e.g. '0.000000'). |
Profit text | profit | Network profit amount as a string. |
Revenue text | revenue | Advertiser revenue amount as a string. |
Currency text | currency | Currency code for payout/profit/revenue (e.g. USD). |
Sub ID 1 text | sub_id1 | Custom sub-ID value #1 passed from traffic source. |
Sub ID 2 text | sub_id2 | Custom sub-ID value #2 passed from traffic source. |
Sub ID 3 text | sub_id3 | Custom sub-ID value #3 passed from traffic source. |
Sub ID 4 text | sub_id4 | Custom sub-ID value #4 passed from traffic source. |
Sub ID 5 text | sub_id5 | Custom sub-ID value #5 passed from traffic source. |
Aff Param 1 text | aff_param1 | Custom affiliate parameter #1. |
Aff Param 2 text | aff_param2 | Custom affiliate parameter #2. |
Aff Param 3 text | aff_param3 | Custom affiliate parameter #3. |
Aff Param 4 text | aff_param4 | Custom affiliate parameter #4. |
Aff Param 5 text | aff_param5 | Custom affiliate parameter #5. |
Aff Click ID text | aff_click_id | External click identifier passed by the affiliate/traffic source. |
Deep Link URL text | deep_link_url | Deep link destination URL if used. |
Click Referer URL text | click_referer_url | HTTP referer URL recorded at click time. |
Source text | source | Traffic source label, if configured. |
Language text | language | Language detected for the click. |
Connection Type text | connection_type | Network connection type (e.g. WiFi / Cable, Mobile Internet). |
Mobile Operator text | mobile_operator | Mobile carrier if detected. |
IDFA text | idfa | Apple Identifier for Advertisers. |
GAID text | gaid | Google Advertising ID. |
IP text | ip | Visitor IP address recorded at click time. |
Device Brand text | device_brand | Device brand (e.g. Apple, Samsung). |
Device Model text | device_model | Device model (e.g. iPhone). |
Device OS text | device_os | Operating system name (e.g. iOS, Android). |
Device OS Version text | device_os_version | Operating system version string. |
Browser text | browser | Browser name (e.g. Mobile Safari). |
Browser Version text | browser_version | Browser version string. |
Suspicious text | suspicious | Flag set by Scaleo fraud checks. Empty string when not suspicious. |
Affiliate ID int | affiliate_id | Affiliate identifier. Extracted from affiliate.id. |
Affiliate Value text | affiliate_value | Affiliate display name. Extracted from affiliate.value. |
Advertiser ID int | advertiser_id | Advertiser identifier. Extracted from advertiser.id. |
Advertiser Value text | advertiser_value | Advertiser display name. Extracted from advertiser.value. |
Offer ID int | offer_id | Offer identifier. Extracted from offer.id. |
Offer Value text | offer_value | Offer display name. Extracted from offer.value. |
Goal ID int | goal_id | Goal identifier. Extracted from goal.id. |
Goal Value text | goal_value | Goal display name. Extracted from goal.value. |
Goal Parent ID int | goal_parent_id | Parent offer ID for the goal. Extracted from goal.parent_id. |
Goal Parent Value text | goal_parent_value | Parent offer name for the goal. Extracted from goal.parent_value. |
Goal Type ID int | goal_type_id | Goal type identifier. Extracted from goal_type.id. |
Goal Type Value text | goal_type_value | Goal type name. Extracted from goal_type.value. |
Link ID int | link_id | Link identifier. Extracted from link.id. |
Link Value text | link_value | Link display name. Extracted from link.value. |
Link Parent ID int | link_parent_id | Parent offer ID for the link. Extracted from link.parent_id. |
Link Parent Value text | link_parent_value | Parent offer name for the link. Extracted from link.parent_value. |
Creative ID int | creative_id | Creative identifier. Extracted from creative.id. |
Creative Value text | creative_value | Creative display name. Extracted from creative.value. |
Creative Parent ID int | creative_parent_id | Parent offer ID for the creative. Extracted from creative.parent_id. |
Creative Parent Value text | creative_parent_value | Parent offer name for the creative. Extracted from creative.parent_value. |
Device Type Code text | device_type_type | Device type code. Extracted from device_type.type. |
Device Type Value text | device_type_value | Device type display name (e.g. smartphone). Extracted from device_type.value. |
Geo Country Code text | geo_country_code | ISO country code. Extracted from geo.country_code. |
Geo Country text | geo_country | Country name. Extracted from geo.country. |
Geo Region text | geo_region | Region/state name. Extracted from geo.region. |
Geo City text | geo_city | City name. Extracted from geo.city. |
| Название | Имя в API | Описание |
|---|---|---|
Transaction ID text | transaction_id | Unique identifier of the click transaction. |
Added Timestamp datetime | added_timestamp | Date and time when the click was registered (tenant timezone). |
Click ID text | click_id | Internal Scaleo click identifier. |
Payout text | payout | Affiliate payout amount as a string (e.g. '0.000000'). |
Profit text | profit | Network profit amount as a string. |
Revenue text | revenue | Advertiser revenue amount as a string. |
Currency text | currency | Currency code for payout/profit/revenue (e.g. USD). |
Sub ID 1 text | sub_id1 | Custom sub-ID value #1 passed from traffic source. |
Sub ID 2 text | sub_id2 | Custom sub-ID value #2 passed from traffic source. |
Sub ID 3 text | sub_id3 | Custom sub-ID value #3 passed from traffic source. |
Sub ID 4 text | sub_id4 | Custom sub-ID value #4 passed from traffic source. |
Sub ID 5 text | sub_id5 | Custom sub-ID value #5 passed from traffic source. |
Aff Param 1 text | aff_param1 | Custom affiliate parameter #1. |
Aff Param 2 text | aff_param2 | Custom affiliate parameter #2. |
Aff Param 3 text | aff_param3 | Custom affiliate parameter #3. |
Aff Param 4 text | aff_param4 | Custom affiliate parameter #4. |
Aff Param 5 text | aff_param5 | Custom affiliate parameter #5. |
Aff Click ID text | aff_click_id | External click identifier passed by the affiliate/traffic source. |
Deep Link URL text | deep_link_url | Deep link destination URL if used. |
Click Referer URL text | click_referer_url | HTTP referer URL recorded at click time. |
Source text | source | Traffic source label, if configured. |
Language text | language | Language detected for the click. |
Connection Type text | connection_type | Network connection type (e.g. WiFi / Cable, Mobile Internet). |
Mobile Operator text | mobile_operator | Mobile carrier if detected. |
IDFA text | idfa | Apple Identifier for Advertisers. |
GAID text | gaid | Google Advertising ID. |
IP text | ip | Visitor IP address recorded at click time. |
Device Brand text | device_brand | Device brand (e.g. Apple, Samsung). |
Device Model text | device_model | Device model (e.g. iPhone). |
Device OS text | device_os | Operating system name (e.g. iOS, Android). |
Device OS Version text | device_os_version | Operating system version string. |
Browser text | browser | Browser name (e.g. Mobile Safari). |
Browser Version text | browser_version | Browser version string. |
Suspicious text | suspicious | Flag set by Scaleo fraud checks. Empty string when not suspicious. |
Affiliate ID int | affiliate_id | Affiliate identifier. Extracted from affiliate.id. |
Affiliate Value text | affiliate_value | Affiliate display name. Extracted from affiliate.value. |
Advertiser ID int | advertiser_id | Advertiser identifier. Extracted from advertiser.id. |
Advertiser Value text | advertiser_value | Advertiser display name. Extracted from advertiser.value. |
Offer ID int | offer_id | Offer identifier. Extracted from offer.id. |
Offer Value text | offer_value | Offer display name. Extracted from offer.value. |
Goal ID int | goal_id | Goal identifier. Extracted from goal.id. |
Goal Value text | goal_value | Goal display name. Extracted from goal.value. |
Goal Parent ID int | goal_parent_id | Parent offer ID for the goal. Extracted from goal.parent_id. |
Goal Parent Value text | goal_parent_value | Parent offer name for the goal. Extracted from goal.parent_value. |
Goal Type ID int | goal_type_id | Goal type identifier. Extracted from goal_type.id. |
Goal Type Value text | goal_type_value | Goal type name. Extracted from goal_type.value. |
Link ID int | link_id | Link identifier. Extracted from link.id. |
Link Value text | link_value | Link display name. Extracted from link.value. |
Link Parent ID int | link_parent_id | Parent offer ID for the link. Extracted from link.parent_id. |
Link Parent Value text | link_parent_value | Parent offer name for the link. Extracted from link.parent_value. |
Creative ID int | creative_id | Creative identifier. Extracted from creative.id. |
Creative Value text | creative_value | Creative display name. Extracted from creative.value. |
Creative Parent ID int | creative_parent_id | Parent offer ID for the creative. Extracted from creative.parent_id. |
Creative Parent Value text | creative_parent_value | Parent offer name for the creative. Extracted from creative.parent_value. |
Device Type Code text | device_type_type | Device type code. Extracted from device_type.type. |
Device Type Value text | device_type_value | Device type display name (e.g. smartphone). Extracted from device_type.value. |
Geo Country Code text | geo_country_code | ISO country code. Extracted from geo.country_code. |
Geo Country text | geo_country | Country name. Extracted from geo.country. |
Geo Region text | geo_region | Region/state name. Extracted from geo.region. |
Geo City text | geo_city | City name. Extracted from geo.city. |
Под каждым полем пикер показывает имя будущей колонки в таблице назначения. Select All отмечает весь список сразу, а вкладка Selected хранит всё уже выбранное.
Scaleo возвращает денежные значения строками, поэтому Payout, Profit, Revenue и суммы счетов загружаются в текстовые колонки. Приведите их к числовому типу в SQL, когда строите отчёты.
В отчёте Invoices поля Offers и Goal Types загружаются вложенными массивами с идентификатором и названием, а Payment Method Metadata загружается JSON-колонкой.
Имя таблицы
Назовите пайплайн и таблицу назначения.
- Integration name.
Имя пайплайна. Используется только в интерфейсе Renta. - Table name.
Имя таблицы назначения. Можно оставить автоматически сгенерированное имя или задать своё.
Диапазон дат
Задайте исторический период загрузки.
- Date start.
Первая дата периода выгрузки. - Date end.
Последняя дата периода выгрузки. Оставьте Today, чтобы продолжать собирать новые данные при каждом запуске.
Для Clicks и Conversions диапазон охватывает момент регистрации транзакции. Для Invoices он охватывает дату счёта. Scaleo трактует даты в часовом поясе, настроенном для вашей сети.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в заданное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily задайте Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где видны его запуски, прогресс и имя таблицы назначения.
Стратегия синхронизации
Стратегия синхронизации зависит от того, включено ли в отчёт поле даты.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | 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.