Источники по UTM

UTM в боте работает не так, как в вебе — там нет адреса с параметрами. В Telegram параметр передаётся в команде /start:

https://t.me/your_bot?start=instagram

Telegram вставит этот параметр в первое сообщение пользователя:

/start instagram

MaxBotStat умеет это разбирать и сохранять как источник контакта.

Настройка ключа UTM

По умолчанию ключ — utm_source, но это меняется. Зайдите в Настройки бота → Источники:

ключ = source         → /start source=instagram
ключ = utm_source     → /start utm_source=instagram

Допустимые форматы стартового параметра:

Формат	Пример	Разберётся как
просто значение	/start instagram	source_value=instagram
ключ=значение	/start utm_source=instagram	source_value=instagram (если ключ — utm_source)
несколько ключей	/start utm_source=ig|utm_campaign=spring	source_value=ig, campaign_name=spring

TIP

Поддерживаются разделители | и & для нескольких пар. Регистр значений сохраняется как есть.

Сопоставления

Можно нормализовать источники: например, превратить ig, Instagram, instagram_main в одно значение Instagram.

В разделе Источники добавьте сопоставление:

исходное значение: ig
нормализованное:   Instagram
кампания:          Spring sale

После этого в отчётах все три варианта схлопнутся в Instagram / Spring sale.

Где смотреть

• Раздел «Источники» — таблица: источник, число контактов, сумма касаний, последний контакт.
• Карточка контакта — индивидуальный источник и кампания.
• Открытый API — GET /api/v1/bots/<botId>/sources.

Через открытый API

curl "https://app.maxbotstat.ru/api/v1/bots/<botId>/sources" \
     -H "X-API-Key: mbs_..."

{
  "utm_key": "utm_source",
  "data": [
    { "source_value": "instagram", "campaign_name": "spring", "contacts_count": 412, "touches": 1024 },
    { "source_value": "ads",       "campaign_name": null,     "contacts_count": 88,  "touches": 162 },
    { "source_value": "— unmapped","campaign_name": null,     "contacts_count": 5,   "touches": 12 }
  ]
}

— unmapped — это контакты, у которых не было /start с параметром (зашли напрямую через диалог).

Полезные ссылки

• Telegram Bot API → глубокие ссылки
• Воронки — анализ конверсии по этапам пути.