Как передать информацию в Сквозную аналитику

Мы еще обновляем эту страницу

Тут может не хватать некоторых данных — дополним в ближайшее время

Scope: crm

Кто может выполнять метод: пользователи с административным доступом к разделу CRM

Если вы разрабатываете интеграции для Битрикс24 с помощью AI-инструментов (Codex, Claude Code, Cursor), подключите MCP-сервер, чтобы ассистент использовал официальную REST-документацию.

При создании элементов CRM есть три способа передать информацию для сквозной аналитики.

Самый простой

Передать в полях создаваемого элемента поле UTM_SOURCE.

В этом случае при создании элемента, если будет найден настроенный источник в сквозной аналитике с таким же UTM_SOURCE, элементу будет проставлен этот источник, будет выведена соответствующая иконка, элемент будет участвовать в отчете сквозной аналитики.

Полные данные

Передать в полях создаваемого элемента поле TRACE.

В этом случае будут учтены все данные — устройство, все каналы, в том числе и сайт, посещенные страницы.

Способ работает для методов: crm.lead.add, crm.deal.add, crm.contact.add, crm.company.add, crm.quote.add.

{
            "fields": {
                "NAME": "test",
                "LAST_NAME": "",
                "TRACE": ...
            },
        }

Значение М поля TRACE должен быть или идентификатор сохраненной записи сквозной аналитики или JSON-строка с массивом определенного формата, для получения которого можно просто воспользоваться JS-кодом виджета сквозной аналитики Битрикс24:

b24Tracker.guest.getTrace()

Значение поля TRACE может быть число — ID трейса, который получен методом crm.tracking.trace.add.

Создание трейса и получение его ID

Метод создает трейс:

crm.tracking.trace.add
        ?ENTITIES[0][TYPE]=CONTACT&ENTITIES[0][ID]=3215&ENTITIES[1][TYPE]=LEAD&ENTITIES[1][ID]=1&TRACE=

Поле TRACE обязательное, значение — строка, полученная методом b24Tracker.guest.getTrace. Пример выше.

Поле ENTITIES не обязательное, в нем можно перечислить сущности, которые связываются с этим трейсом:

ENTITIES: [
            {
                TYPE: 'CONTACT',
                ID: 1
            },
            {
                TYPE: 'LEAD',
                ID: 101
            }
        ]

Один трейс для связанных сущностей

Если создается пакет связанных сущностей (сделка + контакт + компания), то можно создать единый трейс для них. Если контакт и компания существующие, а создается только сделка, то можно создать трейс и привязать к существующим сущностям.

Продолжите изучение

Предыдущая
Как использовать сквозную аналитику при создании сделки и контакта
Следующая
Как встраивать виджеты в CRM