Інтеграція Flocktory з 1С-Бітрікс: трекер, замовлення, рефералка

Уявіть: клієнт оформлює замовлення, переходить на сторінку «Дякуємо» — і йде без додаткових пропозицій. На одному з наших проєктів інтернет-магазин електроніки після інтеграції Flocktory збільшив середній чек на 25% завдяки постпокупному апсейлу. Платформа аналізує склад замовлення та показує релевантну пропозицію партнера — клієнт отримує знижку на аксесуари, ви — комісію. Flocktory працює в 3 рази ефективніше стандартних поп-апів завдяки віральному охопленню та персоналізації за даними реальних покупок. За даними Flocktory, клієнти економлять до 40% бюджету на рекламу.

Базова інтеграція включає підключення трекера на всіх сторінках, передачу даних про замовлення (ID, сума, склад, email клієнта) та налаштування push-user для авторизованих користувачів. Додатково можна реалізувати реферальну програму Shaker з промокодами.

Етапи інтеграції Flocktory з 1С-Бітрікс

1. Аудит поточної реалізації та доступів — перевіряємо шаблони, обробники подій, спосіб виведення даних.
2. Підключення трекера Flocktory на всіх сторінках — вставка коду в footer.php або через addExternalJs.
3. Налаштування блоку даних про замовлення на сторінці підтвердження — коректний JSON зі складом замовлення.
4. Інтеграція push-user для авторизованих користувачів — передача email на кожній сторінці.
5. Реалізація реферальної програми (промокоди) — прийом та обробка реферальних кодів у кошику.
6. Тестування та налагодження (включаючи налагодження через ?flocktory_debug=1) — перевірка реальних замовлень.
7. Документація з інтеграції та навчання ваших менеджерів.
8. Гарантія коректної роботи після деплою: виправляємо баги за наш рахунок.

Як підключити трекер Flocktory в 1С-Бітрікс?

Трекер підключається один раз на всіх сторінках сайту. У шаблоні Бітрікс — у footer.php або через addExternalJs:

<!-- Flocktory трекер --> <div class="i-flocktory" data-fl-action="track" data-fl-site-id="YOUR_SITE_ID"></div> <script type="text/javascript"> (function(w,d,n,s,t) { w[n] = w[n] || []; w[n].push(function() { t = d.createElement(s); t.type = 'text/javascript'; t.async = true; t.src = '//api.flocktory.com/v2/loader.js?site_id=<?= FLOCKTORY_SITE_ID ?>'; var sn = d.getElementsByTagName(s)[0]; sn.parentNode.insertBefore(t, sn); }); w.addEventListener('load', w[n][0]); })(window, document, '_flocktory_callbacks', 'script'); </script> 

FLOCKTORY_SITE_ID — числовий ідентифікатор з особистого кабінету Flocktory. Рекомендується винести його в константу через define у bitrix/php_interface/dbconn.php або в модуль налаштувань.

Що потрібно для коректної передачі даних про замовлення?

Ключова точка інтеграції — сторінка «Дякуємо за замовлення». Flocktory показує постпокупний поп-ап лише якщо отримує коректні дані про замовлення. На сторінці успішного оформлення вставляємо блок з даними:

<?php // У шаблоні сторінки підтвердження замовлення // Дані беремо з компонента sale.order.checkout або напряму з ORDER_ID $orderId = (int)$_GET['ORDER_ID']; $order = \Bitrix\Sale\Order::load($orderId); if ($order && $order->getUserId() === $USER->GetID()) { $user = CUser::GetByID($order->getUserId())->Fetch(); $items = []; foreach ($order->getBasket()->getOrderableItems() as $item) { $items[] = [ 'id' => (string)$item->getProductId(), 'title' => $item->getField('NAME'), 'price' => (float)$item->getPrice(), 'count' => (float)$item->getQuantity(), ]; } $flData = [ 'order' => [ 'id' => (string)$orderId, 'price' => (float)$order->getPrice(), 'currency' => $order->getCurrency(), ], 'customer' => [ 'name' => trim($user['NAME'] . ' ' . $user['LAST_NAME']), 'email' => $user['EMAIL'], ], 'items' => $items, ]; ?> <div class="i-flocktory" data-fl-action="purchase" data-fl-site-id="<?= FLOCKTORY_SITE_ID ?>" data-fl-user-name="<?= htmlspecialchars($flData['customer']['name']) ?>" data-fl-user-email="<?= htmlspecialchars($flData['customer']['email']) ?>" data-fl-transaction-id="<?= $flData['order']['id'] ?>" data-fl-total-price="<?= $flData['order']['price'] ?>" data-fl-items='<?= json_encode($flData['items'], JSON_UNESCAPED_UNICODE) ?>'> </div> <?php } ?> 

Атрибут data-fl-items повинен містити валідний JSON. Flocktory використовує ці дані для таргетування постпокупної пропозиції: наприклад, якщо клієнт купив товар з категорії «Електроніка», партнер може показати пропозицію на гарантію або аксесуари.

Дані авторизованого користувача на всіх сторінках

Для персоналізації Flocktory повинен знати email авторизованого користувача на будь-якій сторінці:

<?php // У footer.php, після підключення основного трекера if ($USER->IsAuthorized()) { $currentUser = CUser::GetByID($USER->GetID())->Fetch(); ?> <div class="i-flocktory" data-fl-action="push-user" data-fl-site-id="<?= FLOCKTORY_SITE_ID ?>" data-fl-user-email="<?= htmlspecialchars($currentUser['EMAIL']) ?>" data-fl-user-name="<?= htmlspecialchars($currentUser['NAME']) ?>"> </div> <?php } ?> 

Інтеграція через події Бітрікс (альтернативний підхід)

Замість HTML-блоків можна передавати дані через JavaScript-об'єкт після отримання підтвердження від сервера. Обробник події OnSaleOrderSaved зберігає дані в сесію, яка потім зчитується на сторінці «Дякуємо»:

AddEventHandler('sale', 'OnSaleOrderSaved', function(\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); $isNew = $event->getParameter('IS_NEW'); if (!$isNew) return; $_SESSION['FLOCKTORY_ORDER'] = [ 'id' => $order->getId(), 'price' => $order->getPrice(), ]; }); 

Цей метод зручний, якщо потрібно уникнути змін у шаблонах. Докладніше про подію OnSaleOrderSaved — документація 1С-Бітрікс.

Чому Flocktory може не показувати поп-ап?

Економія бюджету на залучення клієнтів з Flocktory досягає 40%. Окупність інтеграції — в середньому 3 місяці.

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

• Повний аудит поточної реалізації та доступів до сайту.
• Підключення трекера Flocktory на всіх сторінках.
• Налаштування передачі даних про замовлення на сторінці підтвердження.
• Інтеграція push-user для авторизованих користувачів.
• Реалізація реферальної програми з промокодами (опціонально).
• Тестування та налагодження всіх механік.
• Документація з інтеграції та навчання ваших менеджерів.
• Гарантія коректної роботи після деплою.

Терміни реалізації

Отримайте консультацію інженера — зв'яжіться з нами, щоб уточнити деталі вашого проекту та оцінити вартість інтеграції під ключ. Замовте виїзне налаштування або віддалену допомогу.