Android Studio中如何让合作方通过Google Analytics追踪App WebView页面访问？

阿华AIGC实验室

2026-5-15

Can Google Analytics track visits from our Android App's WebView as a specific source?

Hey there, great question! This is totally achievable—here are the most straightforward, reliable ways to make your partner's Google Analytics account recognize visits coming from your Android App's WebView:

1. Add UTM Tracking Parameters to the Loaded URL

This is the simplest, GA-native approach. UTM parameters are designed explicitly for tracking traffic sources, and GA will automatically parse them into its reports.

When loading your partner's webpage in the WebView, append these parameters to the URL:

utm_source: The name of your app (e.g., YourAppOfficial)
utm_medium: The type of traffic (e.g., android_webview)
utm_campaign: A label for the partnership (e.g., partner_collab_2024)

Example Code (Kotlin):

val basePartnerUrl = "https://partner-website.com/target-page"
val trackedUrl = "$basePartnerUrl?utm_source=YourAppOfficial&utm_medium=android_webview&utm_campaign=partner_collab_2024"
webView.loadUrl(trackedUrl)

Your partner will immediately see these visits grouped under the specified source/medium in their GA Acquisition reports—no extra setup needed on their end beyond checking those standard reports.

2. Customize the WebView's User-Agent String

You can modify the WebView's User-Agent to include a unique identifier for your app. GA can use this string to filter or segment traffic from your WebView.

Example Code (Kotlin):

// Keep the default User-Agent and append your app's identifier
val defaultUserAgent = webView.settings.userAgentString
val customUserAgent = "$defaultUserAgent YourAppOfficial/1.0 (Android WebView)"
webView.settings.userAgentString = customUserAgent

Your partner can then create a custom segment in GA to filter visits where the User-Agent contains YourAppOfficial or Android WebView, giving them a clear view of traffic from your app.

3. Pass App Source Data via JavaScript Interface (For Advanced Tracking)

If your partner wants more granular, custom data (like user IDs or app version), you can use a JavaScript interface to pass this information directly to their GA implementation on the webpage.

Step 1: Create an Interface Class in Your App

class AppSourceInterface {
    @JavascriptInterface
    fun getAppSource(): String {
        return "YourAppOfficial_WebView"
    }

    // Optional: Add more methods to pass additional data
    @JavascriptInterface
    fun getAppVersion(): String {
        return BuildConfig.VERSION_NAME
    }
}

Step 2: Attach the Interface to the WebView

webView.settings.javaScriptEnabled = true
webView.addJavascriptInterface(AppSourceInterface(), "AppSource")

Step 3: Partner's Webpage Updates Their GA Code

Your partner can then call these methods in their frontend code to set custom dimensions or user properties in GA:

// Set a custom dimension for app source
gtag('set', 'user_properties', {
  app_source: AppSource.getAppSource(),
  app_version: AppSource.getAppVersion()
});

This method requires collaboration with your partner to update their webpage code, but it offers maximum flexibility for custom tracking.

Key Notes for Smooth Implementation:

Ensure third-party cookies are enabled in the WebView (critical for GA session persistence):

CookieManager.getInstance().setAcceptCookie(true)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
}