Renta поддерживает экспорт данных из Calltouch в следующие пункты назначения:
- Google BigQuery
- Clickhouse
- SQL Server
- Google Spreadsheets
Создание интеграции в хранилище данных (DWH)
- Перейдите в каталог интеграций;
- Выберите Calltouch;
- Добавьте аккаунт Calltouch, в котором находятся необходимые данные;
- Выберите добавленный аккаунт Calltouch;
- Укажите место назначения, в которое вы хотите импортировать данные;
- Перейдите на экран настроек и установите необходимую конфигурацию:
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. Для этого:
- Установите расширение Renta Spreadsheets Add-on.
- Затем зайдите в 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 |
Если у вас есть вопросы — свяжитесь с нами!