ใช้ Analytics ใน WebView


การเรียกเพื่อบันทึกเหตุการณ์หรือตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ที่เรียกใช้จากภายใน WebView ต้อง ส่งต่อให้โค้ดเนทีฟก่อนจึงจะส่งไปยัง Google Analytics ได้

ใช้ตัวแฮนเดิล JavaScript

ขั้นตอนแรกในการใช้ Google Analytics ใน WebView คือการสร้าง ฟังก์ชัน 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.");
  }
}
index.js

เรียกตัวแฮนเดิล JavaScript จาก WebView

คุณสามารถบันทึกเหตุการณ์และตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ได้อย่างถูกต้องจากภายใน WebView โดยการเรียกใช้ฟังก์ชัน 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")    
}

ติดตั้งใช้งานอินเทอร์เฟซเนทีฟ

หากต้องการเรียกใช้โค้ด Android ดั้งเดิมจาก JavaScript ให้ใช้คลาสที่มี เมธอดที่ทำเครื่องหมาย @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) {
        // ...
    }

}
AnalyticsWebInterface.java

เมื่อสร้างอินเทอร์เฟซดั้งเดิมแล้ว ให้ลงทะเบียนกับ WebView เพื่อให้โค้ด JavaScript ที่ทำงานใน WebView มองเห็นอินเทอร์เฟซดังกล่าว

// 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);
}
MainActivity.java

ขั้นตอนถัดไป

ดูการติดตั้งใช้งาน Google Analytics ใน WebView ที่ใช้งานได้อย่างสมบูรณ์ ได้ที่ตัวอย่าง analytics-webview