Виджет — это готовый встраиваемый онлайн-калькулятор и форма оформления продуктов, представленных на платформе.
Инструмент позволяет сторонним сайтам, веб-мастерам и страховым агентам интегрировать функционал покупки страховок напрямую в свой интерфейс. Пользователи их сайта могут самостоятельно рассчитывать стоимость и покупать полисы (ОСАГО, ипотеку), а пользователь платформы Инссмарт будет получать комиссионное вознаграждение (КВ).
Все созданные пользователем виджеты находятся в разделе «Инструменты продаж», подразделе «Виджет». После создания данного модуля он будет отображаться в списке внизу страницы. Там имеется возможность включить или отключить виджет, скопировать его, удалить или заблокировать. Если кнопка имеет вид значка «Play» (▶), то виджет активен (включён). Если кнопка имеет вид значка «Pause» (❚❚), то виджет не активен (отключён).
Имеется возможность осуществить конкретизированный поиск благодаря удобному фильтру. В нём имеется: строка поиска, которая работает по ключевым словам (в данном случае — по домену виджета).
КАК ПОСТАВИТЬ ВИДЖЕТ/МОДУЛЬ
-
Нужно найти меню, через которое идёт процесс создания виджета.
Для этого необходимо зайти в раздел «Инструменты продаж» и нажать на переход в подраздел «Виджет», после чего появится возможность создать новый виджет, нажав на кнопку «+ Создать». -
Раздел «Основное».
Первое, что предлагает выбрать меню создания, — Название.
2.1 Название — наименование виджета. Название не будет отображаться в самом виджете, поэтому можно указать любое, по которому вам будет легко его найти.
2.2 Домен — уникальный текстовый адрес сайта в интернете, который пользователи вводят в строку браузера, чтобы открыть веб-страницу (например, yandex.ru или inssmart.ru). В поле «Домен» нужно указать домен вашего сайта или, если собственного сайта у вас нет, просто inssmart.ru. -
Авторизация.
3.1 Авторизация через ваш сервер (флаг) — авторизация через сервис пользователя предполагает управление базой клиентов в виджете на стороне владельца виджета, используя его структуру и id. Это позволяет «бесшовно» встроить виджет в личный кабинет без формы регистрации клиента в новой системе.
ВАЖНО! Если флаг проставлен, но авторизация не была настроена, виджет не будет работать. Тут два варианта: либо корректно настроить авторизацию, либо убрать данный флаг. В случае внесения изменений (смены галочки) пользователь должен поменять текст кода в своём виджете из раздела «Виджет/модуль» дополнительных настроек, так как код обновится.
Как это работает:
При встраивании виджета вам необходимо указать параметр data-auth="true". Если он выставлен, авторизация осуществляется на вашей стороне. Также параметр data-auth можно передать идентификатор вашего пользователя, чтобы уменьшить количество запросов на авторизацию. -
html
Помимо кода встраивания виджета, указанного выше, вам необходимо добавить на страницу код, который обрабатывает запрос на авторизацию от виджета.
https://yoursite.com/token — это пример, вместо него необходимо указать адрес и путь к обработчику запроса на вашем сервере.
- html
На вашем сервере необходимо реализовать приём запроса от виджета и получение токена клиента через API Инссмарт. Прямое обращение со страницы виджета недопустимо из соображений безопасности, так как там передаётся privateKey.
Получение токена клиента:
- text
curl --location 'https://api.inssmart.ru/v1/widget/clients/token' \
--header 'cache-control: no-cache' \
--header 'Content-Type: application/json' \
--data '{
"privateKey": "<<ваш privateKey>>",
"appGuid": "<<ваш appGuid>>",
"description": "Иванов Иван Иванович",
"partnerId": "2",
"parentPartnerId": "1"
-
}'
Пример ответа: -
json
{
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXV…",
"refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpX…"
-
}
Пример реализации на Node.js (Express): -
javascript
app.post('/token', (req, res, next) => {
axios.post('https://api.inssmart.ru/v1/widget/clients/token', {
appGuid: '<<ваш appGuid>>',
privateKey: '<<ваш privateKey>>',
partnerId: '2',
parentPartnerId: '1',
description: 'Иванов Иван Иванович',
}).then( response => {
res.set('Content-Type', 'text/json');
res.send(response.data);
}).catch( error => {
res.set('Content-Type', 'text/json');
res.status(400);
res.send({
error: error.data ? error.data.message : 'Bad request'
});
})
-
});
Описание параметров:-
appGuid — строка (guid), обязательный — идентификатор приложения, вы видите его в настройках виджета.
-
privateKey — строка (guid), обязательный — закрытый ключ, он также доступен в настройках виджета.
-
partnerId — строка, обязательный — идентификатор клиента в вашей системе, как правило хранится в сессии и JWT-токене.
-
parentPartnerId — строка — родительский идентификатор клиента в вашей системе. Используется в многоуровневых клиентских системах, например когда у вашего клиента есть своя клиентская подсеть. По токену родительского пользователя доступны все полисы в рамках своей клиентской подсети.
-
description — строка — текстовое описание пользователя для удобства навигации и отчётности.
-
-
Если клиента ранее не существовало — он будет создан, и вы получите токен; либо будет возвращён токен существующего клиента.
3.2 ID приложения — это технический идентификатор интеграции, который проставляется платформой автоматически.
3.3 Закрытый ключ — при создании виджета на платформе Инссмарт это секретный цифровой пароль безопасности (токен), который формируется системой автоматически. -
Раздел «Интеграция».
4.1 Отображать чат поддержки (флаг) — если нужно, чтобы в вашем виджете отображалось окно чата с нашей службой поддержки. Пользователи виджета смогут увидеть, что общаются со специалистами Инссмарт, и получат полноценную консультацию по любому вопросу, связанному с оформлением полисов.
4.2 Отображать список полисов (флаг) — если нужно, чтобы пользователи виджета видели те полисы, которые оформили через виджет ранее. Каждый пользователь будет видеть только свои полисы.
4.3 Отображать заявки (флаг) — если нужно дать пользователям возможность оформлять полисы через индивидуальное согласование (заявки). Это даст больше возможностей для оформления, но потребует от пользователей загрузки документов.
4.4 Тариф — эта опция актуальна для полисов ипотечного страхования. Вы можете выставить здесь автоматическую скидку или надбавку к тарифам за счёт своего КВ; она действует не для всех СК, однако в случае применения пользователь виджета со своей стороны не будет видеть дополнительных пометок.
4.5 Продукты — здесь выбирается из выпадающего списка страховых продуктов, которые будут доступны для пользователей виджета. Доступны для выбора: ОСАГО, Антиклещ, Ипотека, КАСКО, миниКАСКО, ВЗР, Имущество, добровольное страхование титула.
Если в выпадающем списке нет продукта, то реализовать на данный момент его через виджет не представляется возможным.
4.6 Основная страница — выбор того, какой из продуктов будет отображаться в виджете первым по умолчанию.
4.7 Ресурс при успешной оплате — здесь можно указать ссылку, на которую пользователь будет переадресован в случае успешной оплаты полиса.
4.8 Ресурс при неуспешной оплате — здесь можно указать ссылку, на которую пользователь будет переадресован в случае, если оплата полиса не пройдёт. -
Раздел «Дополнительные настройки».
5.1 Виджет/модуль — это блок кода, который вы сможете встроить непосредственно на свой сайт. -
html
5.2 Прямая ссылка — это ссылка для ваших клиентов, переходя по которой они сразу попадут в настроенную вами форму для оформления полисов.
-
text
-
https://widgets.inssmart.ru/contract/mortgage?appId=<<ваш appId>>&secret=<<ваш secret>>
5.3 Лендинг — это автоматически создаваемый мини-сайт, который также будет содержать настроенную вами форму для оформления полисов. -
text
-
https://widgets.inssmart.ru/mortgage?appId=<<ваш appId>>&secret=<<ваш secret>>
-
Раздел «Настройки».
6.1 Заголовок — это название модуля, которое отображается для пользователей виджета в самом верху виджета на сайте.
6.2 Используемый шрифт — здесь выбираем используемый для заголовка и подзаголовка шрифт. Доступны для выбора: Future PT, Roboto, Open Sans, Montserrat, Manrope.
6.3 Подзаголовок — дополнительный короткий текст, который отображается сразу под основным заголовком калькулятора.
6.4 Отображать заголовки (флаг) — отмечаем, если нужно, чтобы выбранные заголовок и подзаголовок отображались для пользователей.
6.5 Цветовая гамма модуля — здесь можно выбрать цвета для основных элементов модуля. Их можно как вводить через шестнадцатеричный код (HEX), так и выбрать из палитры вручную.
6.6 Отображать КВ (флаг) — отмечаем, если нужно, чтобы клиенты/сотрудники видели размер КВ по полису.
6.7 Отображать буллеты (флаг) — отмечаем, если нужно, чтобы отображались ключевые преимущества оформления («Никаких комиссий», «Предрасчёт за 5 минут» и т.д.).
6.8 Отображать баннер (флаг) — отмечаем, если нужно, чтобы в виджете отображались актуальные баннеры Inssmart.
6.9 Отображать логотип Inssmart — отмечаем, если нужно, чтобы в виджете отображался наш логотип.
6.10 Отображать секцию вопрос-ответ — отмечаем, если нужно, чтобы в виджете отображался раздел с часто задаваемыми вопросами пользователей (например, «Что можно застраховать?», «Как оплатить полис» и так далее).
6.11 Позиционирование содержимого — выбираем, как будут расположены поля и данные в модуле (выравнивать данные по правой или левой стороне или отображаться в центре).
6.12 Отображать виджет на полный экран (флаг) — выбираем, если нужно, чтобы модуль отображался у пользователя на полном экране.
6.13 Фон поля — можно выбрать цвет для полей ввода данных со стороны пользователя (по умолчанию стоит белый). -
Раздел «Аналитика».
Аналитика — это инструмент отслеживания действий пользователей внутри вашего калькулятора и фиксации эффективности продаж.
Аналитика помогает отслеживать следующие опции:-
Контроль воронки продаж: показывает, на каком именно этапе расчёта уходят пользователи (например, заполняют данные ТС, но бросают форму на этапе ввода паспорта).
-
Учёт конверсии: позволяет сопоставить количество посетителей страницы сайта с числом реальных расчётов и оплаченных полисов.
-
Оптимизация рекламы: помогает понять, какие каналы трафика приводят клиентов, доходящих до оплаты страховки.
-
-
Доступные цели для сбора информации аналитики: создание черновика, запущены предложения, получена ссылка на оплату, создана заявка, выбрано предложение.
Доступны следующие счётчики по интеграции для сбора аналитики:
Яндекс Метрика. Отслеживать события можно следующим образом:-
Необходимо зайти на сайт Яндекс Метрики https://metrika.yandex.ru/list. Для того чтобы подключить цели, у вас уже должен быть счётчик, который отслеживает статистику по виджету.
-
Чтобы перейти к созданию цели, нажмите на кнопку «Создать цель» или откройте боковое меню слева и выберите вкладку «Цели».
-
Необходимо нажать «Добавить цель» и настроить, какое событие вы хотите отслеживать. Для этого вам нужно выбрать тип «JavaScript-событие», а в идентификаторе цели указать одну из переменных.
-
После того как вы добавили все цели, вам необходимо перейти обратно во вкладку «Счётчики», зайти в настройки счётчика по виджету и скопировать код в конце страницы. Этот код необходимо вставить на свой сайт над кодом виджета.
-
Номер счётчика необходимо внести в виджет, сохранить изменения и уже изменённый код вставить на свой сайт. Теперь Яндекс Метрика отслеживает ваши цели, которые вы можете посмотреть в самом счётчике.
-
-
VK Ads. Отслеживать события можно следующим образом:
-
Необходимо зайти в кабинет VK Ads https://ads.vk.com.
-
Чтобы перейти к созданию целей, откройте вкладку «Настройка» для нужного пикселя и перейдите во вкладку «События».
-
Нажмите кнопку «Добавить событие». В качестве условия наступления необходимо выбрать условие наступления «JS-событие», а в наименовании события указать одну из переменных.
-
После того как все цели добавлены, необходимо перейти во вкладку «Код пикселя», скопировать код и вставить на свой сайт над кодом виджета.
-
ID пикселя необходимо внести в настройки виджета, сохранить изменения. Теперь VK Ads отслеживает ваши цели, которые вы можете посмотреть в своём кабинете.
-
-
Postback (Webhook). В данном случае данные передаются в теле самого постбэка.
Можно настроить передачу по типу постбэка, доступны варианты Get и Post.-
Get — механизм автоматического серверного уведомления о совершённой продаже полиса через метод GET. Метод GET — это один из основных способов отправки данных между браузером и сервером в интернете. Его главное назначение — запрос и получение информации с веб-страницы без изменения данных на сервере.
-
Post — механизм серверного уведомления о продаже полиса, когда данные передаются скрыто внутри тела сетевого запроса (HTTP POST).
-
-
Главные отличия POST-постбэка от GET-постбэка:
-
Скрытность: ссылка выглядит как обычный адрес (например, vash-site.ru), а детальные параметры (ID сделки, марка машины, сумма полиса) передаются в скрытом теле запроса (обычно в формате JSON).
-
Объём данных: метод POST не имеет жёстких ограничений по длине строки. Инссмарт может передать через него гораздо больше подробной информации о застрахованном объекте, клиенте и условиях полиса.
-
Безопасность: перехватить или случайно подделать такой запрос сложнее, так как данные не отображаются в логах серверов в виде открытых URL-адресов.
-
-
Как это работает в виджете:
Клиент оплачивает ОСАГО или ипотечную страховку в виджете на сайте пользователя. Сервер Инссмарт мгновенно формирует скрытый пакет данных с деталями этой транзакции. Платформа отправляет POST-запрос на указанный вами URL-адрес. Пользовательская CRM-система принимает этот пакет, «распаковывает» его, видит успешный статус и автоматически закрывает сделку. -
Раздел «Интеграция».
Этот раздел предназначен для настройки интеграции виджета с внешними системами. Это позволит вам получать данные о событиях, созданных пользователями внутри виджета.
Первое касание — когда система должна передать данные о событии (заполнение пользователем предварительного расчёта, выбор предложения от конкретной СК, получение ссылки на оплату).
CRM-система — способ передачи данных: или через почту, или через систему amoCRM. Если для передачи данных на почту будет достаточно просто указать её, то для интеграции с amoCRM понадобятся дополнительные настройки.
«Интеграция» и «Аналитика» отвечают за принципиально разные технические процессы: передачу операционных клиентских данных (отвечает «Интеграция») и отслеживание статистики продаж (отвечает «Аналитика»).