アプリが管理するWebView内に表示した接客やWebView連携で問題が発生する場合は、以下の手順で確認を行ってください。

WebView連携自体の問題

WebView連携で問題が発生する場合は、以下の手順で確認を行ってください。

  1. WebView内の行動が計測ができていない 詳細
  2. Safariアプリでアクセスした際の _sourcenative_app_webview になる 詳細

WebView内の接客の問題

  1. 接客に指定したURLスキームで同WebView内の別Webページに遷移できない 詳細
  2. WebView上で「ネイティブアプリにおける接客表示制限」が動作しない 詳細
  3. iOSアプリ内のWKWebView上で接客を表示した際に、接客内の特定のリンクが動作しない 詳細

WebView内の行動が計測ができていない

計測自体確認できない場合は以下の順に問題がないかチェックしてください。

計測を確認している環境や設置されているタグは正しいか

  1. 計測を確認している環境やタグが正しいか
    URLやページが本番環境/検証環境などで同一の場合、Webページ内のタグ初期化時に使用しているapi_keyの環境にイベントが送信されるため、それぞれの環境ではイベントが確認できないことがあります。
    設置しているタグのapi_keyと確認対象の環境が正しいかどうか改めてご確認ください。

※計測タグのwebview_onlyオプションが有効な場合、「WebとAppのユーザーの紐付け処理」の実装がされていないとviewイベントは発生しません。

  1. マルチドメインオプションを使っていないか
    WebView連携(WebとAppのユーザー紐付け処理)はマルチドメインオプションによるクロスドメインでのユーザ統合機能の対象外となります。

連携用のクエリパラメータで連携している場合

  1. 連携用のクエリパラメータが正しく付与され有効期限が切れていない
    連携パラメータの有効期限は1分間です、有効期限が切れている場合は紐付けが行われません。
    そのためページをロードする際は、URLに都度クエリパラメータを付与するようにしてください。
    有効期限が切れていないかどうかはDevToolsなどでJS SDKのログ(window._karte_logs)をご確認ください。

ユーザースクリプトを利用して連携している場合

  1. App-Bound Domainsを使用している(iOSのみ)
    App-Bound Domainsを使用している場合、そのままではユーザースクリプトの追加が出来ません。
    WKWebViewConfigurationのドキュメントを参考に limitsNavigationsToAppBoundDomainstrue に設定したWKWebConfigurationでアプリで管理するWebViewを初期化してください。

問題が解決しない場合

問題が解決しない場合、詳しく調査をさせていただくため、以下ページで調査用の情報をご用意の上チャットサポートまでお問い合わせください。

Safari/Chromeアプリでアクセスした際の _sourcenative_app_webview になる

本来Safari(iOS)やChrome(Android)からのサイトアクセスでは _sourceweb となりますが、WebView連携中のアプリ内における以下操作により native_app_webview で計測されることがあります。

  • iOS
    • 連携パラメータつきのリンクをアプリから「Safariで開く」などで開く
    • iOS11未満:SFSafariViewController で連携パラメータが保存された cookie を Safari と共有する
  • Android
    • 連携パラメータつきのリンクをアプリから「Chromeで開く」などで開く
    • CustomChromeTabs で連携パラメータが保存された cookie を Chrome と共有する

これらが原因で _source_native_app_webview として計測されている場合は次の対応のいずれかを行ってください。

  • アプリで連携パラメータつきのリンクを外部ブラウザなどで開いたり、外部に共有する実装があれば修正する
  • クエリパラメータでの連携ではなくユーザースクリプトによる連携を利用する

ユーザースクリプトによる連携の詳細については WebView内の行動をトラッキングする - ユーザースクリプトを利用した紐付けの実装方法を参照ください

接客に指定したURLスキームで同WebView内の別Webページに遷移できない

WebView上でポップアップ等の接客サービスを出し別リンクを開かせるときに、WebView内で遷移させたい(ブラウザアプリ等で開かれないようにしたい)というケースがあります。

これを実現するためには、接客設定画面のリンク設定でカスタムURLスキームを設定するだけでは正しく遷移しません。別途プラットフォーム毎にWebView内リンクをタップした際の実装が必要となります。

WebView上に表示した接客で「ネイティブアプリにおける接客表示制限」が動作しない

「ネイティブアプリにおける接客表示制限」はWebView内で発生したviewイベントでは動作しません。
詳細はネイティブアプリにおける接客表示制御とはを参考ください。

iOSアプリ内のWKWebView上で接客を表示した際に、接客内の特定のリンクが動作しない

非推奨となったUIWebViewと異なり、WKWebViewでは以下のような一部のaタグリンクがデフォルトでは処理しない挙動となっております。

  • URLスキーム(自アプリへのdeeplink処理を含む)
  • _blankを含むaタグ
  • etc.

このケースに該当する場合、WKWebViewのnavigationDelegateの実装が必要となります。