Carrot Quest і 1С-Бітрікс: повне налаштування трекінгу та автоматизації

На одному з проєктів — інтернет-магазин електроніки з 15 000 товарів і 3000 щоденних відвідувачів, який обробляє близько 200 замовлень на день — ми помітили, що Carrot Quest ідентифікує лише 20% авторизованих сесій. Інші візити залишалися анонімними, хоча користувачі були залогінені. Причина — відсутність виклику carrotquest.identify() після авторизації. Стандартний снипет у шаблоні не передавав email та ID. Після впровадження коректної ідентифікації з хеш-верифікацією кількість ідентифікованих сесій зросла до 95%, і тригерні ланцюжки почали працювати. За рахунок цього конверсія в чат-діалог збільшилася на 40%, а середній чек замовлення — на 12%. Документація Carrot Quest підтверджує, що ідентифікація з хешем є обов'язковою умовою для верифікації даних. У результаті кампанія з автоматизації маркетингу принесла додатково 500 000 грн виручки на місяць.

Проблеми, які вирішуємо

Carrot Quest — не просто чат, а платформа для аналітики та автоматизації. Але без інтеграції з Бітрікс ви втрачаєте:

• Зв'язок між поведінкою на сайті та CRM-даними.
• Можливість сегментувати користувачів за реальними покупками.
• Тригерні повідомлення, засновані на подіях воронки.

Ми вирішуємо ці проблеми через повноцінну інтеграцію: від встановлення трекінг-коду до серверних подій. Carrot Quest у зв'язці з Бітрікс працює ефективніше, ніж будь-який окремий чат — конверсія в діалог вища в 2-3 рази. Наша команда спеціалізується на інтеграціях Бітрікс більше 7 років і реалізувала понад 50 проєктів з налаштування Carrot Quest.

Як налаштувати трекінг подій з 1С-Бітрікс?

Встановлення трекінг-коду та ідентифікація. Код Carrot Quest вставляється в шаблон перед </body>. Ключова операція — carrotquest.identify(). Без неї всі події анонімні.

(function(){ /* стандартный сниппет Carrot Quest */ })();
carrotquest.connect('YOUR_API_KEY');
<?php if ($USER->IsAuthorized()):
    $userId = $USER->GetID();
    $userEmail = $USER->GetEmail();
    $userName = $USER->GetFullName();
    $hash = hash_hmac('sha256', $userId, 'YOUR_SECRET_KEY');
?>
carrotquest.identify({
    '$user_id': <?= json_encode($userId) ?>,
    '$email': <?= json_encode($userEmail) ?>,
    '$name': <?= json_encode($userName) ?>,
    '$phone': <?= json_encode(getUserPhone($userId)) ?>,
    'orders_count': <?= getUserOrdersCount($userId) ?>,
    'total_spent': <?= getUserTotalSpent($userId) ?>,
}, <?= json_encode($hash) ?>);
<?php endif; ?>

Хеш HMAC-SHA256 верифікує дані на стороні Carrot Quest і запобігає підстановці чужого ID. Кроки з налаштування ідентифікації:

1. Отримати API-ключ та секретний ключ з особистого кабінету Carrot Quest.
2. Вставити снипет трекінгу в шаблон сайту.
3. Додати виклик identify() для авторизованих користувачів з передачею user_id, email та хеша.
4. Перевірити в консолі браузера, що виклик успішний.

Відправка подій з каталогу. Carrot Quest цінний як аналітична платформа, коли отримує події з усієї воронки. Приклади:

// Просмотр карточки товара
carrotquest.track('Просмотр товара', {
  product_id: <?= $arResult['ID'] ?>,
  product_name: <?= json_encode($arResult['NAME']) ?>,
  price: <?= $arResult['CATALOG_PRICE_1'] ?? 0 ?>,
  category: <?= json_encode($sectionName) ?>,
});

// Добавление в корзину
carrotquest.track('Товар добавлен в корзину', {
  product_id: productId,
  product_name: productName,
  price: price,
  quantity: quantity,
});

// Оформление заказа
carrotquest.track('Заказ оформлен', {
  order_id: <?= $orderId ?>,
  total_price: <?= $orderTotal ?>,
  items_count: <?= $itemsCount ?>,
  payment_method: <?= json_encode($paymentMethod) ?>,
});

При обміні через CommerceML дані про товари та замовлення також можуть передаватися в Carrot Quest для синхронізації каталогу.

Чому важлива ідентифікація користувача через hash?

Без hash будь-хто може підставити чужий ID і зіпсувати статистику. Хеш-верифікація — стандарт безпеки для обміну даними між Бітрікс та Carrot Quest. Ми гарантуємо, що профілі належатимуть реальним користувачам. В одному з проєктів після впровадження хеша кількість помилкових профілів знизилася з 15% до 0,5%.

Які події варто трекати в першу чергу?

Фокус на події, які впливають на конверсію: перегляд товару, додавання в кошик, початок оформлення замовлення, успішне замовлення. Також корисні події "пошук по сайту" та "перегляд категорії". Для інтернет-магазину це мінімальний набір, що дозволяє побудувати воронку та налаштувати тригери на покинуті кошики. Додайте також подію "повернення товару" — вона критична для сегментації.

Інтеграція через PHP API Carrot Quest

Окрім JS-трекінгу, Carrot Quest має REST API для серверної сторони. Це потрібно, коли подія відбувається поза браузером — наприклад, зміна статусу замовлення. Ми використовуємо REST API Carrot Quest для відправки подій.

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'sale',
    'OnSaleStatusOrder',
    function (\Bitrix\Main\Event $event) {
        $order = $event->getParameter('ENTITY');
        $userId = $order->getUserId();
        $userEmail = getUserEmail($userId);
        $statusId = $order->getField('STATUS_ID');
        $payload = [
            'id' => $userEmail,
            'id_type' => 1,
            'event' => 'Статус заказа изменён',
            'params' => [
                'order_id' => $order->getId(),
                'new_status' => $statusId,
            ],
        ];
        $ch = curl_init('https://api.carrotquest.io/v1/users/events');
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Token YOUR_API_KEY', 'Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_exec($ch);
        curl_close($ch);
    }
);

Порівняння JS та серверного трекінгу:

Сегментація та тригерні ланцюжки

Після ідентифікації можна оновлювати атрибути при кожному візиті: last_visit, cart_value, loyalty_level. Це дозволяє будувати сегменти для тригерних повідомлень. В інтерфейсі Carrot Quest створюються ланцюжки без коду:

• Користувач переглянув товар → не додав у кошик за 30 хвилин → чат-повідомлення.
• Замовлення доставлено → через 7 днів email з проханням відгуку.
• Користувач не заходив 60 днів → знижковий купон.

Налагодження трекінгу

У консолі браузера carrotquest.track() та carrotquest.identify() виводять підтвердження в режимі розробки. В адмін-панелі Carrot Quest розділ «Аналітика → Події» показує дані в реальному часі.

Типові помилки при інтеграції:

• Забули викликати carrotquest.identify() на сторінках, де користувач авторизується через ajax.
• Не передали hash — події йдуть, але ідентифікація вважається неверифікованою.
• Використовуєте один API-ключ для кількох сайтів — дані змішуються.
• Не перевіряєте консоль на 404 помилки скрипта Carrot Quest.

Етапи інтеграції

Що входить у роботу

• Встановлення та перевірка трекінг-коду.
• Ідентифікація користувачів з хеш-верифікацією.
• Трекінг подій (перегляд, кошик, замовлення).
• Серверний API для подій поза браузером.
• Сегментація за атрибутами.
• Документація по всіх доданих подіях.
• Тестування та виправлення помилок.

Строки та вартість

Строки — від 5 до 10 днів залежно від кількості подій. Вартість розраховується індивідуально після аналізу структури вашого сайту. Зв'яжіться з нами для розрахунку вартості інтеграції — підберемо оптимальний склад робіт.

Ми гарантуємо коректну передачу всіх даних та відсутність помилок у консолі. Отримайте консультацію через форму на сайті — ми запропонуємо рішення, яке окупиться за рахунок зростання конверсії.