वेबव्यू में Analytics का इस्तेमाल करना


इवेंट को लॉग करने या वेबव्यू में ट्रिगर की गई उपयोगकर्ता प्रॉपर्टी सेट करने के लिए किए गए कॉल को Google Analytics पर भेजने से पहले, नेटिव कोड पर भेजा जाना चाहिए.

JavaScript हैंडलर लागू करना

वेबव्यू में Google Analytics का इस्तेमाल करने के लिए, सबसे पहले JavaScript फ़ंक्शन बनाएं. इनकी मदद से, इवेंट और उपयोगकर्ता प्रॉपर्टी को नेटिव कोड पर भेजा जा सकता है. नीचे दिए गए उदाहरण में, ऐसा करने का तरीका बताया गया है जो Android और Apple, दोनों के नेटिव कोड के साथ काम करता है:
function logEvent(name, params) {
  if (!name) {
    return;
  }

  if (window.AnalyticsWebInterface) {
    // Call Android interface
    window.AnalyticsWebInterface.logEvent(name, JSON.stringify(params));
  } else if (window.webkit
      && window.webkit.messageHandlers
      && window.webkit.messageHandlers.firebase) {
    // Call iOS interface
    var message = {
      command: 'logEvent',
      name: name,
      parameters: params
    };
    window.webkit.messageHandlers.firebase.postMessage(message);
  } else {
    // No Android or iOS interface found
    console.log("No native APIs found.");
  }
}

function setUserProperty(name, value) {
  if (!name || !value) {
    return;
  }

  if (window.AnalyticsWebInterface) {
    // Call Android interface
    window.AnalyticsWebInterface.setUserProperty(name, value);
  } else if (window.webkit
      && window.webkit.messageHandlers
      && window.webkit.messageHandlers.firebase) {
    // Call iOS interface
    var message = {
      command: 'setUserProperty',
      name: name,
      value: value
   };
    window.webkit.messageHandlers.firebase.postMessage(message);
  } else {
    // No Android or iOS interface found
    console.log("No native APIs found.");
  }
}

अपने वेबव्यू से JavaScript हैंडलर को कॉल करना

पिछले चरण में तय किए गए JavaScript फ़ंक्शन को कॉल करके, वेबव्यू में इवेंट को सही तरीके से लॉग किया जा सकता है और उपयोगकर्ता प्रॉपर्टी सेट की जा सकती हैं. यहां दिए गए उदाहरण में, परचेज़ इवेंट को सही तरीके से लॉग करने और उदाहरण के तौर पर उपयोगकर्ता प्रॉपर्टी सेट करने का तरीका बताया गया है:
function logEventExample() {
   
   // Log an event named "purchase" with parameters
   logEvent("purchase", {
      content_type: "product",
      value: 123,
      currency: "USD",
      quantity: 2,
      items: [{
        item_id: "sample-item-id",
        item_variant: "232323"
      }],
      transaction_id: "1234567"
   });
}

function logUserPropertyExample() {
   // Set a user property named 'favorite_genre'
   setUserProperty("favorite_genre", "comedy")    
}

नेटिव इंटरफ़ेस लागू करना

JavaScript से नेटिव Android कोड को कॉल करने के लिए, @JavaScriptInterface के तौर पर मार्क किए गए तरीकों वाली क्लास लागू करें:

public class AnalyticsWebInterface {

    public static final String TAG = "AnalyticsWebInterface";
    private FirebaseAnalytics mAnalytics;

    public AnalyticsWebInterface(Context context) {
        mAnalytics = FirebaseAnalytics.getInstance(context);
    }

    @JavascriptInterface
    public void logEvent(String name, String jsonParams) {
        LOGD("logEvent:" + name);
        mAnalytics.logEvent(name, bundleFromJson(jsonParams));
    }

    @JavascriptInterface
    public void setUserProperty(String name, String value) {
        LOGD("setUserProperty:" + name);
        mAnalytics.setUserProperty(name, value);
    }

    private void LOGD(String message) {
        // Only log on debug builds, for privacy
        if (BuildConfig.DEBUG) {
            Log.d(TAG, message);
        }
    }

    private Bundle bundleFromJson(String json) {
        // ...
    }

}

नेटिव इंटरफ़ेस बनाने के बाद, उसे अपने वेबव्यू के साथ रजिस्टर करें, ताकि वह वेबव्यू में चल रहे JavaScript कोड को दिख सके:

// Only add the JavaScriptInterface on API version JELLY_BEAN_MR1 and above, due to
// security concerns, see link below for more information:
// https://developer.android.com/reference/android/webkit/WebView.html#addJavascriptInterface(java.lang.Object,%20java.lang.String)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
    mWebView.addJavascriptInterface(
            new AnalyticsWebInterface(this), AnalyticsWebInterface.TAG);
} else {
    Log.w(TAG, "Not adding JavaScriptInterface, API Version: " + Build.VERSION.SDK_INT);
}

अगले चरण

वेबव्यू में Google Analytics को पूरी तरह से लागू करने के लिए, analytics-webview का सैंपल देखें.