Практика · API и интеграции
Как передавать UTM при создании ссылки через API
UTM добавляйте к длинному url в поле url до POST — так же, как в UI; не к короткому домену.
Метки теряются при автосоздании
Скрипт шлёт голый https://shop.ru/promo — в GA всё (direct).
UTM в target url JSON
Соберите long URL с utm_* query на стороне интеграции; передайте в поле url API. Короткий адрес Kratk редиректит с сохранением query.
Пошаговая инструкция
- Шаблон: base + utm_source, utm_medium, utm_campaign (+ content/term).
- URL-encode query в JSON.
- POST create link.
- Test redirect: final landing содержит UTM.
- Документируйте mapping campaign_id → utm в repo.
Практический пример
{"url":"https://shop.ru/sale?utm_source=api&utm_medium=crm&utm_campaign=partner_42"}
Типичные ошибки
- utm на kratk.ru/s/xxx вместо target.
- Дубли ? в url при concat.
- Разный register utm_source.
- Забыть encode кириллицы в campaign.
FAQ
Отдельные поля utm в API?
Если нет в curl кабинета — только в составе url.
GA4 видит?
Да при корректном redirect на tagged landing.
Вывод
UTM + API = tagged long url в одном поле. Гайд UTM — как правильно использовать UTM.
Связанные материалы
Нужна короткая ссылка для кампании?
В Kratk можно создать ссылку, поставить её в канал и смотреть переходы в аналитике. Это один из способов — статья полезна и без регистрации.