Skip to end of metadata
Go to start of metadata

Видеоинструкция

Шаг 1. Установка счетчика

Видеоинструкция

В видео показан процесс по установке счетчика на сайт.

Текстовая версия

Код счетчика для вашего проекта находится в Roistat в пункте меню Настройки → Код счетчика


Установить код счетчика необходимо внутри тега <body></body> в HTML-коде страницы (можно это сделать рядом со счетчиком Яндекс.Метрики или любым другим).
Счетчик должен быть установлен на всех страницах сайта.

В общей статистике Вашего проекта на сайте roistat.com во вкладке «Аналитика» появятся заходы на сайт.

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

Для просмотра и настройки внешнего вида промокода нажмите ссылку Настройки отображения промокода или откройте Отслеживание звонков Промокод.

Инструкция по настройке промокода доступна на странице Промокодирование (для отслеживания продаж по телефону).

Шаг 2. Добавление поля roistat в CRM

Каждую сделку нужно связать с заходом клиента на сайт. Для этого необходимо добавить новое поле к Вашим сделкам в CRM, которое должно называться roistat.

Для наглядности вы можете посмотреть, как создаются дополнительные поля в других CRM.

Шаг 3. Настройка отправки сделок с сайта в CRM

Если сделки с сайта отправляются на почту, то нужно сделать так, чтобы они отправлялись в CRM напрямую.

При отправке сделки в CRM созданное поле roistat должно заполняться значением cookie roistat_visit .

Также Вы можете посмотреть примеры готовых решений с другими CRM: Интеграция с CRM

Проверка работы: при создании какой-либо заявки клиентом на сайте в Вашей CRM должна создаваться новая сделка с заполненным полем roistat.

Шаг 4. Создание страницы для выгрузки сделок

Необходимо создать страницу, которая при получении GET запроса с параметрами будет выгружать информацию о сделках в JSON формате.

Сервер Roistat делает GET запрос:

http://example.com/integration.php?date=1453836403&user=vasya&token=d41d8cd98f00b204e9800998ecf8427e&action=export&offset=0&limit=1000

Описание параметров в запросе:

ПараметрОписание
dateДата (в формате UNIX-time) после которой, были изменения в сделках
userИмя пользователя (Указывается в настройках интеграции)
tokenmd5 ( $username . $password )
actionДействие
limitЛимит количества выгружаемых сделок
offsetКоличество записей от начала выборки которые нужно пропустить

Если статус или другие параметры сделки изменились, их тоже нужно выгружать: с новым статусом, новой суммой или с обновлёнными значениями дополнительных полей.

Формат ответа:

 Пример в формате JSON
 Пример в формате XML

Тип полей в массивах statuses и orders принципиально не важен, как правило, это stringint. Для суммы сделки или себестоимости может быть float. 

Массив statuses содержит список всех статусов сделок с их уникальными номерами и названиями.

Описание элементов массива statuses:

ЭлементОписание
id
Уникальный идентификатор статуса. Используется в массиве orders
name
Человекочитаемое название статуса. Используется в интерфейсе Roistat

Массив orders содержит информацию о сделках, которые обновлялись в период с date (переданный нами GET-параметр) по текущую дату.

Описание элементов массива orders:

ЭлементОписаниеОбязательный
idУникальный идентификатор сделкиДа
nameЧеловекочитаемое название сделки. Используется в интерфейсе RoistatНет
date_createДата создания сделки в формате UNIX-time или YYYY-MM-DD HH:MMДа
statusУникальный идентификатор статуса из массива statusesДа
priceСумма сделки. Используется в показателе «Выручка» в RoistatНет
costCебестоимость сделки. Используется в показателе «Себестоимость» в RoistatНет
roistatНомер визита, сохраненный у сделки. Значение cookie roistat_visit. Используется для определения источника сделкиНет
client_id
Идентификатор клиентаНет
fields Необязательное поле, которое может содержать массив дополнительных полейНет

Описание элементов массива pagination:

ЭлементОписание
total_countОбщее количество найденных записей
limitКол-во записей которое будет отдаваться за один запрос

Пример кода на PHP, если бы все данные о сделке мы получали из базы:

 Показать код

Шаг 5. Создание страницы для выгрузки клиентов

По той же ссылке, которая отдает информацию о заказах, можно добавить также информацию о клиентах.
Сервер Roistat делает аналогичный GET запрос, только отправляет в параметрах action=export_clients:

http://example.com/integration.php?date=1453836403&user=vasya&token=d41d8cd98f00b204e9800998ecf8427e&action=export_clients

Описание параметров в запросе:

ПараметрОписание
dateДата начиная с которой запрашиваются клиенты (В формате UNIX-time)
userИмя пользователя (Указывается в настройках интеграции)
tokenmd5 ( $username . $password )
actionexport_clients

Формат ответа:

 Пример в формате JSON
 Пример в формате XML

Описание элементов массива clients:

ЭлементОписаниеОбязательный
idУникальный идентификатор клиентаДа
nameИмя клиентаДа
phoneНомер телефонаДа
emailЭл. почтаДа
companyНазвание компанииНет
birth_date
День рождения (В формате Y-m-d)Нет
fields
Необязательное поле, которое может содержать массив дополнительных полейНет

Шаг 6. Настройка получения данных сделок

На этом этапе необходимо интегрировать сервис Roistat с данными страницы выдачи сделок из вашей CRM.

Для этого зайдите на сайте roistat.com в пункт меню Каталог интеграций → Своя CRM.

В поле URL доступа укажите полный адрес страницы, по которой доступна выгрузка сделок из вашей CRM.

В полях Логин и Пароль вы можете указать логин и пароль, если ограничили доступ к странице выгрузки сделок.

Если логин и пароль указаны, то Roistat добавит параметр token при обращении к ссылке из поля URL доступа, где $token = md5($user.$password);

Проверка работыпосле нажатия кнопки Сохранить в разделе Статусы должны загрузиться статусы сделок, которые вы передавали в массиве statuses (см. шаг 4).

Шаг 7. Распределение статусов

После подключения CRM к ROIstat нужно распределить статусы сделок:

  • Не учитываются — мусорные лиды, дублирующие сделки. Чтобы статистика была максимально корректна — не удаляйте сделки. Их лучше перемещать в специально отведенный статус (например, «Мусор»).
  • В работе — сделки, по которым идет работа (например, новые переговоры или комплектация товара).
  • Оплаченные — сделки, по которым вы уже получили деньги или «вот-вот» получите.
  • Отмененные — сделки, от которых клиент отказался или делает возврат.

Просто перетащите статус в нужный блок.

Для того чтобы отнести статус сделки в группу "Не учитываются", нужно просто не загружать данный статус в Roistat.

На основе этой группировки Roistat сможет отслеживать фактически достигнутые показатели (используя группу «Оплаченные») и прогноз показателей, которые возможно достичь (объединение статусов «В работе» и «Оплаченные»).


  • No labels