Работа с UTM метками на PHP: парсинг, хранение и интеграция с аналитикой

Расширенные примеры обработки UTM меток

Пример 1: Полный класс с сохранением в сессию и куки

<?php
class UtmManager {
    private array $data = [];
    private const KEYS = ['utm_source','utm_medium','utm_campaign','utm_term','utm_content'];

    public function __construct(string $url = null) {
        $url = $url ?? ($_SERVER['REQUEST_URI'] ?? '');
        $this->extractFromUrl($url);
        $this->storeSession();
        $this->storeCookie(30);
    }

    private function extractFromUrl(string $url): void {
        $query = parse_url($url, PHP_URL_QUERY);
        if (!$query) return;
        parse_str($query, $params);
        foreach (self::KEYS as $key) {
            if (isset($params[$key])) {
                $val = $params[$key];
                if (is_array($val)) $val = $val[0]; // берём первый элемент
                $this->data[$key] = htmlspecialchars(strip_tags(urldecode($val)), ENT_QUOTES, 'UTF-8');
            }
        }
    }

    private function storeSession(): void {
        if (session_status() === PHP_SESSION_NONE) session_start();
        foreach ($this->data as $k => $v) {
            $_SESSION['utm'][$k] = $v;
        }
    }

    private function storeCookie(int $days): void {
        foreach ($this->data as $k => $v) {
            setcookie($k, $v, time() + $days * 86400, '/', '', false, true);
        }
    }

    public function getAll(): array { return $this->data; }
}

// Использование
$mgr = new UtmManager();
print_r($mgr->getAll());
?>

// При переходе по ссылке ?utm_source=test&utm_medium=email
Array
(
    [utm_source] => test
    [utm_medium] => email
)

Пример 2: Обработка UTM меток из HTTP_REFERER

$referer = $_SERVER['HTTP_REFERER'] ?? '';
if ($referer) {
    $query = parse_url($referer, PHP_URL_QUERY);
    parse_str($query, $params);
    $utm = array_intersect_key($params, array_flip(['utm_source','utm_medium']));
    if (!empty($utm)) {
        file_put_contents('utm.log', json_encode($utm) . PHP_EOL, FILE_APPEND);
    }
}

// В лог запишется: {"utm_source":"google","utm_medium":"organic"}

Пример 3: Передача UTM меток в JavaScript для dataLayer (Google Tag Manager)

$utm = new UtmTracker(); // класс из базового решения
$data = $utm->getAll();
?>
<script>
window.dataLayer = window.dataLayer || [];
dataLayer.push({
    'event': 'utm_loaded',
    'utmSource': '<?= addslashes($data['utm_source'] ?? '') ?>',
    'utmMedium': '<?= addslashes($data['utm_medium'] ?? '') ?>',
    'utmCampaign': '<?= addslashes($data['utm_campaign'] ?? '') ?>'
});
</script>

Пример 4: Обработка массива URL (например, загрузка UTM из файла)

$urls = [
    'https://site.com/?utm_source=a&utm_medium=b',
    'https://site.com/?utm_source=c&utm_term=test&utm_content=123',
];
$results = [];
foreach ($urls as $url) {
    $query = parse_url($url, PHP_URL_QUERY);
    parse_str($query, $p);
    $results[] = array_intersect_key($p, array_flip(['utm_source','utm_medium','utm_campaign','utm_term','utm_content']));
}
print_r($results);

Array
(
    [0] => Array
        (
            [utm_source] => a
            [utm_medium] => b
        )

    [1] => Array
        (
            [utm_source] => c
            [utm_term] => test
            [utm_content] => 123
        )
)

Пример 5: Защита от дублирования - сохранение меток только если они не были установлены ранее

session_start();
if (!isset($_SESSION['utm'])) {
    $utm = [];
    foreach (['utm_source','utm_medium','utm_campaign'] as $key) {
        if (isset($_GET[$key])) {
            $utm[$key] = $_GET[$key];
        }
    }
    if (!empty($utm)) {
        $_SESSION['utm'] = $utm;
    }
}

// При повторном заходе с другими UTM, старые значения останутся неизменными.