Marketing and UTM

gonka.gg captures first-touch attribution from URL parameters and stores it on registration. Use this for Telegram, newsletters, and partner channels.

Parameters

Parameter	Description	Example
`utm_source`	Traffic source	`telegram`
`utm_medium`	Channel type	`post`
`utm_campaign`	Campaign name	`kimi_launch`
`utm_content`	Creative / placement	`button_top`
`utm_term`	Optional keyword	`cheap_inference`
`promo` / `promo_code`	Promo at signup	`dev10`
`ref` / `referral_code`	Partner referral	`partner-abc123`

Example links

https://proxy.gonka.gg/?utm_source=telegram&utm_medium=post&utm_campaign=qwen_api&utm_content=main_cta
https://proxy.gonka.gg/register?ref=partner-abc123&utm_source=partner&utm_medium=referral&utm_campaign=partner-abc123
https://proxy.gonka.gg/register?promo=dev10&utm_source=x&utm_medium=influencer&utm_campaign=may_launch

Short referrals: https://proxy.gonka.gg/r/partner-abc123.

Tracked events

page_view, cta_click, registered, api_key_created, chat_message_sent, inference_success, spend. Partners review this in /dashboard/partner.

APIs

Method	Path	Auth	Description
POST	`/api/events`	Optional JWT	Record funnel events
GET	`/api/partner`	JWT	Referral + analytics

curl https://api.proxy.gonka.gg/api/events \
  -H "Content-Type: application/json" \
  -d '{"event_name":"landing_cta_clicked","path":"/","utm_source":"telegram","utm_campaign":"qwen_api"}'