Настройки

Как установить код на сайт

Для того, чтобы подключить сервис Carrot Quest к вашему сайту, нужно выполнить несколько простых шагов. Установка займет у вас не больше 10 минут.

1. После добавления сайта Вы попадете на страницу Onboarding.

2. На первом шаге вам будет показан код, который надо вставить в header вашего сайта перед закрывающим тегом </head>. Пример такого кода:



Пример вставки кода:

 

Этот код асинхронно загружает JS-библиотеку и создает глобальный объект carrotquest, к которому нужно обращаться для взаимодействия с API.

 

Поддомены

После установки сервиса на ваш сайт скрипт автоматически начинает действовать в том числе на всех поддоменах сайта.

 

Использование модулей

Вы можете воспользоваться готовыми модулями для установки и настройки, если Ваш сайт создан на одной из CRM:

  • InSales
  • 1С-Битрикс
  • OpenCart (2.0.x, 2.1.x, 2.2.0.0)
  • WordPress (с установленным плагином WooCommerce 2.x)

После установки модуля в сервисе автоматически начнется сбор просмотренных товаров, товаров из корзины, суммы в корзине и т.д.

Чтобы начать использовать один из модулей, выберите нужный модуль на первом шаге в Onboarding:


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

 

Общие настройки

Вы можете посмотреть основные настройки сервиса в разделе "Настройки".

 

  1. Статус. Статус работы сервиса на сайте:
    «Активно» — сервис работает;
    «Заблокировано» — сервис отключен за неуплату.
  2. Дата создания. Дата добавления сайта в наш сервис.
  3. Имя приложения. Название, которое будет отображаться в списке сайтов. Также имя приложения подставляется в имя и адрес отправителя.
  4. Адрес. Адрес сайта, на который установлен код. При изменении адреса сервис продолжит работать на том сайте, на котором установлен код.
  5. Язык. Язык внешних элементов чата. Доступны русский и английский варианты:
  6. Часовой пояс. Ваш часовой пояс указывается для корректной по времени отправки автоответов в чат.
  7. Переадресация писем. Получайте письма из своего корпоративного почтового ящика в Carrot Quest. Для этого необходимо настроить переадресацию на сгенерированный адрес. Как это сделать, читайте в этой статье

Добавить кнопку отписаться в html шаблон

Чтобы добавить возможность отписаться, в собственный html шаблон письма нужно вставить следующий код:

 

<a href="{{ unsubscribe_url }}">Отписаться</a>

 

Теперь, когда пользователь нажмёт на эту ссылку, он отпишется от вашей рассылки.

Настройка видимости чата

Как скрыть чат

Вы всё настроили и на сайте появился чат, но вам он не нужен. Можно настроить видимость чата. Есть три варианта:

  • Видимый (свёрнутое состояние видимо всегда);
  • Только когда есть диалог (свернутое состояние видно только когда был хотя бы один диалог);
  • Скрытый (свернутое состояние видимо только когда приходит новое сообщение в чат).

Все манипуляции с видимостью чата можно настроить на втором шаге батарейки.

 

Как скрыть чат на определенных страницах

Если вам необходимо скрыть чат на некоторых страницах, то достаточно на них добавить скрипт

carrotquest.onReady(function () { carrotquest.removeChat(); });

 

Как открывать чат по скрипту

Для того, чтобы открывать чат по нажатию на вашу кнопку, нужно просто добавить обработчик на кнопку с кодом:

Carrotquest.open()

При выполнении этого скрипта чат откроется даже если он был в скрытом режиме.

Фильтрация ботов

По умолчанию фильтруются следующие боты из JavaScript библиотеки Carrot quest:

  • Yahoo
  • Googlebot
  • Mail.Ru Bot
  • YandexBot
  • BingBot
  • FaceBot
  • VK Share
  • AppleBot
  • TwitterBot

Все другие боты, переходящие на ваш сайт, будут влиять на информацию о пользователях в базе Carrot Quest. Установите код, чтобы отфильтровывать таких пользователей:

  1. Просматривайте  информацию юзер агента у уникальных посетителей вашего сайта;
  2. Ищите слово “bot” где-нибудь в информации юзер агента.
  3. Если вы нашли слово “bot”, задайте свойство $ignore определено.

Если вы можете, установите общую закономерность действий ботов, чтобы заблокировать всех сразу. Этого можно добиться, если фильтровать любое взаимодействие с вашим сайтом, которое исходит из web framework, не похожего на браузер пользователей.

В качестве примера для GTM ботов код будет выглядеть так:

 

Если вы установите этот код, вы заблокируете всех юзер агентов с “Bot” в имени пользователя. Если это не сработает, вы можете начать отслеживать этого агента, чтобы установить общую закономерность среди всех ботов на вашем сайте.