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. 

NameDescription
CallsReturns all calls data.
RequestsReturns all requests data.
OrdersReturns 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. 

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

NameDescriptionType
callIdThe unique identifier for a call in a calltouch.INTEGER
attributionCall attribution model.STRING
callerNumberCaller numberSTRING
redirectNumberRedirect 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
dateDate of the callDATE
datetimeDate and time of the callDATE
waitingConnectWaiting time for a response.INTEGER
durationThe duration of the conversation.INTEGER
phoneNumberCalled number.STRING
successfulCall statusSTRING
uniqueCallUnique callSTRING
targetCallTarget callSTRING
uniqTargetCallUniquely targeted callSTRING
callbackCallCallback callSTRING
sourceSourceSTRING
mediumMediumSTRING
keywordKeywordSTRING
urlThe address where they hit the site.STRING
callUrlThe page address on which the visitor made a call.STRING
refThe address from which you went to the site.STRING
utmSourceThe value of the utm-tag utm_source.STRING
utmMediumThe value of the utm-tag utm_medium.STRING
utmCampaignThe value of the utm-tag utm_campaign.STRING
utmContentThe value of the utm-tag utm_content.STRING
utmTermThe value of the utm-tag utm_term.STRING
sessionIdThe unique identifier for the calltouch session.INTEGER
clientIdThe unique identifier for Universal Analytics.STRING
yaClientIdThe unique ID for Yandex.Metrica.STRING
sipCallIdThe 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
userAgentInformation about the device from which you visited the site.STRING
ipThe IP address of the visitor.STRING
order-createdDatecontract creation dateDATE
order-completedDatedate of contract signingDATE
order-orderDateOrder dateDATE
order-orderNumberOrder numberSTRING
order-plannedAmountEstimated order amountFLOAT
order-completedAmountReal order amountFLOAT
order-phoneNumberOrder phone numberSTRING
order-sourceOrder sourceSTRING
order-sessionIdOrder session IDSTRING
order-utmSourceOrder utm_sourceSTRING
order-utmMediumOrder utm_mediumSTRING
callreferenceIdThe unique identificator of the call.STRING
siteIdIdentificator for the site.STRING
yandexDirect-campaignIdIdentificator of the campaign from Yandex Direct ad.INTEGER
yandexDirect-adGroupIdIdentificator of the group from yandex direct ad.INTEGER
yandexDirect-adIdIdentificator of the ad from Yandex Direct ad.INTEGER
yandexDirect-criteriaIdPhrase identificator from Yandex Direct ad.INTEGER
googleAdWords-campaignIdCampaigns identificator from Google Adwords ad.INTEGER
googleAdWords-adGroupIdAdgroups identificator from Google Adwords ad.INTEGER
googleAdWords-creativeIdIdentificator of the creative from Google Adwords ad.INTEGER
googleAdWords-criteriaIdIdentificator of the phrase of the customer from Google Adwords.INTEGER
mapVisits.sessionDateParameter contains customers visit history.Добавить в маппинг: Array(Nullable(DateTime))
mapVisits.sessionIdParameter contains customers visit history.ARRAY(STRING)
mapVisits.ipParameter contains customers visit history.ARRAY(STRING)
mapVisits.cityParameter contains customers visit history.ARRAY(STRING)
mapVisits.sourceParameter contains customers visit history.ARRAY(STRING)
mapVisits.mediumParameter contains customers visit history.ARRAY(STRING)
mapVisits.keywordParameter contains visit history.ARRAY(STRING)
mapVisits.urlThe urls visit history.ARRAY(STRING)
mapVisits.refParameter contains customers history.ARRAY(STRING)
mapVisits.utmMediumUtm-tags visit history.ARRAY(STRING)
mapVisits.utmSourceUtm-tags visit history.ARRAY(STRING)
mapVisits.utmTermUtm-tags visit history.ARRAY(STRING)
mapVisits.utmContentUtm-tags visit history.ARRAY(STRING)
mapVisits.utmCampaignUtm-tags visit history.ARRAY(STRING)
mapVisits.guaClientIdThe identificator of clients visit history.ARRAY(STRING)
callTags.categoryCategory of the calltag.ARRAY(STRING)
callTags.typeType of the calltag.ARRAY(STRING)
callTags.namesNames of the calltags.ARRAY(STRING)
dateDate of the callDATE
datetimeDate and time of the callDATE
sourceSourceSTRING
mediumMediumSTRING
keywordsKeywordsSTRING
urlThe address where they hit the site.STRING
refThe address from which you went to the site.STRING
utmSourceThe value of the utm-tag utm_source.STRING
utmMediumThe value of the utm-tag utm_medium.STRING
utmCampaignThe value of the utm-tag utm_campaign.STRING
utmContentThe value of the utm-tag utm_content.STRING
utmTermThe value of the utm-tag utm_term.STRING
sessionIdThe unique identifier for the calltouch session.INTEGER
guaClientIdThe unique identifier for Universal Analytics.STRING
yaClientIdThe unique ID for Yandex.Metrica.STRING
ipThe IP address of the visitor.STRING
siteIdIdentificator for the site.STRING
yandexDirect-campaignIdIdentificator of the campaign from Yandex Direct ad.INTEGER
yandexDirect-adGroupIdIdentificator of the group from yandex direct ad.INTEGER
yandexDirect-adIdIdentificator of the ad from Yandex Direct ad.INTEGER
yandexDirect-criteriaIdPhrase identificator from Yandex Direct ad.INTEGER
googleAdWords-campaignIdCampaigns identificator from Google Adwords ad.INTEGER
googleAdWords-adGroupIdAdgroups identificator from Google Adwords ad.INTEGER
googleAdWords-creativeIdIdentificator of the creative from Google Adwords ad.INTEGER
googleAdWords-criteriaIdIdentificator of the phrase of the customer from Google Adwords.INTEGER
mapVisits.sessionDateParameter contains customers visit history.Добавить в маппинг: Array(Nullable(DateTime))
mapVisits.sessionIdParameter contains customers visit history.ARRAY(STRING)
mapVisits.ipParameter contains customers visit history.ARRAY(STRING)
mapVisits.cityParameter contains customers visit history.ARRAY(STRING)
mapVisits.sourceParameter contains customers visit history.ARRAY(STRING)
mapVisits.mediumParameter contains customers visit history.ARRAY(STRING)
mapVisits.keywordParameter contains visit history.ARRAY(STRING)
mapVisits.urlThe urls visit history.ARRAY(STRING)
mapVisits.refParameter contains customers history.ARRAY(STRING)
mapVisits.utmMediumUtm-tags visit history.ARRAY(STRING)
mapVisits.utmSourceUtm-tags visit history.ARRAY(STRING)
mapVisits.utmTermUtm-tags visit history.ARRAY(STRING)
mapVisits.utmContentUtm-tags visit history.ARRAY(STRING)
mapVisits.utmCampaignUtm-tags visit history.ARRAY(STRING)
mapVisits.guaClientIdThe identificator of clients visit history.ARRAY(STRING)
requestTypeType of the request.STRING
browserCustomers browser.STRING
cityCustomers city.STRING
attributionCall attribution model.STRING
subjectThe voluntary forms name on users website.STRING
uniqTargetRequestThe unique target request.BIT
uniqueRequestThe unique request.BIT
requestNumberThe number of the request.STRING
requestIdThe identificator of the request.INTEGER
targetRequestThe target Request.BIT
statusStatus.STRING
client_fioClients full name.STRING
client_clientIdThe clients identificator.INTEGER
client_phones.phoneNumberThe phone number of client.ARRAY(STRING)
client_phones.phoneTypeType of the phone.ARRAY(STRING)
client_contacts.contactTypeThe contact type of clients.ARRAY(STRING)
client_contacts.contactValueArray that contains clients email.ARRAY(STRING)
dateDate of the callDATE
datetimeDate and time of the callDATE
visit_sourceSourceSTRING
visit_mediumTransition channel.STRING
visit_keywordThe keyword order.STRING
visit_utmSourceThe value of the utm-tag utm_source.STRING
visit_utmMediumThe value of the utm-tag utm_medium.STRING
visit_utmCampaignThe value of the utm-tag utm_campaign.STRING
visit_utmContentThe value of the utm-tag utm_content.STRING
visit_utmTermThe value of the utm-tag utm_term.STRING
siteIdIdentificator for the site.STRING
requestTypeType of the request.STRING
client_fioClients full name.STRING
completedAmountCompleted Amount.FLOAT
isDeletedShows if the order is deleted or not.BIT
managerManager that is responsible for the order.STRING
orderNumberNumber of the order.STRING
orderDateDate of the order.STRING
order_callIdThe identificator of call.INTEGER
order_durationDuration of the order.FLOAT
order_phoneNumberPhone number of the order.STRING
order_typeType of the order.STRING
order_aniSTRING
order_dateCallOrders date of the call.STRING
order_requestNumberNumber of request order.STRING
orderStatusStatus of the order.STRING
plannedAmountDeals budget.FLOAT
serviceServices name that is using Calltouch API.STRING
 
_______________________________________________
Если у вас есть вопросы — свяжитесь с нами!