.NET MAUI中HybridWebView的Google Analytics标签在iOS上失效

针对Android平台Gtag正常、iOS平台无Google Analytics数据的问题，可按以下步骤排查：

• 检查iOS ATS配置
  打开项目的Info.plist，确认是否配置了App Transport Security（ATS）允许Google相关域名的请求。添加以下配置，确保HTTPS请求可正常发送：

  <key>NSAppTransportSecurity</key>
  <dict>
      <key>NSExceptionDomains</key>
      <dict>
          <key>googletagmanager.com</key>
          <dict>
              <key>NSIncludesSubdomains</key>
              <true/>
              <key>NSExceptionAllowsInsecureHTTPLoads</key>
              <false/>
          </dict>
          <key>google-analytics.com</key>
          <dict>
              <key>NSIncludesSubdomains</key>
              <true/>
              <key>NSExceptionAllowsInsecureHTTPLoads</key>
              <false/>
          </dict>
      </dict>
  </dict>
  

• 调试WebView控制台日志
  用Safari调试iOS上的WebView：

  1. 打开Safari偏好设置→高级，勾选「显示开发菜单」
  2. 将iPhone连接到电脑，在Safari「开发」菜单中选择你的设备，找到对应HybridWebView页面
  3. 查看控制台是否有Gtag加载失败、请求拦截等报错，也可执行console.log(dataLayer)检查数据层初始化状态

• 抓包验证网络请求
  使用Charles或Wireshark抓取iOS设备网络流量：

  • 若没有向google-analytics.com/googletagmanager.com发送请求，说明WebView请求被阻止
  • 若有请求，检查响应状态码（如403、404），判断是否为参数错误或服务器拒绝

• 确认隐私权限配置
  iOS要求App声明追踪用途才能发送分析数据，在Info.plist中添加：

  <key>NSUserTrackingUsageDescription</key>
  <string>我们需要收集数据以优化应用体验</string>
  

  同时在代码中调用ATTrackingManager.RequestTrackingAuthorizationAsync()请求追踪权限

• 测试简化版Gtag代码
  修改analytics.html的Gtag代码，去掉异步加载并手动触发测试事件，排除加载时序问题：

  <script src="https://www.googletagmanager.com/gtag/js"></script>
  <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
      gtag('config', 'MYANALYTICSKEYISHERE');
      // 手动触发测试事件
      gtag('event', 'debug_test', {
          'event_category': 'test',
          'event_label': 'ios_debug'
      });
  </script>
  

  之后查看GA实时报告是否有该测试事件

• 修改WebView的UserAgent
  iOS WebView默认UA可能被Google服务识别为非浏览器环境，在Platforms/iOS/Program.cs中添加代码修改UA：

  Microsoft.Maui.Handlers.WebViewHandler.Mapper.AppendToMapping("CustomUA", (handler, view) =>
  {
      if (handler.PlatformView is WKWebView wkWebView)
      {
          wkWebView.CustomUserAgent = "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1";
      }
  });
  

• 验证GA后台配置
  确认GA测量ID正确、数据流已启用，且未设置IP过滤（避免测试设备IP被屏蔽），同时注意GA实时数据有1-5分钟延迟，不要立即判定无数据

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