Calltouch Source

Renta поддерживает экспорт данных из Calltouch в следующие пункты назначения:

  • Google BigQuery
  • Clickhouse
  • SQL Server
  • Google Spreadsheets

Создание интеграции в хранилище данных (DWH)

  1. Перейдите в каталог интеграций;
  2. Выберите Calltouch;
  3. Добавьте аккаунт Calltouch, в котором находятся необходимые данные;
  4. Выберите добавленный аккаунт Calltouch;
  5. Укажите место назначения, в которое вы хотите импортировать данные;
  6. Перейдите на экран настроек и установите необходимую конфигурацию:

Report type

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

Name Description
Calls Returns all calls data.
Requests Returns all requests data.
Orders Returns all orders data.

Parameters

Параметры — содержат список параметров и метрик, доступных для экспорта. Укажите необходимые для выгрузки параметры.

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

Фильтры

Call attribution model

С помощью этой настройки вы можете выбрать, как будут фильтроваться выгружаемые данные: по последнему взаимодействию или по последнему непрямому.

Bind to

С помощью этой настройки вы можете связать свой отчет либо с датой звонков, либо с датой сеанса.

Unique

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

Target

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

Unique-Target

С помощью этой настройки вы можете комбинировать предыдущие 2 фильтра: уникальные таргетированные, неуникальные таргетированные или оба.

Callback

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

With orders

С помощью этой настройки вы можете выбрать, как будут фильтроваться выгружаемые данные: по связанным с транзакциями или по не связанным с транзакциями.

Date range type

Диапазон дат — укажите период, за который необходимо экспортировать данные. Вы можете указать любой исторический временной интервал.

Чтобы выбрать необходимое время, введите в поле «From» дату, с которой вы хотите начать выгрузку данных, затем введите дату окончания в поле «To».

Если вы хотите, чтобы данные в таблице обновлялись ежедневно и дополнялись новыми днями, тогда в поле «To» укажите «Yesterday».
Подробная инструкция по работе с диапазоном дат

Integration name

Имя интеграции — при создании интеграции автоматически генерируется её имя. В этом поле вы можете переименовать название интеграции. Разрешены как кириллица, так и латиница, но не более 100 символов.

Название интеграции отображается на странице Integration List.

Table name

Имя таблицы — при создании интеграции автоматически генерируется имя таблицы, которая будет создана в DWH. В этом поле вы можете переименовать её.

Разрешена только латиница, цифры и символ «_».

Update time

Время обновления — вы можете указать любое время обновления, которое вам нужно. Рента обновляет интеграции ежедневно в интервале выбранного часа. 

Обычно наши пользователи выбирают время обновления интеграций рано утром, например, в 5 утра. В этом случае ваша интеграция будет обновляться в период с 5 утра до 6 утра. 

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

Overwrite period

Период перезаписи данных — это ретроспективное обновление данных за выбранный период.

Например, вы выбираете период перезаписи «Последние 7 дней» — это означает, что все данные за последние 7 дней будут удалены из таблицы и вставлены снова с обновленными данными.

Примечание: данная настройка доступна только в том случае, если был выбран параметр с типом date или dateTime. 

Создание интеграции в Google Spreadsheets

Воспользуйтесь бесплатным расширением, доступным в Google Workspace Marketplace. Для этого:

  1. Установите расширение Renta Spreadsheets Add-on.
  2. Затем зайдите в Google Sheets, и во вкладке Tools выберите Renta, после чего нажмите кнопку Run. 

После чего в правом сайдбаре откроется рабочая область с настройками интеграций. Подробная инструкция по созданию интеграции доступна по данной ссылке. Обратите внимание, что все созданные интеграции в Google Spreadsheets также доступны для управления в веб-версии Renta. 

Структура данных

Name Description Type
callId The unique identifier for a call in a calltouch. INTEGER
attribution Call attribution model. STRING
callerNumber Caller number STRING
redirectNumber Redirect number If the call forwarding number is not one (the dialing group is configured for several numbers or the call forwarding number is foreign), then the value 'undefined' will be substituted. STRING
date Date of the call DATE
datetime Date and time of the call DATE
waitingConnect Waiting time for a response. INTEGER
duration The duration of the conversation. INTEGER
phoneNumber Called number. STRING
successful Call status STRING
uniqueCall Unique call STRING
targetCall Target call STRING
uniqTargetCall Uniquely targeted call STRING
callbackCall Callback call STRING
source Source STRING
medium Medium STRING
keyword Keyword STRING
url The address where they hit the site. STRING
callUrl The page address on which the visitor made a call. STRING
ref The address from which you went to the site. STRING
utmSource The value of the utm-tag utm_source. STRING
utmMedium The value of the utm-tag utm_medium. STRING
utmCampaign The value of the utm-tag utm_campaign. STRING
utmContent The value of the utm-tag utm_content. STRING
utmTerm The value of the utm-tag utm_term. STRING
sessionId The unique identifier for the calltouch session. INTEGER
clientId The unique identifier for Universal Analytics. STRING
yaClientId The unique ID for Yandex.Metrica. STRING
sipCallId The unique identifier of the session with the Calltouch PBX. Its value is sent to your equipment in case of using SIP trunk redirection. It can be useful when integrating with your PBX. STRING
userAgent Information about the device from which you visited the site. STRING
ip The IP address of the visitor. STRING
order-createdDate contract creation date DATE
order-completedDate date of contract signing DATE
order-orderDate Order date DATE
order-orderNumber Order number STRING
order-plannedAmount Estimated order amount FLOAT
order-completedAmount Real order amount FLOAT
order-phoneNumber Order phone number STRING
order-source Order source STRING
order-sessionId Order session ID STRING
order-utmSource Order utm_source STRING
order-utmMedium Order utm_medium STRING
callreferenceId The unique identificator of the call. STRING
siteId Identificator for the site. STRING
yandexDirect-campaignId Identificator of the campaign from Yandex Direct ad. INTEGER
yandexDirect-adGroupId Identificator of the group from yandex direct ad. INTEGER
yandexDirect-adId Identificator of the ad from Yandex Direct ad. INTEGER
yandexDirect-criteriaId Phrase identificator from Yandex Direct ad. INTEGER
googleAdWords-campaignId Campaigns identificator from Google Adwords ad. INTEGER
googleAdWords-adGroupId Adgroups identificator from Google Adwords ad. INTEGER
googleAdWords-creativeId Identificator of the creative from Google Adwords ad. INTEGER
googleAdWords-criteriaId Identificator of the phrase of the customer from Google Adwords. INTEGER
mapVisits.sessionDate Parameter contains customers visit history. Добавить в маппинг: Array(Nullable(DateTime))
mapVisits.sessionId Parameter contains customers visit history. ARRAY(STRING)
mapVisits.ip Parameter contains customers visit history. ARRAY(STRING)
mapVisits.city Parameter contains customers visit history. ARRAY(STRING)
mapVisits.source Parameter contains customers visit history. ARRAY(STRING)
mapVisits.medium Parameter contains customers visit history. ARRAY(STRING)
mapVisits.keyword Parameter contains visit history. ARRAY(STRING)
mapVisits.url The urls visit history. ARRAY(STRING)
mapVisits.ref Parameter contains customers history. ARRAY(STRING)
mapVisits.utmMedium Utm-tags visit history. ARRAY(STRING)
mapVisits.utmSource Utm-tags visit history. ARRAY(STRING)
mapVisits.utmTerm Utm-tags visit history. ARRAY(STRING)
mapVisits.utmContent Utm-tags visit history. ARRAY(STRING)
mapVisits.utmCampaign Utm-tags visit history. ARRAY(STRING)
mapVisits.guaClientId The identificator of clients visit history. ARRAY(STRING)
callTags.category Category of the calltag. ARRAY(STRING)
callTags.type Type of the calltag. ARRAY(STRING)
callTags.names Names of the calltags. ARRAY(STRING)
date Date of the call DATE
datetime Date and time of the call DATE
source Source STRING
medium Medium STRING
keywords Keywords STRING
url The address where they hit the site. STRING
ref The address from which you went to the site. STRING
utmSource The value of the utm-tag utm_source. STRING
utmMedium The value of the utm-tag utm_medium. STRING
utmCampaign The value of the utm-tag utm_campaign. STRING
utmContent The value of the utm-tag utm_content. STRING
utmTerm The value of the utm-tag utm_term. STRING
sessionId The unique identifier for the calltouch session. INTEGER
guaClientId The unique identifier for Universal Analytics. STRING
yaClientId The unique ID for Yandex.Metrica. STRING
ip The IP address of the visitor. STRING
siteId Identificator for the site. STRING
yandexDirect-campaignId Identificator of the campaign from Yandex Direct ad. INTEGER
yandexDirect-adGroupId Identificator of the group from yandex direct ad. INTEGER
yandexDirect-adId Identificator of the ad from Yandex Direct ad. INTEGER
yandexDirect-criteriaId Phrase identificator from Yandex Direct ad. INTEGER
googleAdWords-campaignId Campaigns identificator from Google Adwords ad. INTEGER
googleAdWords-adGroupId Adgroups identificator from Google Adwords ad. INTEGER
googleAdWords-creativeId Identificator of the creative from Google Adwords ad. INTEGER
googleAdWords-criteriaId Identificator of the phrase of the customer from Google Adwords. INTEGER
mapVisits.sessionDate Parameter contains customers visit history. Добавить в маппинг: Array(Nullable(DateTime))
mapVisits.sessionId Parameter contains customers visit history. ARRAY(STRING)
mapVisits.ip Parameter contains customers visit history. ARRAY(STRING)
mapVisits.city Parameter contains customers visit history. ARRAY(STRING)
mapVisits.source Parameter contains customers visit history. ARRAY(STRING)
mapVisits.medium Parameter contains customers visit history. ARRAY(STRING)
mapVisits.keyword Parameter contains visit history. ARRAY(STRING)
mapVisits.url The urls visit history. ARRAY(STRING)
mapVisits.ref Parameter contains customers history. ARRAY(STRING)
mapVisits.utmMedium Utm-tags visit history. ARRAY(STRING)
mapVisits.utmSource Utm-tags visit history. ARRAY(STRING)
mapVisits.utmTerm Utm-tags visit history. ARRAY(STRING)
mapVisits.utmContent Utm-tags visit history. ARRAY(STRING)
mapVisits.utmCampaign Utm-tags visit history. ARRAY(STRING)
mapVisits.guaClientId The identificator of clients visit history. ARRAY(STRING)
requestType Type of the request. STRING
browser Customers browser. STRING
city Customers city. STRING
attribution Call attribution model. STRING
subject The voluntary forms name on users website. STRING
uniqTargetRequest The unique target request. BIT
uniqueRequest The unique request. BIT
requestNumber The number of the request. STRING
requestId The identificator of the request. INTEGER
targetRequest The target Request. BIT
status Status. STRING
client_fio Clients full name. STRING
client_clientId The clients identificator. INTEGER
client_phones.phoneNumber The phone number of client. ARRAY(STRING)
client_phones.phoneType Type of the phone. ARRAY(STRING)
client_contacts.contactType The contact type of clients. ARRAY(STRING)
client_contacts.contactValue Array that contains clients email. ARRAY(STRING)
date Date of the call DATE
datetime Date and time of the call DATE
visit_source Source STRING
visit_medium Transition channel. STRING
visit_keyword The keyword order. STRING
visit_utmSource The value of the utm-tag utm_source. STRING
visit_utmMedium The value of the utm-tag utm_medium. STRING
visit_utmCampaign The value of the utm-tag utm_campaign. STRING
visit_utmContent The value of the utm-tag utm_content. STRING
visit_utmTerm The value of the utm-tag utm_term. STRING
siteId Identificator for the site. STRING
requestType Type of the request. STRING
client_fio Clients full name. STRING
completedAmount Completed Amount. FLOAT
isDeleted Shows if the order is deleted or not. BIT
manager Manager that is responsible for the order. STRING
orderNumber Number of the order. STRING
orderDate Date of the order. STRING
order_callId The identificator of call. INTEGER
order_duration Duration of the order. FLOAT
order_phoneNumber Phone number of the order. STRING
order_type Type of the order. STRING
order_ani STRING
order_dateCall Orders date of the call. STRING
order_requestNumber Number of request order. STRING
orderStatus Status of the order. STRING
plannedAmount Deals budget. FLOAT
service Services name that is using Calltouch API. STRING
 
_______________________________________________
Если у вас есть вопросы — свяжитесь с нами!