WebViewのトラッキングを行う

🚧

このドキュメントは古いバージョンのReact Native SDKについて記載しています

Native SDK v1に依存する旧React Native SDKは 2021/05/11でサポート終了となります。

WebView とアプリのユーザー行動を紐付けて計測する

アプリ内 WebView で表示される自社サイトに KARTE の計測タグ (tracker.js) が設置されている場合は、WebView 内でのユーザー行動とアプリ内のユーザー行動を紐付けて計測することが可能です。
紐付けを行うためには、WebView で開くページの URL に特定のクエリを付加する必要があります。

紐付けによって出来ること

• 紐付け前後の WebView 内のユーザーの行動が、アプリ内の行動と紐づく (紐付け後の WebView 内・アプリ内の行動は、同セッションとして扱われます)
• tracker.js が発行する全イベントの _source フィールドに native_app_webview が付く
• tracker.js が自動発行する req イベントに app_info のフィールドが付く

実装方法

SDK が用意しているヘルパーメソッドに URL を渡すことで、必要なクエリが付加された URL を得ることができます。

なお、この情報は Cookie に保持されるため、一度クエリが付加されたページを読み込めば、以降読み込み時にクエリを付ける必要はありません。

import { KarteTrackerJsUtil } from 'react-native-karte-tracker'

let url = await KarteTrackerJsUtil.appendUserSyncQueryParameter("YOUR_WEB_PAGE_URL")
// 戻り値のURLを使ってWebViewを開く

🚧

クエリパラメータの有効期限について

クエリパラメータには1分の有効期限を設けており、有効期限が切れている場合は紐付けが行われません。
そのため WebView を開く際は、都度URLにクエリパラメータを付与するようにしてください。