Laravel集成MixPanel：UTM Source默认值设置及有效期咨询

核心问题梳理 #

你已配置的UTM规则（覆盖$referrer、$social、$email等）运行正常，但默认值设为$direct导致内部导航时每次页面加载都会重复标记该来源。根据MixPanel文档，只有首次无外部推荐来源的访问才应标记为$direct，后续内部跳转无需重复设置。

重新设置$direct的合理间隔选择 #

间隔时长需结合业务场景决定：

• 1小时：适合用户高频访问的工具类网站，短时间内返回算同一会话，不重置
• 1天：内容/电商类网站的通用选择，符合用户常规访问间隔
• 1周：适配低频访问平台（如企业服务、垂直社区）
• 无限期：仅适合需永久保留首次访问来源标记的场景，否则不推荐，会丢失用户后续直接访问的统计数据

Laravel端实现（Cookie跟踪方案） #

通过设置带过期时间的Cookie，判断是否需要重新标记$direct：

1. 创建中间件

php artisan make:middleware TrackMixpanelSource

2. 编写中间件逻辑

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class TrackMixpanelSource
{
    public function handle(Request $request, Closure $next)
    {
        // 检查是否已存在来源标记Cookie
        if (!$request->cookie('mixpanel_source_tracked')) {
            // 调用现有逻辑判断是否存在其他UTM来源
            $hasValidSource = $this->validateOtherUtmSources($request);
            
            if (!$hasValidSource) {
                // 无其他来源时，标记$direct
                $request->attributes->set('mixpanel_source', '$direct');
            }
            
            // 设置Cookie，过期时间按业务需求配置（示例为1天，1440分钟）
            $response = $next($request);
            return $response->cookie('mixpanel_source_tracked', '1', 1440);
        }
        
        return $next($request);
    }
    
    // 复用你已有的UTM来源判断逻辑
    private function validateOtherUtmSources(Request $request)
    {
        // 此处写入你判断$referrer/$social等来源的逻辑，返回true/false
        return $request->query('utm_source') || /* 其他自定义条件 */;
    }
}

3. 注册中间件
   在app/Http/Kernel.php的web中间件组中添加：

\App\Http\Middleware\TrackMixpanelSource::class,

MixPanel JS端配合处理 #

前端无需重复设置$direct，只需接收后端传递的来源变量后上报：

// 在Blade模板中输出后端传递的来源数据
<script>
    const mixpanelSource = "{{ request()->get('mixpanel_source') }}";
    
    if (mixpanelSource) {
        // 设置用户初始来源
        mixpanel.people.set({
            '$initial_referrer': mixpanelSource,
            '$initial_referring_domain': mixpanelSource
        });
        // 或在页面浏览事件中携带来源
        mixpanel.track('Page View', {
            'utm_source': mixpanelSource
        });
    }
</script>

额外注意点 #

• 用户清除浏览器Cookie后，会重新触发$direct标记，符合统计逻辑
• 若需区分已登录用户，可结合Laravel认证系统，从数据库读取用户首次访问来源，无需依赖Cookie
• 测试时需清除Cookie，验证不同时间间隔下的标记逻辑是否符合预期

内容的提问来源于stack exchange，提问作者alexmcfarlane