Інтеграція 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 для авторизованих користувачів.
• Реалізація реферальної програми з промокодами (опціонально).
• Тестування та налагодження всіх механік.
• Документація з інтеграції та навчання ваших менеджерів.
• Гарантія коректної роботи після деплою.

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

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