Настройка geofencing-уведомлений для 1С-Битрикс

Настройка geofencing-уведомлений для 1С-Битрикс

Представьте: вы управляете сетью из 50 розничных точек. Каждый день мимо проходят тысячи потенциальных покупателей. Если отправить персонализированное push-уведомление в момент, когда человек оказывается рядом с магазином, конверсия в посещение вырастает в 2-3 раза. Стандартных инструментов Битрикс24 для этого нет — нужно разрабатывать решение на стыке мобильного приложения и серверного API. Мы уже реализовали такие сценарии для 15+ клиентов, и в этой статье опишем архитектуру, которая выдерживает до 10 000 одновременных сессий.

Геофенсинг — это триггер, срабатывающий при входе пользователя в заданную зону или выходе из неё. В контексте Битрикса — push-уведомление с текстом «Вы рядом — скидка 10%». В отличие от браузерного Geolocation API, нативный геофенсинг на 30% экономит заряд батареи и не требует активного экрана.

Как работает геофенсинг в 1С-Битрикс?

Для работы потребуются три компонента:

1. Мобильное приложение с фоновым мониторингом — регистрирует геозоны и шлёт события на сервер.
2. Серверный API на Битриксе — принимает события, принимает решение об отправке push.
3. Push-инфраструктура — Firebase Cloud Messaging (FCM) для Android, APNs для iOS.

Событие от приложения приходит за 200–500 мс, сервер обрабатывает его за 50 мс. Уведомление доставляется за 1-2 секунды.

Почему нативный геофенсинг эффективнее браузерного?

Нативные SDK (Android GeofencingClient, iOS CLLocationManager) дают точность до 50 метров и работают в фоне. Браузерный API требует открытой вкладки и разряжает батарею в 3 раза быстрее. Сравнение по ключевым параметрам:

Какие компоненты нужны для внедрения?

Мобильное приложение использует:

• Android: com.google.android.gms.location.GeofencingClient
• iOS: CLLocationManager с startMonitoring(for: CLCircularRegion)

При старте приложение загружает список зон с сервера Битрикса и регистрирует их. При входе/выходе ОС генерирует событие — приложение отправляет POST-запрос на ваш API.

API на стороне Битрикса

Создаётся REST-эндпоинт /local/ajax/geofence-event.php, который принимает события:

<?php require_once $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php'; $data = json_decode(file_get_contents('php://input'), true); $userId = (int)$data['user_id']; $zoneId = (int)$data['zone_id']; $eventType = $data['event']; // 'enter' или 'exit' $deviceToken = $data['device_token']; if ($eventType === 'enter') { \Local\Geofence\NotificationService::sendEnterZoneNotification( $userId, $zoneId, $deviceToken ); } ?> 

Хранение геозон

Для хранения зон используем HL-инфоблок GeoZones. Пример структуры:

Отправка push через FCM

namespace Local\Geofence; class NotificationService { private const FCM_URL = 'https://fcm.googleapis.com/fcm/send'; public static function sendEnterZoneNotification( int $userId, int $zoneId, string $deviceToken ): void { $zone = \Local\Geofence\GeoZoneTable::getById($zoneId)->fetch(); if (!$zone || $zone['UF_ACTIVE'] !== true) return; $payload = [ 'to' => $deviceToken, 'notification' => [ 'title' => 'Вы рядом с нами', 'body' => $zone['UF_NOTIFICATION_TEXT'], ], ]; $http = new \Bitrix\Main\Web\HttpClient(); $http->setHeader('Authorization', 'key=' . FCM_SERVER_KEY); $http->setHeader('Content-Type', 'application/json'); $http->post(self::FCM_URL, json_encode($payload)); } } 

Как настроить cooldown для push-уведомлений?

Без ограничений пользователь, проходящий мимо магазина несколько раз в день, получит столько же уведомлений. Добавляем cooldown: логируем отправки в таблицу b_user_counter или HL-инфоблок, и повторно не отправляем, если с прошлого уведомления по этой зоне прошло менее N часов. Стандартное значение — 6 часов, но настраивается индивидуально.

Процесс внедрения

Мы внедряем геофенсинг за пять этапов:

1. Анализ: изучаем инфраструктуру, выявляем требования к зонам и push-сценариям.
2. Проектирование: структура HL-блоков, API-эндпоинты, схема данных.
3. Разработка: пишем серверный API, интеграцию с FCM/APNs, логику cooldown.
4. Интеграция: настраиваем передачу событий из мобильного приложения.
5. Тестирование: проверяем сценарии входа/выхода, нагрузку (до 1000 событий/сек) и антиспам.

Что входит в работу

• Проектирование структуры геозон и API.
• Разработка серверного API на 1С-Битрикс с поддержкой HL-блоков.
• Настройка FCM/APNs для отправки push-уведомлений.
• Интеграция с мобильным приложением (архитектура передачи данных).
• Реализация логики cooldown и антиспама.
• Документация по API и инструкции для разработчиков мобильного приложения.
• Техническая поддержка на этапе внедрения.

Также предоставляем доступ к исходному коду модуля и обучаем вашего разработчика работе с ним.

Сроки

Ориентировочное время реализации — от 3 до 5 рабочих дней в зависимости от сложности интеграции и готовности мобильного приложения.

Наши инженеры имеют 10-летний опыт работы с 1С-Битрикс и сертификаты «1С-Битрикс Эксперт». Мы реализовали более 50 проектов по интеграции мобильных приложений и геофенсинга. Качество подтверждено гарантией на выполненные работы.

Получите консультацию по внедрению геофенсинга для вашего проекта — оценка архитектуры и сроков бесплатно. Свяжитесь с нами, чтобы обсудить детали.