JavaScriptインターフェイスを使用して、アプリ内Webviewからイベントをトラッキングする方法について説明します。
ネイティブアプリでは、Webコンテンツを表示し、Webviewと呼ばれる埋め込みブラウザーに機能を委任できます。Tealium iOSまたはAndroid SDKでWebviewからイベントをトラッキングするには、ネイティブコードとの通信ブリッジが必要です。これは、JavaScriptを使用してアプリにメッセージを送信し、ネイティブコードを呼び出すことで実現します。
このソリューションは、Tealium Universal Tag(utag.js)がインストールされているかどうかにかかわらず、Webviewで動作します。
仕組み
このソリューションでは、次のコンポーネントを使用します。
- Webview JavaScriptハンドラー
このJavaScriptコードは、Webベースのイベントトラッキングをラップし、イベントをネイティブアプリに送信します。- タグ管理を使用する場合 - 拡張機能を使用して、このコードをページにすばやく追加します。
- Tealiumを使用しない場合 - 既存のイベントトラッキングを使用するか、ページにトラッキングを追加します。
- ネイティブメッセージハンドラー
このネイティブコードは、JavaScriptインターフェイスを使用してイベントデータを含むメッセージを受信します。
Webview JavaScriptハンドラー
次のJavaScriptコードには、Webベースのトラッキング呼び出しをネイティブコードに転送するために、ビューのトラッキング用とイベントのトラッキング用の2つのラッパー関数が用意されています。このコードはiOSとAndroidの両方で動作します。
function tealView(tealiumEvent, data) {
if (!tealiumEvent) {
return;
}
if (window.WebViewInterface) {
window.WebViewInterface.trackView(tealiumEvent, JSON.stringify(data));
} else if (window.webkit
&& window.webkit.messageHandlers
&& window.webkit.messageHandlers.tealium) {
var message = {
command: 'trackView',
title: tealiumEvent,
data: data
};
window.webkit.messageHandlers.tealium.postMessage(message);
}
}
function tealEvent(tealiumEvent, data) {
if (!tealiumEvent) {
return;
}
if (window.WebViewInterface) {
window.WebViewInterface.trackEvent(tealiumEvent, JSON.stringify(data));
} else if (window.webkit
&& window.webkit.messageHandlers
&& window.webkit.messageHandlers.tealium) {
var message = {
command: 'track',
title: tealiumEvent,
data: data
};
window.webkit.messageHandlers.tealium.postMessage(message);
}
}
Tealiumを使用するWebview
Webviewに読み込まれるページにTealium Universal Tag(utag.js)がすでに含まれている場合は、2つのJavaScriptコード拡張機能を使用してJavaScriptハンドラーコードを追加します。一方はラッパー関数を初期化するため、もう一方は既存のトラッキング呼び出しをJavaScriptインターフェイスに転送するために使用します。
このシナリオでは、Webviewページとネイティブアプリで異なるタグ管理プロファイルを使用する必要があります。
JavaScriptハンドラーコードを、Pre LoaderをスコープとするJavaScriptコード拡張機能に追加します。
次のコードを、All Tags - After Tagsをスコープとする2つ目のJavaScriptコード拡張機能に追加します。これにより、Webview内ですでに発生している既存のTealiumトラッキング呼び出しが、ネイティブホストアプリに転送されます。
if (a == "view") { tealView(b.tealium_event, b); } else if (a == "link") { tealEvent(b.tealium_event, b); }
Tealiumを使用しないWebview
Webviewに読み込まれるページにTealiumが含まれていない場合は、Webview内に読み込まれる各ページにJavaScriptハンドラーコードを追加します。その後、ページビューをトラッキングするにはtealViewを呼び出し、ボタンのクリックやカートイベントなど、ページビュー以外のイベントが発生した場合はtealLinkを呼び出します。
ネイティブメッセージハンドラー
JavaScriptからAndroidのネイティブコードを呼び出すには、@JavaScriptInterfaceでマークされたメソッドを持つクラスを実装します。
public class WebViewInterface {
@JavascriptInterface
public void trackView(String viewName, String data) throws JSONException {
tealium.track(viewName, new JSONObject(data));
}
@JavascriptInterface
public void trackEvent(String eventName, String data) throws JSONException {
tealium.track(eventName, new JSONObject(data));
}
}
ネイティブインターフェイスを作成したら、それをWebViewに登録し、WebView内で実行されるJavaScriptコードから参照できるようにします。
mWebView.addJavascriptInterface(mInterface, "WebViewInterface");
addJavascriptInterface()メソッドは、webView.loadUrl()メソッドを呼び出す前に呼び出してください。また、セキュリティ上の理由から、JavaScriptInterfaceはAPIバージョンJELLY_BEAN_MR1以降でのみ追加してください。
WebViewのユーザーコンテンツコントローラーに、次のメッセージハンドラーを追加します。
webView.configuration.userContentController.add(self, name: "tealium")
JavaScriptからiOSのネイティブコードを呼び出すには、WKScriptMessageHandlerプロトコルに準拠するメッセージハンドラークラスを作成します。トラッキングするには、userContentController:didReceive:コールバック内でTealium.trackを呼び出します。
func userContentController(_ userContentController: WKUserContentController,
didReceive message: WKScriptMessage) {
guard let body = message.body as? [String: Any],
let command = body["command"] as? String,
let title = body["title"] as? String,
let webViewData = body["data"] as? [String: Any] else {
return
}
switch command {
case "track":
TealiumHelper.shared.tealium?.track(title: title,
data: webViewData,
completion: nil)
case "trackView":
TealiumHelper.shared.tealium?.trackView(title: title,
data: webViewData,
completion: nil)
default:
break
}
}
サポートされているライブラリ
次のプラットフォームでは、JavaScriptインターフェイスソリューションがサポートされています。
最終更新日 :: 2026年November月18日