from urllib.parse import urlencode
q = urlencode({'utm_source':'mail','utm_medium':'email','utm_campaign':'welcome'})
url = 'https://example.com/?' + q
邮件发出两周，统计后台来自邮件的会话是 0，全部落在 direct 里，点击链接本身还能正常打开。先别急着动参数，把报错原文和时间点记下来，顺序反了容易白折腾。
原因不复杂，链接里的参数写成了 utm-source 和 utm_medium 混用，统计脚本只认 utm_source，取不到就把来源记成直接访问。参数中间还夹了一个未编码的 &。
「邮件 UTM 参数」改完先别急着全量，挑一台机器放半天，真有问题这段时间就能看出来。备份不是备了就行，恢复一次才算数，很多备份文件打开才发现是空的。
接口问题先分清是没发出去、发出去了没收到，还是收到了处理失败。偶发问题先统计频率，一小时几次和一天一次，查法完全不同。
改完顺手把文档补一句，省得下次自己重新推一遍。
处理上按这个顺序：参数名统一成 utm_source、utm_medium、utm_campaign 三个，大小写固定；用 urlencode 拼参数，别手写字符串；发出前打开一条链接，看落地页的统计请求里参数是否齐全。
改完只确认一件事：后台来源报表里出现 mail 渠道，direct 占比回落到正常水平。