Источник заявки и UTM-метки из веб-форм 1С-Битрикс

Почему в результатах веб-формы нет источника

Модуль «Веб-формы» записывает в результат то, что посетитель ввёл в поля: имя, телефон, вопрос. Рекламная кампания, ключевая фраза или сайт, с которого пришёл человек, в результат не попадают. Их знает только первая страница визита: в её адресе стоят UTM-метки, а в заголовке запроса реферер. Форму же посетитель заполняет позже, часто на другой странице, где ни меток, ни реферера уже нет.

Обычно задачу решают скрытыми полями: скрипт на странице запоминает метки в cookie и подставляет их в форму. Способ рабочий, но каждую новую форму приходится дорабатывать, а если скрипт заблокирован или упал, метки теряются. Оба подхода разобраны в статье «Как передать UTM-метки в форму».

Для Битрикса удобнее серверный путь. Сайт сам запоминает источник в сессии на первом хите визита, а когда результат формы сохранён, его сервер отправляет заявку в Linkodium Analytics. Формы и их шаблоны менять не нужно, письма и результаты в админке остаются как были.

Код для init.php

Обработчик ставится в /local/php_interface/init.php (или /bitrix/php_interface/init.php, если папки local на сайте нет). Первая функция на первом хите визита запоминает источник, вторая после сохранения результата веб-формы отправляет заявку по API приёма заявок:

<?php
// /local/php_interface/init.php (или /bitrix/php_interface/init.php)

const LKDM_KEY = 'aaeaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee'; // ключ проекта из кабинета

// 1. Первый хит визита: запоминаем страницу входа, реферер и браузер.
AddEventHandler('main', 'OnProlog', 'lkdmRememberVisit');
function lkdmRememberVisit()
{
    if (defined('ADMIN_SECTION') || isset($_SESSION['LKDM_START_URL'])) {
        return;
    }
    $uri = $_SERVER['REQUEST_URI'] ?? '/';
    if (strpos($uri, '/bitrix/') === 0) {
        return;
    }
    $scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
    $_SESSION['LKDM_START_URL']  = $scheme . '://' . ($_SERVER['HTTP_HOST'] ?? '') . $uri;
    $_SESSION['LKDM_REFERER']    = $_SERVER['HTTP_REFERER'] ?? '';
    $_SESSION['LKDM_USER_AGENT'] = $_SERVER['HTTP_USER_AGENT'] ?? '';
}

// 2. Результат веб-формы сохранён: отправляем заявку в Linkodium Analytics.
AddEventHandler('form', 'onAfterResultAdd', 'lkdmSendFormResult');
function lkdmSendFormResult($WEB_FORM_ID, $RESULT_ID)
{
    $result = [];
    $answers = [];
    CFormResult::GetDataByID($RESULT_ID, [], $result, $answers);

    // SID вопросов своей формы смотрите в её настройках, вкладка «Вопросы».
    $data = [
        'name'        => lkdmAnswer($answers, 'NAME'),
        'phone'       => lkdmAnswer($answers, 'PHONE'),
        'email'       => lkdmAnswer($answers, 'EMAIL'),
        'message'     => lkdmAnswer($answers, 'MESSAGE'),
        'external_id' => $RESULT_ID,
        'ip'          => $_SERVER['REMOTE_ADDR'] ?? '',
        'user_agent'  => $_SESSION['LKDM_USER_AGENT'] ?? ($_SERVER['HTTP_USER_AGENT'] ?? ''),
        'start_url'   => $_SESSION['LKDM_START_URL'] ?? '',
        'order_url'   => $_SERVER['HTTP_REFERER'] ?? '',
        'referer'     => $_SESSION['LKDM_REFERER'] ?? '',
    ];

    $ch = curl_init('https://a.linkodium.com/submit/' . LKDM_KEY . '/');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    curl_setopt($ch, CURLOPT_TIMEOUT, 5);
    curl_exec($ch);
    curl_close($ch);
}

function lkdmAnswer(array $answers, $sid)
{
    if (empty($answers[$sid]) || !is_array($answers[$sid])) {
        return '';
    }
    $a = reset($answers[$sid]);
    $value = trim((string)($a['USER_TEXT'] ?? ''));
    return $value !== '' ? $value : trim((string)($a['ANSWER_TEXT'] ?? ''));
}

Это пример, а не готовый модуль: замените ключ на ключ своего проекта и коды NAME, PHONE, EMAIL, MESSAGE на SID вопросов своей формы. Если вопросов с такими кодами нет, поле уйдёт пустым. Таймаут в 5 секунд нужен, чтобы посетитель не ждал отправки формы дольше обычного, если сервис недоступен.

Если формы на сайте не на модуле «Веб-формы»

Пример выше слушает событие модуля «Веб-формы». Если форма своя, например AJAX-обработчик, который пишет заявку в инфоблок или отправляет письмо, вызов отправки ставится прямо в этот обработчик: в момент, когда заявка принята, соберите поля в массив, как в функции lkdmSendFormResult, и отправьте их тем же запросом. Функция lkdmRememberVisit при этом остаётся без изменений: источник визита ей всё равно, какой формой его потом заберут.

CRM-формы Битрикс24, встроенные на сайт кодом, работают на стороне Битрикс24, и заявки из них сайт не получает. Такие формы этим способом не подключаются.