Как передать данные в сквозную аналитику CRM
Scope:
crmКто может выполнять методы: пользователь с правом на создание или изменение объекта CRM
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Данные сквозной аналитики помогают связать лид, сделку, контакт, компанию или коммерческое предложение с источником обращения и маршрутом клиента. В CRM можно передать только источник через UTM-поля или полный трейс с данными посещений.
Трейс — это набор данных о пути клиента до обращения: источник перехода, посещенные страницы и другие параметры визита. По трейсу CRM понимает, откуда пришел клиент и какие действия он совершил перед созданием объекта.
Чтобы передать данные в аналитику CRM, выберите способ:
|
Если нужно |
Что передать |
На какие методы опираться |
|
Передать только рекламный источник при создании объекта |
UTM-поля: |
|
|
Передать полный маршрут клиента при создании объекта |
|
|
|
Связать один трейс с несколькими или с уже созданными объектами |
|
1. Передайте UTM-источник
Если для отчета достаточно рекламного источника, передайте UTM_SOURCE при создании объекта CRM. Значение должно совпадать с настроенным источником в сквозной аналитике.
UTM-поля есть у основных объектов CRM. Проверьте список полей в описании метода, которым создаете объект:
- crm.lead.add — лид
- crm.deal.add — сделка
- crm.contact.add — контакт
- crm.company.add — компания
- crm.quote.add — коммерческое предложение
Такой способ подходит, когда нужно передать только канал привлечения: рекламную систему, кампанию, объявление или ключевое слово.
Универсальный метод crm.item.add принимает UTM-поля в camelCase, например utmSource, и сохраняет их в объекте. Но он не формирует путь клиента в сквозной аналитике: трейс не создается, а поля TRACE в методе нет.
Чтобы данные попали в сквозную аналитику, создавайте объект специальными методами CRM или отдельно привяжите трейс через crm.tracking.trace.add.
2. Передайте полный трейс при создании объекта
Полный трейс содержит данные о маршруте клиента: источник, страницы сайта и другие параметры посещения. Значение для TRACE можно получить на сайте через JS-код сквозной аналитики Битрикс24:
b24Tracker.guest.getTrace()
Скрипт сквозной аналитики должен быть установлен на страницах сайта, где собирается маршрут клиента. Обычно значение TRACE сохраняют в скрытом поле формы и отправляют вместе с данными клиента.
Если метод создания объекта поддерживает поле TRACE, передайте в него полученную строку. Такой вариант подходит, когда один объект создается сразу после заполнения формы. Например, заявка с сайта создает лид или контакт, а данные сквозной аналитики передаются вместе с основными полями объекта.
Подробные параметры и примеры смотрите в описании метода создания нужного объекта. В практических сценариях показано, как передать TRACE при создании:
3. Свяжите объекты одним трейсом
Если сценарий создает несколько связанных объектов, сначала сохраните данные клиента, затем свяжите их с одним трейсом методом crm.tracking.trace.add.
Например, форма на сайте может создать контакт и сделку. После создания объектов передайте в crm.tracking.trace.add:
TRACE— строку с данными сквозной аналитикиENTITIES— список объектов, которые нужно связать с трейсом
Этот способ подходит и для объектов, созданных универсальным методом crm.item.add: трейс к ним можно привязать после создания.
Метод вернет идентификатор созданного трейса. Его можно сохранить на стороне интеграции, если в сценарии нужно позже удалить трейс или очистить привязку.
Удаление трейса
Удаляйте трейс, если его ошибочно привязали к объекту или нужно очистить тестовые данные.
Для удаления используйте метод crm.tracking.trace.delete. Укажите идентификатор трейса id, который вернул метод crm.tracking.trace.add.