iOS Deeplink配置UTM参数后无法在GA4中显示，求指导

一、基础配置检查 #

• 确认Deeplink参数解析有效性：确保APP能完整读取Deeplink中的utm_source、utm_medium、utm_campaign等参数，跳转过程中不能丢失参数。可通过UIApplicationDelegate的application(_:open:options:)或SceneDelegate的scene(_:openURLContexts:)方法获取URL并打印参数，验证是否能拿到完整UTM值。
• GA4 SDK初始化时机：必须在解析Deeplink参数之后再初始化GA4 SDK，或在拿到参数后手动传递给GA4。若SDK先初始化，后续获取的UTM参数无法被归因系统识别。

二、手动传递UTM参数到GA4 #

自动归因失效时，手动传递是可靠解决方案：

1. 从Deeplink URL提取UTM参数：

func extractUTMParameters(from url: URL) -> [String: String] {
    var params = [String: String]()
    guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
          let queryItems = components.queryItems else { return params }
    for item in queryItems {
        if item.name.starts(with: "utm_") {
            params[item.name] = item.value
        }
    }
    return params
}

2. 将参数传递给GA4：

let utmParams = extractUTMParameters(from: deeplinkURL)
if !utmParams.isEmpty {
    // 方案1：调用官方API设置归因参数
    Analytics.setCampaignParametersFromUrl(deeplinkURL)
    // 方案2：若方案1无效，可通过自定义事件携带参数
    Analytics.logEvent("deeplink_open", parameters: utmParams)
}

三、GA4后台配置验证 #

• 归因窗口设置：GA4默认首次用户归因窗口为7天，若用户此前已打开过APP，Deeplink的UTM参数不会覆盖原有归因。可在GA4后台「管理」-「属性设置」-「归因」中调整窗口，或使用从未打开过APP的新设备测试。
• 事件报告校验：若自动归因无数据，先查看自定义事件deeplink_open的参数是否正确上报。可在GA4「探索」中创建自定义报表，查看该事件对应的utm_source、utm_medium等维度数据。

四、常见问题排查 #

• Universal Links冲突：若同时配置了Universal Links，需确保在continueUserActivity方法中同样解析URL参数，部分场景下Universal Links跳转可能过滤参数。
• 参数大小写问题：GA4对UTM参数大小写敏感，必须使用小写格式（如utm_source而非UTM_SOURCE），否则无法被正确识别。
• 测试环境限制：模拟器测试时部分归因逻辑可能失效，建议使用真实设备测试，同时确保测试设备未被加入GA4「排除内部流量」列表。

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