Как передать UTM метки в Битрикс 24?

В CRM Битрикс24 вы можете передавать UTM-метки с помощью различных методов, в зависимости от того, как вы интегрировали свой сайт с CRM. В данной статье речь пойдет о передачи меток при самостоятельной интеграции при помощи API Битрикса. Итак, для того, чтобы передать UTM метки в Битрикс24:

  1. Понадобится «интеграция для передачи лидов с сайта в CRM Битрикс24 через API». К примеру, смотрите готовые решения по интеграции для:
  2. Настроить сбор и передачу UTM меток в Битрикс24. К примеру, для сбора можно использовать готовое решение — JavaScript для «записи UTM в Cookies». Данный скрипт сохраняем UTM метки в cookies вашего сайта.

Согласно документации Битрикс24, для API доступны следующие «параметры для передачи UTM меток в CRM»:

  • UTM_CAMPAIGN
  • UTM_CONTENT
  • UTM_MEDIUM
  • UTM_SOURCE
  • UTM_TERM

Таким образом, передача UTM через API будет выглядеть следующим образом:

'UTM_SOURCE' => 'Значение utm_Source',
'UTM_MEDIUM' => 'Значение utm_Medium',
'UTM_CONTENT' => 'Значение utm_Content',
'UTM_TERM' => 'Значение utm_Term',
'UTM_CAMPAIGN' => 'Значение utm_Camping',

Теперь только остается настроить автоматическую запись значений UTM.

Самый простой и корректный способ — записывать utm метки в cookies и оттуда уже подтягивать данные в код для API.

Достать данные из cookies можно при помощи php используя массив $_COOKIE. Вот простой пример:

$getSource = $_COOKIE['utm_source'];
$getMedium = $_COOKIE['utm_medium'];
$getCamping = $_COOKIE['utm_campaign'];
$getTerm = $_COOKIE['utm_term'];
$getContent = $_COOKIE['utm_content'];

Этот код проверяет наличие cookie , если она существует, выводит ее значение.

Полный пример кода API для передачи UTM в Битрикс24

$getName = "Заголовок для лида"; 
$getDomain = $_SERVER['SERVER_NAME'];

// Получаем UTM метки из Cookies
$getSource = $_COOKIE['utm_source'];
$getMedium = $_COOKIE['utm_medium'];
$getCamping = $_COOKIE['utm_campaign'];
$getTerm = $_COOKIE['utm_term'];
$getContent = $_COOKIE['utm_content'];
	
// Указываем вебхук для обращения в CRM
$queryUrl = 'https://****.bitrix24.ru/rest/***/**************/crm.lead.add.json';

// формируем параметры для создания лида в CRM
$queryData = http_build_query(array(
	'fields' => array(
		'TITLE' => $form_name,
		'SOURCE_ID' => 'WEB',
		'WEB' => Array(
			"n0" => Array(
				"VALUE" => $getDomain,
				"VALUE_TYPE" => "WORK",
			),
		),
		'UTM_SOURCE' => $getSource,
		'UTM_MEDIUM' => $getMedium,
		'UTM_CONTENT' => $getContent,
		'UTM_TERM' => $getTerm,
		'UTM_CAMPAIGN' => $getCamping,
	),
	'params' => array("REGISTER_SONET_EVENT" => "Y")
));

// обращаемся к Битрикс24 при помощи функции curl_exec
$curl = curl_init();
curl_setopt_array($curl, array(
	CURLOPT_SSL_VERIFYPEER => 0,
	CURLOPT_POST => 1,
	CURLOPT_HEADER => 0,
	CURLOPT_RETURNTRANSFER => 1,
	CURLOPT_URL => $queryUrl,
	CURLOPT_POSTFIELDS => $queryData,
));
$result = curl_exec($curl);
curl_close($curl);
$result = json_decode($result, 1);
if (array_key_exists('error', $result)) echo "Ошибка при сохранении лида: ".$result['error_description']."
";

Передача UTM-меток в CRM Битрикс24 позволяет связать информацию о источнике трафика с конкретными записями о клиентах или сделках в вашей CRM. В целом, передача UTM-меток в CRM Битрикс24 помогает сделать ваш маркетинг более прозрачным, эффективным и ориентированным на результаты.

Понравилась статья? Поделись ей =)
Вам также может быть интересно
Оставить комментарий

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