Где найти Site ID, Counter ID и API key?

Откройте проект в личном кабинете Calltouch и перейдите в раздел **Интеграции** > **API и Webhooks**. Все три значения указаны на этой вкладке.

Почему не видна настройка Overwrite Period?

Настройка **Overwrite Period** появляется только у отчёта **Call report** с выбранным параметром **Date**. Без **Date** в таблице назначения нет колонки с датой, перезаписывать нечего, и Renta перезагружает весь диапазон дат при каждом запуске.

Почему Lead report перезагружает весь диапазон дат при каждом запуске?

Таблица отчёта **Lead report** не партиционируется по дате, поэтому инкрементальная загрузка для него недоступна. Renta запрашивает весь настроенный диапазон и заменяет данные при каждом запуске. Держите диапазон дат умеренным, чтобы экономить время загрузки и квоту Calltouch API.

Можно ли изменить выбранные параметры после создания пайплайна?

Да, отредактируйте пайплайн и измените набор параметров. Изменение обновляет схему таблицы назначения, поэтому следующий запуск перезагрузит весь настроенный диапазон дат.

Calltouch

Calltouch, сервис коллтрекинга, связывает входящие звонки и заявки с рекламной сессией, из которой пришёл посетитель. Его API отдаёт два набора данных.

Журнал звонков хранит по строке на каждый отслеженный звонок: результат (длительность, статус, признаки целевого и уникального звонка), номера и атрибуцию сессии вплоть до ключевого слова и UTM-меток.
Журнал заявок хранит по строке на каждый лид, будь то форма на сайте или виджет обратного звонка, с той же атрибуцией и вложенными данными заказа и клиента.

Renta выгружает эти данные в ваше хранилище как два типа отчётов: Call report и Lead report.

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

Renta аутентифицируется по трём значениям из вашего аккаунта Calltouch: Site ID, Counter ID и API key. Calltouch показывает все три на одном экране: откройте проект и перейдите в раздел Интеграции > API и Webhooks.

При сохранении подключения Renta проверяет реквизиты тестовым запросом к Calltouch API, поэтому опечатка в Site ID или API key сразу вернёт ошибку на шаге Save, а не сломает первый запуск пайплайна.

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

Выполните эти шаги, чтобы добавить Calltouch как источник в Renta по Site ID, Counter ID и API key.

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

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

Карточка Calltouch в категории Call Tracking каталога Renta

Укажите реквизиты CalltouchStep 2

Заполните три поля значениями со вкладки API и Webhooks вашего проекта Calltouch.

Site ID.
Идентификатор личного кабинета Calltouch.
Counter ID.
Идентификатор счётчика Calltouch, установленного на сайте.
API key.
Токен для Calltouch API.

Страница добавления подключения Calltouch с полями Site ID, Counter ID и API key

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Выберите созданное ранее подключение Calltouch и нажмите Next step. На карточке показан Site ID подключённого аккаунта.

Шаг выбора подключения Calltouch с Site ID на карточке подключения

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

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

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

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

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

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

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

Тип отчёта

Выберите, какой набор данных Calltouch выгружает пайплайн. Один пайплайн загружает один тип отчёта.

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

Тип отчёта	Описание
Call report	Журнал звонков. По строке на каждый отслеженный звонок: результат, номера, статусы и атрибуция сессии (источник, ключевое слово, UTM-метки).
Lead report	Журнал заявок. По строке на каждый лид: атрибуты заявки, атрибуция трафика и вложенные данные заказа и клиента.

Параметры

Выберите поля Calltouch, которые попадут в таблицу назначения.

Панель выбора параметров Calltouch с вкладками Parameters и Selected и кнопкой Select All

Найдите параметр по имени через строку поиска или нажмите Select All. Вкладка Selected показывает всё выбранное, а список Selected Parameters под панелью позволяет убрать параметр.

Отчёт Call report включает следующие поля.

Группа	Параметры
Звонок	Call ID, Date, Call Phase, Duration, Waiting Connect, Manager, Caller Number, Redirect Number, Phone Number, Subpool Name, Orders
Признаки звонка	Successful, Status Details, Unique Call, Target Call, Unique Target Call, Callback Call, Attribution
Атрибуция трафика	Source, Medium, Keyword, URL, Call URL, Referrer, Hostname, UTM Source, UTM Medium, UTM Campaign, UTM Content, UTM Term
Посетитель	City, IP Address, User Agent
Идентификаторы	Session ID, CT Caller ID, Client ID, Yandex Client ID, SIP Call ID, Site ID

Отчёт Lead report включает следующие поля.

Группа	Параметры
Заявка	Request ID, Request Number, Request Type, dateLeadCreated, DateUnix, Date String, Subject, Manager, Status, Request URL, Widget Info
Признаки заявки	Unique Request, Target Request, Unique Target Request, Attribution
Атрибуция трафика	Source, Medium, Keywords, Referrer, Entry URL, UTM Source, UTM Medium, UTM Campaign, UTM Content, UTM Term, Yandex Direct, Google AdWords, DCM
Посетитель	City, IP Address, Device, Operating System, Browser Name, Browser User Agent
Идентификаторы	Session ID, CT Client ID, CT Global ID, GUA Client ID, Yandex Client ID, Site ID
Вложенные объекты	Order [Object], Client [Object]

Order [Object] и Client [Object] загружаются как вложенные записи: суммы и статусы заказа, а также имя клиента и до десяти телефонов и контактов.

Включите параметр Date в отчёте Call report. С ним каждая строка содержит дату звонка, таблица назначения партиционируется по колонке date, и Renta загружает данные инкрементально. Без него Renta перезагружает весь диапазон дат при каждом запуске.

Имя таблицы

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

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

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

Диапазон дат

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

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

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

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

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

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

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

Записи Calltouch продолжают меняться после дня создания: звонку назначается менеджер, обновляются детали заказа и статусы сделок. Окно перезаписи как раз и доносит эти изменения до таблицы назначения.

Настройка Overwrite Period появляется только у отчёта Call report с выбранным параметром Date.

Расписание

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

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

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

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

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

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

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

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

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

Стратегия синхронизации зависит от типа отчёта и от того, выбран ли параметр Date.

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальное обновление	Call report (с выбранным параметром Date)	Каждая строка содержит дату звонка, таблица назначения партиционируется по колонке `date`. При каждом запуске Renta перезагружает окно от последнего успешного запуска минус период перезаписи до конца диапазона дат: эти дневные партиции удаляются и вставляются заново, более старые партиции не меняются.
Полная перезагрузка	Call report (без параметра Date), Lead 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.