實作 JavaScript 處理程序
在 WebView 中使用 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 呼叫本機 Apple 程式碼,請建立符合WKScriptMessageHandler
協定的訊息處理程序類別。您可以在userContentController:didReceiveScriptMessage:
回呼中進行 Google Analytics 呼叫:
迅速
注意:此 Firebase 產品在 macOS 目標上不可用。
func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) { guard let body = message.body as? [String: Any] else { return } guard let command = body["command"] as? String else { return } guard let name = body["name"] as? String else { return } if command == "setUserProperty" { guard let value = body["value"] as? String else { return } Analytics.setUserProperty(value, forName: name) } else if command == "logEvent" { guard let params = body["parameters"] as? [String: NSObject] else { return } Analytics.logEvent(name, parameters: params) } }
Objective-C
- (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message { if ([message.body[@"command"] isEqual:@"setUserProperty"]) { [FIRAnalytics setUserPropertyString:message.body[@"value"] forName:message.body[@"name"]]; } else if ([message.body[@"command"] isEqual: @"logEvent"]) { [FIRAnalytics logEventWithName:message.body[@"name"] parameters:message.body[@"parameters"]]; } }
最後,將訊息處理程序新增至 webview 的使用者內容控制器:
迅速
注意:此 Firebase 產品在 macOS 目標上不可用。
self.webView.configuration.userContentController.add(self, name: "firebase")
Objective-C
注意:此 Firebase 產品在 macOS 目標上不可用。
[self.webView.configuration.userContentController addScriptMessageHandler:self name:@"firebase"];
下一步
有關 WebView 中 Google Analytics 的完整功能實現,請參閱analytics-webview範例。