UTMSTAT - информация для программиста

1. Код для проекта Доминион

1.1 Разместите его на сайте, после метрики

<!-- BEGIN OF UTMSTAT COUNTER CODE FOR Доминион -->
<script type="text/javascript">
    var utmStatConf = {projectId: "3ab567327bf6485fac842a3ae18edaaf", hasMetrika: true, hasAnalytics: true, useCookieSync: false};
    (function (u, t, m) {
        var s = u.createElement(t), n = u.getElementsByTagName(t)[0];
            s.type = "text/javascript";
            s.async = true;
            s.src = m + "?v=" + Date.now();
            n.parentNode.insertBefore(s, n);
        })(document, "script", "//static.utmstat.com/client.min.js");
</script>
        
<!-- END OF UTMSTAT COUNTER CODE FOR Доминион -->

1.2 Убедитесь, что код действительно появился на сайте

1.2.1 Найдите код в исходном коде сайта по тексту "UTMSTAT.COM CODE"

1.2.2 Если у вас GTM, зайдите на ваш сайт по ссылке https://dominion-ltd.ru?utmstat_debug=1 и откройте консоль разработчика

Убедитесь что в консоли появилась отладочная информация - строки, начинающиеся на us.

Или отправляются аякс запросы

Проверьте этот факт для всех типовых страниц - главная, карточка товара, корзина, контакты. В идеале код должен быть в общем шаблоне.

1.2.3 Убедитесь, что у бота нет замечаний по счетчику и он зафиксировал клики от него

Если ни один из пунктов не прошел проверку, значит код или не поставлен, или поставлен, но не на тот сайт, или кэш. Проблема на вашей стороне.

1.3 Убедитесь, что код установлен 1 раз.

Бывает что код ставится и прямо в код сайта и в GTM. В итоге получается 2 экземпляра кода на сайте и все работает неправильно.

Для этого откройте консоль в хроме и провертье, что у вас также как на скриншотах ниже.

1.3.1 Правильный вариант

1.3.2 Неправильный вариант

Уберите код или из кода сайта или из GTM.

2. Передача client id в CRM из форм и корзины

2.1 В чем суть задачи

1. Найти в коде вашего сайта место, где заявка с формы или корзины отправляется по API в вашу CRM (AmoCRM, Bitrix24, RetailCRM).
2. В этот код добавить еще одну строчку кода, которая передает наш client id из COOKIES в поле utmstat в вашей CRM.
3. Убедиться что добавленный вами код действительно работает, для надо будет создать тестовую заявку и визуально проверить наличие значения в сделке в CRM.

Важно: если что-то не получается по инструкции, сразу обращайтесь в поддержку. Пришлите нам скриншот кода с сайта, где заявка уходит по API в вашу CRM (AmoCRM, Bitrix24, RetailCRM). Мы подскажем как нужно сделать.

2.2 Как настроить

Формы, по возможности, подключайте через захватчик форм.

Для корзины, в коде, где заказ передается в CRM (AmoCRM, Bitrix24, RetailCRM), нужно добавить проброс client id в поле сделки, например utmstat. Создайте, если его нет.

Пример кода PHP-кода для Bitrix24:

Код можно менять под ваши задачи, главное вытащить нужные значения из Cookies.

2.2.1 Если на сайте есть google analytics:

$data['fields']['UF_CRM_GOOGLE_CLIENT_ID'] = isset($_COOKIE['_ga']) ? $_COOKIE['_ga'] : null;

2.2.2 Если нет google analytics, но есть яндекс метрика:

$data['fields']['UF_CRM_YANDEX_CLIENT_ID'] = isset($_COOKIE['_ym_uid']) ? $_COOKIE['_ym_uid'] : null;

2.2.3 Если нет ни google analytics, ни яндекс метрики:

$data['fields']['UF_CRM_UTMSTAT'] = isset($_COOKIE['utmstat_client_id']) ? $_COOKIE['utmstat_client_id'] : null;

Все client id находятся в Cookies

Для остальных CRM делайте по аналогии.

Как все сделаете, после создания заказа, ваша CRM по вебхуку передаст всю информацию в UTMSTAT и по переданному client id определится источник заказа.

2.3 Проверить, что поле действительно передано

Важно: задача по передаче client id считается выполненой, только когда в CRM действительно видно client id. Никакие промежуточные логи значения не имеют.

После настройки передачи client id в поле utmstat, сделайте тестовую заявку и убедитесь визуально что значение действительно передается в вашу CRM.

Что делать:

1. Откройте вашу CRM (AmoCRM/Bitrix24/RetailCRM или что вы используете)
2. Откройте тестовый лид/сделку, которую вы ранее создали
3. Посмотрите поля тестового лида/сделки и убедитесь что поле utmstat содержит значение

Вот так:

3. Настройка JS-целей/событий

Целей нет. При необходимости создайте их в разделе Цели/События

4. Отладка

Для вывода отладочной информации в консоль и проверки что код работает, добавьте в url параметр utmstat_debug=1 — https://dominion-ltd.ru?utmstat_debug=1

5. Подключение API

Используйте API для передачи заявок в js-событиях или на сервере, для передачи повторных платежей.

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

<?php

//СОЗДАНИЕ ЛИДА

// При создании лида можно передавать id из вашей БД в один из параметров:
//
// 1. external_crm_number_id - числовой id// 2. external_crm_string_id - строковый id// 3. created_at - дата создания лида. Может быть в формате YYYY-MM-DD H:i:s или в формате timestamp
$url = 'https://api.utmstat.com/v2/leads/create';

$params = [
'hash'=> 'e393fcfddf2b5ca5a2089e8c2cc71fa3',
'fio' => 'fio',
'phone' => '7999000001',
'email' => 'test@example.com',
'order_status' => 1,
'order_price' => 1000,
'order_comment' => 'order_comment',
'client_id' => isset($_COOKIE['utmstat_client_id']) ? $_COOKIE['utmstat_client_id'] : null,
'tags' => 'Тег1, Тег2, Тег3',
'cookies' => json_encode($_COOKIE),
// 'created_at' => '2025-04-30 06:57:31'
];


//ОБНОВЛЕНИЕ ЛИДА

// Обновить лид можно по одному из 4-х id:
//
// 1. id - id лида внутри UTMSTAT// 2. queue_id - ранее выданный id очереди при добавлении лида// 3. external_crm_number_id - числовой id// 4. external_crm_string_id - строковый id
//$url = 'https://api.utmstat.com/v2/leads/update';

//$params = [
//    'hash'=> 'e393fcfddf2b5ca5a2089e8c2cc71fa3',
//    'id' => 12345,
//    'order_status' => 2,
//    'order_price' => 1000,
//];

//ПОИСК ЛИДОВ

// 1. id - id лида внутри UTMSTAT. Можно указать несколько id через запятую// 2. максимальное значение параметра limit - 20
$url = 'https://api.utmstat.com/v2/leads/search';

$params = [
'hash'=> 'e393fcfddf2b5ca5a2089e8c2cc71fa3',
'id' => '',
'phone' => '',
'email' => '',
'status_id' => 1,
'page' => 1,
'limit' => 20,
'created_at_from' => '2025-04-29',
'created_at_to' => '2025-04-30'
];

//ИНФОРМАЦИЯ О КОНТАКТЕ
//можно передавать или телефон или email или все вместе, в зависимости от того что известно.

$url = 'https://api.utmstat.com/v2/customers/get-info';

$params = [
'hash'=> 'e393fcfddf2b5ca5a2089e8c2cc71fa3',
'phone' => '7999000001',
'email' => 'test@example.com',
];

//ОТПРАВКА ЗАПРОСА

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_POST, count($params));
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);

$output = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($httpCode) {
echo 'done';
} else {
echo 'error';
}

curl_close($ch);

var_dump($httpCode);

var_dump($output);

6. Помощь

Если нужна помощь - пишите в чат или на почту support@utmstat.com