在 WebView 中发送事件或设置用户属性之前,必须先转发到原生代码,然后才可以将这些调用发送到 Google Analytics(分析)。
实现 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(分析)调用:
Swift
注意:此 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 的用户内容控制器:
Swift
注意:此 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 示例。