Używanie Analytics w komponencie WebView

Wywołania funkcji logowania zdarzeń lub ustawiania właściwości użytkownika uruchamiane w obszarze WebView muszą zostać przekazane do kodu natywnego, zanim będzie można je wysłać do Google Analytics.

Wdrażanie funkcji obsługi JavaScriptu

Pierwszym krokiem w używaniu Google Analytics w widoku WebView jest utworzenie funkcji JavaScriptu do przekazywania zdarzeń i właściwości użytkownika do kodu natywnego. Poniższy przykład pokazuje, jak to zrobić w sposób zgodny z natywnym kodem Androida i 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

Wywoływanie procedury obsługi JavaScriptu z komponentu WebView

Możesz prawidłowo rejestrować zdarzenia i konfigurować właściwości użytkowników w ramach widoku WebView, wywołując funkcje JavaScript zdefiniowane w poprzednim kroku. Poniższy przykład pokazuje, jak prawidłowo rejestrować zdarzenie zakupu i ustawiać właściwość użytkownika: 
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")    
}

Implementowanie interfejsu natywnego

Możesz wdrożyć interfejs natywny na iOS lub Androida.

iOS

Aby wywołać natywny kod Apple z JavaScriptu, utwórz klasę obsługi wiadomości zgodną z protokołem WKScriptMessageHandler. Możesz nawiązywać połączeniaGoogle Analytics w ramachuserContentController:didReceiveScriptMessage: połączenia zwrotnego:

Swift

Uwaga: ta usługa Firebase nie jest dostępna na platformie 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)
  }
}
ViewController.swift

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"]];
  }
}
ViewController.m

Na koniec dodaj moduł obsługi wiadomości do kontrolera treści użytkownika w widoku internetowym:

Swift

Uwaga: ta usługa Firebase nie jest dostępna na platformie macOS. 
self.webView.configuration.userContentController.add(self, name: "firebase")
ViewController.swift

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna na platformie macOS. 
[self.webView.configuration.userContentController addScriptMessageHandler:self
                                                                     name:@"firebase"];
ViewController.m

Android

Aby wywołać natywny kod Androida z kodu JavaScript, zaimplementuj klasę z metodami oznaczonymi symbolem @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

Po utworzeniu interfejsu natywnego zarejestruj go w komponencie WebView, aby był widoczny dla kodu JavaScript działającego w tym komponencie:

// 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

Ręczne rejestrowanie zdarzeń zakupu w aplikacji w komponencie WebView w systemie iOS

Zdarzenia związane z zakupami w aplikacji możesz rejestrować ręcznie w widoku WebView za pomocą pakietu SDK Analytics w wersji 12.5.0 lub nowszej.

function logManualPurchaseEvent() {
  // For manually tracking in-app purchases within a WebView, log the in-app purchase event:
  logEvent("in_app_purchase", {
    currency: "USD",
    price: 0.99,
    product_id: "prod_123",
    product_name: "Product 123",
    quantity: 1,
    value: 0.99,
  });
}

Pamiętaj, że pakiet SDK będzie nadal automatycznie rejestrować zakupy w aplikacji, gdy będzie to możliwe, i nie będzie usuwać duplikatów ręcznie rejestrowanych zdarzeń in_app_purchase.

Następne kroki

Aby zobaczyć w pełni funkcjonalną implementację Google Analytics w widoku WebView, zapoznaj się z przykładowym kodem analytics-webview.