FlutterアプリにWebViewを組み込むとき、ログイン状態・画面遷移・トラッキングをどうつないだのか

Flutterのアプリに、Webの画面をWebViewで組み込もうとしている開発者の方に向けた記事です。ログイン状態はCookieManagerでWebViewに渡し、画面遷移はWebViewの中ではソフトナビゲーション、ネイティブの画面との境目ではハードナビゲーションに分け、トラッキングはBrazeのWebBridgeでアプリのSDKに中継しました。この記事では全国1,000店舗強で使われるモバイルオーダーのアプリを作り直したときに、WebViewまわりで決めたことを説明します。
案件の全体像は「大規模なNext.js / FlutterアプリをClaude Codeでフルスクラッチ、どんな方針で取り組んだのか」にまとめています。
なぜ、アプリにWebViewを組み込んだのか
この案件ではWebフロント(Next.js)とモバイルアプリ(Flutter)の両方を作り直しました。どの機能をどちらでどう実現するかを決めたうえで、一部の画面はアプリからWebViewでWebの画面を開く形にしています。
WebViewを使うと、アプリとWebの間で、ログイン状態・画面遷移・トラッキングをつなぐ必要が出てきます。以下はその3つをどうつないだかです。
ログイン状態は、どうWebViewに渡したのか
FlutterのWebViewライブラリ(flutter_inappwebview)が持つCookieManagerで、セッションのCookieをWebViewに設定しました。
アプリでログインしていても、WebViewは別のブラウザのようなものなので、そのままではログイン状態を知りません。Webの画面を読み込む前に、アプリ側からWebViewにCookieを入れておきます。こうすると、WebViewで開いたWebの画面は、ログイン済みとして表示されます。
// 見本のコード(実際の案件のコードではありません)
final cookieManager = CookieManager.instance();
await cookieManager.setCookie(
url: WebUri('https://example.com'),
name: 'session',
value: sessionToken,
isSecure: true,
isHttpOnly: true,
);
Webの画面からアプリに何かを頼むとき(ネイティブの画面を開く、など)は、JavaScriptのブリッジを使います。Web側からメッセージを送り、アプリ側で受け取って処理します。
画面遷移は、ソフトとハードをどう使い分けたのか
WebViewの中の画面どうしの移動はソフトナビゲーション、ネイティブの画面との境目はハードナビゲーションにしました。
| 遷移 | 方式 | ねらい |
|---|---|---|
| WebViewの中の画面どうし | ソフトナビゲーション(ページを読み直さない) | 速く切り替える |
| ネイティブの画面との行き来 | ハードナビゲーション(ページを読み直す) | 状態を確実に読み直す |
| ログイン状態が変わるとき | ハードナビゲーション | セッションを確実に反映する |
ソフトナビゲーションはNext.jsのページ遷移のように、ページ全体を読み直さずに画面だけを切り替えます。速い代わりに、ブラウザから見ると「ページの読み込み」が起きません。境目では読み直すことで、ログイン状態や画面の状態が食い違うのを防いでいます。
WebViewの中の画面遷移を、アプリはどう知るのか
履歴が変わったときのイベント(onUpdateVisitedHistory)で、URLの変化を受け取りました。
ソフトナビゲーションではページの読み込みが起きないので、読み込み完了のイベントでは画面が変わったことに気づけません。ブラウザの履歴は変わるので、そのイベントを受け取れば、どの画面に移ったかをアプリ側で知ることができます。
// 見本のコード(実際の案件のコードではありません)
InAppWebView(
initialUrlRequest: URLRequest(url: WebUri('https://example.com')),
onUpdateVisitedHistory: (controller, url, isReload) {
// URLを見て、アプリ側の表示(タブやボタンなど)を切り替える
},
);
トラッキングのコードは、どういう設計にしたか
BrazeのWebBridgeで、WebViewの中のイベントを、アプリのBraze SDKの呼び出しに変換して中継しました。
WebViewの中の行動もアプリの利用者の行動として、同じ人に記録できます。ただし、制約が1つあります。WebView発のイベントもiOS・Androidのアプリとして記録されるため、Brazeで「対象アプリ(iOS・Android・Web)」を区別しても、WebView発のイベントだけを取り出すことはできません。
トラッキングの設計(GA4、GTM、Firebase Analytics、Braze、AppsFlyer)とディープリンクの設計も、当社が担当しています。
まとめ
- ログイン状態はflutter_inappwebviewのCookieManagerでWebViewにCookieを設定して渡した
- WebViewの中はソフトナビゲーション、ネイティブ画面との境目とログイン状態が変わるときはハードナビゲーションにした
- ソフトナビゲーションの画面遷移はonUpdateVisitedHistoryでアプリ側に伝えた
- トラッキングはBrazeのWebBridgeでアプリのSDKに中継した。WebView発のイベントだけを対象アプリで区別することはできない
開発チームにAI前提の進め方を入れる手順は、「開発チームにAIを入れる手順」にまとめています。
よくある質問
アプリのログイン状態を、WebViewの画面に引き継げますか?
引き継げます。この案件では、FlutterのWebViewライブラリ(flutter_inappwebview)のCookieManagerで、アプリが持つセッションのCookieをWebViewに設定しました。
WebViewの中で画面が変わったことを、アプリ側で知る方法はありますか?
あります。ソフトナビゲーションではページの読み込みが起きないので、読み込み完了のイベントでは気づけません。履歴が変わったときのイベント(onUpdateVisitedHistory)で、URLの変化を受け取ります。
WebViewの中の行動も、Brazeでトラッキングできますか?
できます。WebBridgeで、WebViewのイベントをアプリのSDKの呼び出しに変換して送ります。ただし、イベントはiOS・Androidのアプリとして記録されるので、Braze上でWebView発のイベントだけを区別することはできません。