Сравните ссылку в исходном материале, целевом payload, опубликованном посте и конечном адресе после редиректов. Если метки были в посте, но исчезли на переходе, исправлять генератор текста рано. Начните с одной тестовой ссылки с уже существующим query и фрагментом: простая склейка через знак вопроса часто ломает именно этот случай.
Задайте политику: какие UTM-поля добавляет канал и что делать с существующими значениями. Повторная обработка не должна создавать несколько utm_source или бесконечно наращивать параметры. Метки не являются секретом; не помещайте в них email, телефон, токен доступа или приватный идентификатор пользователя.
Собирайте URL как структуру
// Условный пример JavaScript, без сетевого запроса
const url = new URL('https://example.invalid/news?a=1#details');
url.searchParams.set('utm_source', 'social');
url.searchParams.set('utm_medium', 'post');
url.searchParams.set('utm_campaign', 'demo');
const prepared = url.toString();
// query содержит a и выбранные метки; fragment остаётся detailsWHATWG URL Standard определяет URL и API URLSearchParams, включая работу с параметрами; источник проверен 22 октября 2026 года. Такой парсер отделяет query от fragment и выполняет сериализацию. Но он не определяет вашу политику атрибуции: решение заменить существующее значение или сохранить его должно быть явным.
Четыре адреса выявляют типовые ошибки
| Вход | Что проверить |
|---|---|
| Без query | Метки добавлены один раз |
| С query и fragment | Исходные параметры и fragment сохранены |
| Уже есть UTM | Применена выбранная политика без дублей |
| Подписанный временный URL | Изменение допустимо по контракту подписи либо ссылка исключена |
Не добавляйте параметры к подписанному URL наугад: изменение адреса может нарушить проверяемую подпись. Для таких ссылок нужен отдельный согласованный маршрут, например обычная разрешённая страница материала, которая затем выдаёт доступ. Переход не должен превращаться в открытый редиректор на произвольный адрес из пользовательского поля.
Для кириллицы и спецсимволов передавайте парсеру исходные значения и не выполняйте повторное percent-encoding готовой строки. Сравнивайте разобранные имена и значения параметров, а не только визуальную строку: эквивалентная сериализация может выглядеть иначе. Пробел и плюс особенно полезны в синтетическом наборе проверки.
Найдите первый редирект, который теряет query
- Сохранить подготовленный URL целевого варианта.
- Проверить фактическую ссылку после публикации.
- Проследить разрешённую цепочку переходов без приватных токенов.
- Сравнить параметры на каждой границе.
- Убедиться, что landing page принимает их и аналитика использует выбранные поля.
Короткая ссылка площадки может вести через собственный трекер; нельзя считать её отображаемый текст окончательным адресом. Одновременно наличие UTM в конечном URL не доказывает корректную атрибуцию заказа в CRM. Здесь проверяется доставка параметров до страницы; дальнейшее связывание событий имеет отдельный контракт.
Перед выпуском прогоните преобразователь дважды и проверьте устойчивый результат. Рабочее задание должно использовать зафиксированную целевую ссылку, чтобы повтор не подставил новые метки посреди кампании. Для разбора подготовьте четыре обезличенных URL и правило обработки существующих UTM. Это покажет, где метки теряются, без массовой замены всех ссылок и повреждения подписанных адресов.