クオリティスタート
AI前提の開発AI開発FlutterWebViewNext.jsBraze

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

公開日 読了目安 5分執筆 湯本 堅隆(株式会社クオリティスタート)

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発のイベントだけを区別することはできません。

記事の内容について、相談してみませんか。

記事で紹介した進め方を、貴社のプロジェクトでどう使えるか、PMとエンジニアがお話しします。