在 Web 視圖中使用分析

從 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 呼叫:

迅速

注意:此 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範例。