如何在iOS中追踪自定义推广链接的Flutter应用安装量？

除了申请App Tracking Transparency（ATT）权限，你还得完成以下操作才能实现网红推广的UTM追踪：

• 开启App Store Connect归因配置

  1. 登录App Store Connect找到你的应用，进入「App Analytics」确保功能已开启——这是苹果接收归因数据的基础。
  2. 配置SKAdNetwork：iOS 14+之后，ATT权限之外，SKAdNetwork是苹果官方的无IDFA归因方案，必须在Info.plist里添加对应网络的SKAdNetwork ID，比如Google Ads、网红推广平台的专属ID（如果平台提供），格式示例：

     <key>SKAdNetworkItems</key>
     <array>
       <dict>
         <key>SKAdNetworkIdentifier</key>
         <string>cstr6suwn9.skadnetwork</string> <!-- Google Ads的SKAdNetwork ID -->
       </dict>
       <!-- 其他平台ID按需添加 -->
     </array>
     

• 完善Info.plist关键配置

  1. 除了ATT权限描述NSUserTrackingUsageDescription（要写清楚追踪用途，比如“统计网红推广带来的安装量，优化推广效果”），还要添加LSApplicationQueriesSchemes字段，声明应用专属链接用到的scheme或通用链接，确保应用能被正确唤起。比如用了通用链接applinks:yourdomain.com，配置示例：

     <key>LSApplicationQueriesSchemes</key>
     <array>
       <string>applinks</string>
     </array>
     

  2. 如果用Firebase Analytics（Flutter集成GA的常用方式），确保GoogleService-Info.plist已正确导入iOS项目，里面的CLIENT_ID、TRACKING_ID等参数要和你的Firebase项目匹配。

• iOS端Analytics初始化与参数捕获

  1. 确保Flutter的firebase_analytics插件是最新版，在iOS项目的Podfile里执行pod install更新依赖。
  2. 在AppDelegate.swift（或SceneDelegate.swift）里添加Firebase初始化代码，保证应用启动时完成初始化：

     import Firebase
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
         FirebaseApp.configure()
         return true
     }
     

  3. 用uni_links这类Flutter插件获取深层链接里的UTM参数（utm_source、utm_medium、utm_campaign等），手动上报给Analytics，示例代码：

     import 'package:firebase_analytics/firebase_analytics.dart';
     import 'package:uni_links/uni_links.dart';
     
     Future<void> trackUtmParams() async {
       final link = await getInitialLink();
       if (link != null) {
         final uri = Uri.parse(link);
         final params = uri.queryParameters;
         await FirebaseAnalytics.instance.logEvent(
           name: 'promotion_install',
           parameters: {
             'utm_source': params['utm_source'],
             'utm_medium': params['utm_medium'],
             'utm_campaign': params['utm_campaign'],
             // 其他UTM参数按需添加
           },
         );
       }
     }
     

     记得在应用启动时调用这个方法。

• 测试验证归因流程

  1. 用TestFlight分发测试包——真机调试可能无法触发完整的归因逻辑。
  2. 生成带UTM参数的推广链接，通过Safari打开并安装应用，再去Firebase控制台查看promotion_install事件是否正确捕获到参数。
  3. 可以在App Store Connect的「SKAdNetwork Reporting」里查看归因数据，验证SKAdNetwork配置是否生效。

• 版本适配注意事项
  iOS 14.5及以上版本，必须先弹出ATT权限请求弹窗，用户授权后才能获取IDFA实现精准个体追踪；如果用户拒绝授权，SKAdNetwork仍会提供匿名归因数据，所以两者的配置都不能少。

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