Настройка Яндекс.Директ конверсий на 1С-Битрикс
Передача конверсий в Яндекс.Директ — это связка двух инструментов: Яндекс.Метрики (которая регистрирует цели) и самого Директа (который использует эти цели для оптимизации ставок). Без корректно настроенных целей автоматические стратегии Директа работают вслепую, а отчёты по конверсиям показывают нули.
Счётчик Метрики и цели: что должно быть до настройки Директа
Конверсии Директа опираются на цели Метрики, поэтому сначала — счётчик. В Битриксе счётчик Метрики добавляется несколькими способами: через модуль bitrix:main.counter в шаблоне, через прямую вставку в header.php или через OnEpilog.
Для корректной работы целей критично: счётчик должен загружаться до срабатывания целевых событий. Используйте синхронную инициализацию через ym(counterId, 'init', {...}) с параметром defer: false для страниц с формами.
В таблице b_option удобно хранить ID счётчика: COption::SetOptionString("main", "ya_metrika_id", "XXXXXXXX"). Тогда при смене счётчика не нужно лезть в шаблон.
Цели в Метрике для e-commerce:
-
JavaScript-цель
order_success— на странице спасибо после оформления заказа -
JavaScript-цель
add_to_cart— при добавлении товара в корзину - Составная цель с шагами: просмотр каталога → карточка товара → корзина → оформление
Передача достижения цели из Битрикса
Цель order_success — самая важная для Директа. Вызов:
ym(COUNTER_ID, 'reachGoal', 'order_success', {
order_price: 4900,
currency: 'RUB'
});
В Битриксе страница «Спасибо» — это либо отдельная страница /personal/order/success/, либо финальный шаг компонента bitrix:sale.order.ajax. В обоих случаях нужно убедиться, что JS-вызов не задваивается — при перезагрузке страницы цель не должна фиксироваться повторно.
Надёжный способ: в компоненте bitrix:sale.order.ajax в template.php ищете блок с условием успешного создания заказа ($arResult["NEED_PAY"] || $arResult["ORDER_ID"]) и добавляете вызов Метрики только там. Параметры заказа (order_price) берёте из $arResult["ORDER"]["PRICE"].
Для страницы /personal/order/success/ — компонент bitrix:sale.order.detail даёт доступ к деталям заказа через $arResult. ID заказа из URL-параметра + CSaleOrder::GetByID($orderId).
Офлайн-конверсии через API Метрики
Если часть заказов обрабатывается менеджерами (звонки, заявки без оплаты онлайн), стандартного JS-пикселя недостаточно. Яндекс.Метрика поддерживает загрузку офлайн-конверсий через API.
В Битриксе это реализуется через обработчик события OnSaleOrderStatusUpdate. Когда менеджер переводит заказ в статус «Выполнен», отправляете POST-запрос на https://api-metrika.yandex.net/management/v1/counter/{counterId}/uploads/client_id:
AddEventHandler("sale", "OnSaleOrderStatusUpdate", function($id, $arFields) {
if ($arFields["STATUS_ID"] === "F") { // Finished
// Получаем client_id из b_sale_order_props или пользователя
$httpClient = new \Bitrix\Main\Web\HttpClient();
$httpClient->post($apiUrl, $csvData);
}
});
client_id Метрики нужно сохранять при оформлении заказа — это значение из куки _ym_uid или из JavaScript-метода ym(id, 'getClientID', callback). Сохраняйте его в свойство заказа (b_sale_order_props_value) при создании.
Связка с Директом: автоматические стратегии
После того как цели работают и конверсии фиксируются, в Директе переключаете стратегию на «Оптимизацию конверсий» с целью order_success. Директу нужно минимум 10 конверсий за 28 дней для обучения — это важно учитывать при запуске.
Модуль sale Битрикса при типичной нагрузке не создаёт задержек для вызовов Метрики, но если на сайте агрессивное кеширование через BXCache с TTL > 3600, проверьте, что страница спасибо не кешируется — компонент bitrix:sale.order.ajax имеет CACHE_TYPE = 'N' по умолчанию, но кастомные шаблоны могут это ломать.