Настройка QR-кодов для маркетинговых акций 1С-Битрикс

Настройка QR-кодов для маркетинговых акций 1С-Битрикс

QR-коды для акций — это не просто ссылка в квадратике. Маркетинговый QR решает конкретную задачу: связать офлайн-точку касания (упаковка, листовка, баннер, витрина) с онлайн-действием (применение купона, регистрация в программе лояльности, участие в розыгрыше). Ключевое отличие от товарного QR — аналитика: кто, когда, где отсканировал.

Архитектура маркетинговых QR

Маркетинговый QR-код указывает не напрямую на страницу акции, а на промежуточный редиректор с аналитикой. Схема:

QR → https://shop.ru/promo/qr/?c=SUMMER25&src=package_tea → (трекинг) → /catalog/sale/

Параметры:

• c — код акции (привязан к купону или сценарию)
• src — источник размещения (упаковка, листовка, баннер)
• mid — ID конкретного материала (номер партии листовок)

Такой подход даёт аналитику без изменения URL финальной страницы.

Хранение маркетинговых QR в Битрикс

Для управления маркетинговыми QR создаётся отдельный инфоблок или таблица через ORM:

class MarketingQrTable extends \Bitrix\Main\ORM\Data\DataManager {
    public static function getTableName(): string {
        return 'custom_marketing_qr';
    }

    public static function getMap(): array {
        return [
            new Fields\IntegerField('ID', ['primary' => true, 'autocomplete' => true]),
            new Fields\StringField('CODE'),          // Уникальный код QR
            new Fields\StringField('NAME'),          // Название акции
            new Fields\StringField('TARGET_URL'),    // Куда редиректим
            new Fields\StringField('SOURCE'),        // Тип источника
            new Fields\DatetimeField('ACTIVE_FROM'),
            new Fields\DatetimeField('ACTIVE_TO'),
            new Fields\IntegerField('SCAN_COUNT'),   // Счётчик сканирований
            new Fields\BooleanField('IS_ACTIVE'),
        ];
    }
}

Редиректор с трекингом

Контроллер обрабатывает переход по QR:

class QrRedirectController extends \Bitrix\Main\Engine\Controller {

    public function trackAction(string $code, string $src = '', string $mid = ''): \Bitrix\Main\Engine\Response\Redirect {
        $qr = MarketingQrTable::getList([
            'filter' => ['=CODE' => $code, '=IS_ACTIVE' => true],
            'limit' => 1,
        ])->fetch();

        if (!$qr) {
            return new \Bitrix\Main\Engine\Response\Redirect('/404/');
        }

        // Проверяем период активности
        $now = new \Bitrix\Main\Type\DateTime();
        if ($qr['ACTIVE_FROM'] && $qr['ACTIVE_FROM'] > $now) {
            return new \Bitrix\Main\Engine\Response\Redirect('/promo/soon/');
        }
        if ($qr['ACTIVE_TO'] && $qr['ACTIVE_TO'] < $now) {
            return new \Bitrix\Main\Engine\Response\Redirect('/promo/expired/');
        }

        // Логируем сканирование
        QrScanLogTable::add([
            'QR_ID' => $qr['ID'],
            'SOURCE' => $src,
            'MATERIAL_ID' => $mid,
            'IP' => $_SERVER['REMOTE_ADDR'],
            'USER_AGENT' => $_SERVER['HTTP_USER_AGENT'],
            'SCANNED_AT' => $now,
            'USER_ID' => $GLOBALS['USER']->GetID() ?: null,
        ]);

        // Инкремент счётчика
        MarketingQrTable::update($qr['ID'], [
            'SCAN_COUNT' => $qr['SCAN_COUNT'] + 1,
        ]);

        // Если есть купон — применяем к сессии
        if (!empty($qr['COUPON_CODE'])) {
            \Bitrix\Main\Application::getInstance()->getSession()->set('QR_COUPON', $qr['COUPON_CODE']);
        }

        return new \Bitrix\Main\Engine\Response\Redirect($qr['TARGET_URL']);
    }
}

Интеграция с купонами Битрикс

Мощный сценарий: пользователь сканирует QR с упаковки → попадает в магазин → купон применяется автоматически. Купон предварительно создаётся в модуле «Маркетинг» Битрикс (sale.discount):

// Применение купона из сессии при открытии корзины
AddEventHandler('sale', 'OnSaleBasketBeforeSaved', function(&$params) {
    $session = \Bitrix\Main\Application::getInstance()->getSession();
    $qrCoupon = $session->get('QR_COUPON');

    if ($qrCoupon) {
        \CSaleDiscount::ApplyCoupon($qrCoupon);
        $session->remove('QR_COUPON');
    }
});

Генерация партии QR для печати

Для офлайн-материалов генерируется пакет QR-кодов:

function generateQrBatch(string $campaignCode, string $source, int $count): string {
    $zipPath = '/tmp/qr-' . $campaignCode . '.zip';
    $zip = new ZipArchive();
    $zip->open($zipPath, ZipArchive::CREATE);

    for ($i = 1; $i <= $count; $i++) {
        $mid = str_pad($i, 5, '0', STR_PAD_LEFT);
        $url = 'https://' . SITE_SERVER_NAME . '/promo/qr/?c=' . $campaignCode . '&src=' . $source . '&mid=' . $mid;

        $result = \Endroid\QrCode\Builder\Builder::create()
            ->data($url)
            ->size(600)
            ->build();

        $zip->addFromString('qr-' . $mid . '.png', $result->getString());
    }

    $zip->close();
    return $zipPath;
}

Аналитика в административной части

Из лога сканирований строятся отчёты:

• Количество сканирований по источникам (какой носитель работает лучше)
• Конверсия из скана в покупку
• Время суток и день недели активности
• Гео-распределение (по IP)

Данные выводятся в custom-отчёте в административной части или выгружаются в Google Data Studio.

Сроки выполнения

Маркетинговый QR без трекинга — деньги на ветер. С трекингом — управляемый инструмент с измеримым ROI.