モニタリング
セッションリプレイ
ブラウザ SDK は、ユーザーが見たとおりのページを記録し、エラーや不具合報告の直前の1分間をアップロードできます。記録するタイミングはダッシュボードの各プロジェクトのセッションリプレイ設定で決まるため、コードを変えずに Odoo でも使えます。レコーダーは 61 KB の別アドオンで、リプレイがオンのときだけ blipit.io から読み込まれるので、本体のスクリプトは小さいままです。
1記録するタイミングを選ぶ
app.blipit.io でプロジェクトを開き、セッションリプレイ設定を選びます。すべてのプロジェクトの初期設定である「エラーと不具合報告のとき」は、直前の60〜120秒をブラウザのメモリに保持し、エラーが記録されたときか不具合報告が送られたときだけアップロードして、その後も記録を続けます。問題のない訪問はアップロードされません。「すべての訪問(サンプル)」は、選んだ割合(1〜100%)の訪問を問題の有無にかかわらず最初から記録し、残りの訪問ではエラー用のバッファを保持します。「オフ」は何も読み込みません。オーナー、管理者、プロジェクトを編集できる人が変更でき、変更は約1時間以内にブラウザへ反映されます。
2表示されるものとマスクされるもの
マスクは送信前にブラウザ内で行われます。入力された値、ページのテキスト、表のセル、レコード名はアスタリスクになり、フォームの項目は 顧客: ****** のように表示されます。訪問者の操作を追えるよう、ラベルとボタンは読めるまま残ります: フォームのラベル、凡例、表や一覧の列見出し、表題、ボタン、タブ、メニュー項目、ナビゲーションのリンク、そして Odoo では項目ラベル、ステータスバー、ノートブックのタブ、アプリメニュー、コントロールパネルのボタンです。それらの中でも数字、日付、メールアドレス、リンク、@ハンドルはマスクされ、ボタンは Pay $**.** のように表示されます。title、alt、aria-label、placeholder 属性もマスクされます。項目の値、表のセル、かんばんカード、活動、チャット内のものはボタンとして描かれていても常にマスクされ、かんばんの列タイトルはグループ化された値の場合があるためマスクされます。ラベルやボタンの中にあっても常にマスクされるもの: 入力欄、テキストエリア、選択リストとその選択肢、編集可能な領域、表のセルと項目の値、見出し、パンくずリスト、チャッター、かんばんカード、アカウント・ユーザー・プロフィールのメニュー、検索と入力補完の一覧。画像、動画、音声、canvas、iframe、パスワード欄は同じ大きさの空の枠になり、data-blipit-block の付いた要素はブロックされ、ページ URL のトークンらしき値は伏せられます。以前のようにすべての文字をマスクするには、プロジェクトのセッションリプレイ欄で「リプレイでラベルとボタンを表示」をオフにします。要素に data-blipit-mask を付けると常にマスクされ、data-blipit-unmask を付けると選んだ要素のテキストが表示されます。data-blipit-mask が優先されます。
<div data-blipit-mask>Always masked</div>
<span data-blipit-unmask>Plan</span>3リプレイを見る
「リプレイ」はプロジェクト別、エラーの有無別、URL 別に記録を一覧表示します。プレイヤーには再生、1倍、2倍、4倍、無操作のスキップ、そしてイシューにリンクするエラーごとの赤いマーカーがあります。最新イベントにリプレイがあるイシューには「リプレイを見る」が表示されます。
4コードで上書きする
Blipit.init の replay オプションは、そのサイトではプロジェクト設定より優先されます。onErrorSampleRate(既定値 1)はエラー用バッファを保持する訪問の割合、sessionSampleRate(既定値 0)は最初から記録する訪問の割合で、labels: false を指定するとそのサイトではすべてのテキストがマスクされます。replay: false を指定すると、プロジェクト設定にかかわらずそのサイトではリプレイがオフになります。
Blipit.init({
key: "<public key>",
release: "2026.09.28",
replay: { sessionSampleRate: 0.05, onErrorSampleRate: 1 }
});5モバイルアプリ:Android
モバイルのセッションリプレイは blipit-android 0.3.0 以降を使う Android アプリで動作し、SDK が Google Play 開発者サービスや Firebase を使わないため Huawei 端末でも動きます。iOS、React Native、Flutter は近日対応予定です。プロジェクトの同じ設定が適用されます。「エラーとバグ報告のとき」は端末のメモリに直近 30 秒を保持し、エラーが起きたときか誰かがバグ報告を送ったときだけアップロードします。「すべての訪問(サンプリング)」は選んだ割合のアプリセッションを最初から最後まで録画します。リプレイには Android 8.0(API 26)以降が必要です。古い端末ではリプレイなしでエラーだけが送られます。
implementation("com.github.blipit-io:blipit-android:v0.7.5")Blipit.init(this) {
key = "<public key>"
project = "<project id>"
}6まず同意を得る
アプリが Blipit.setReplayConsent(true) を呼ぶまで何も記録されません。既定値は false です。下の説明文を表示し、ユーザーが同意したら呼び出してください。選択は端末に保存されるので、変わったときだけ再度呼べば十分です。Blipit.setReplayConsent(false) は録画をすぐに止めてバッファを破棄するので、アプリの設定画面で提供してください。Blipit.hasReplayConsent() は現在の選択を返します。
allowButton.setOnClickListener { Blipit.setReplayConsent(true) }
replaySwitch.isChecked = Blipit.hasReplayConsent()
replaySwitch.setOnCheckedChangeListener { _, on -> Blipit.setReplayConsent(on) }7モバイルリプレイが記録するもの
アプリ自身の画面をおよそ毎秒 1 フレーム、端末上で小さな H.264 動画にエンコードしたものと、タップ、画面遷移、ブレッドクラム、端末モデル、Android バージョン、アプリのバージョンです。ほかのアプリ、システム UI、通知、アプリがバックグラウンドにある間の内容は一切記録されません。アプリがバックグラウンドに移るとすぐに録画は一時停止し、30 秒後に停止します。Blipit は AccessibilityService も MediaProjection も使わないため、画面録画の許可ダイアログもフォアグラウンドサービスもありません。従量制(モバイル)回線では画質を下げ、すべて HTTPS で Blipit にだけ送信します。
8端末上でマスクされるもの
マスクはフレームを保存する前に端末上で行われます。すべてのテキスト、すべての画像、すべての入力欄(EditText と Jetpack Compose のテキスト入力)、WebView、動画プレーヤーは塗りつぶしのブロックとして描かれます。Blipit.init で replayLabels = true にすると、View ベースの画面ではラベルとボタンの文字が読めるままになります。入力欄と画像はマスクされたままで、Jetpack Compose の画面はすべてマスクされたままです。ビューに android:tag="blipit-mask" を付けると常にマスクされます。
<TextView
android:id="@+id/balance"
android:tag="blipit-mask" />9子ども向けアプリ
子ども向けアプリではリプレイをオフのままにしてください(Google Play のファミリー ポリシー、COPPA、App Store のキッズカテゴリ)。Blipit.init で childDirected = true にするか、Blipit.disableReplayForChildApp() を呼ぶと、同意があってもリプレイは決して開始されません。
Blipit.init(this) {
key = "<public key>"
project = "<project id>"
childDirected = true
}10ストア対応チェックリスト
- 記録の前に同意を得る:ユーザーが同意した後でだけ Blipit.setReplayConsent(true) を呼びます。
- 同意を求める前に、下の文面でアプリ内に目立つ説明を表示します。
- プライバシーポリシーで Blipit とセッションリプレイに触れます。下の AppGallery 用の段落はどのストアでも使えます。
- Google Play の「データ セーフティ」フォームと AppGallery のプライバシーラベルを下の回答で記入します。
- 子ども向けアプリではリプレイをオフのままにします。
- 同意の撤回に応じる:アプリの設定に Blipit.setReplayConsent(false) を呼ぶスイッチを用意します。
11Google Play「データ セーフティ」の回答
Play Console の「アプリのコンテンツ > データ セーフティ」でこの回答を使います。カテゴリと目的の名前は英語版コンソールの表示のままです。
- App activity > App interactions:収集する、共有しない、任意。目的:App functionality、Analytics。
- App info and performance > Crash logs:収集する、共有しない。目的:App functionality、Analytics。
- App info and performance > Diagnostics:収集する、共有しない。目的:App functionality、Analytics。
- アプリが収集するユーザーデータはすべて転送時に暗号化されていますか? はい。
- ユーザーがデータの削除をリクエストする方法を提供していますか? はい。
12貼り付けて使えるアプリ内の説明
同意を求める前に、専用の画面か「許可」と「今はしない」ボタンのあるダイアログで表示し、設定画面の場所はアプリに合わせて書き換えてください。
- このアプリは、エラーやバグ報告の前の最大 30 秒間、画面とタップをマスクした動画を記録し、問題を修正するためにエラー監視サービスの Blipit に送信します。テキスト、画像、入力した内容は隠されます。この機能は設定でオフにできます。
13Huawei AppGallery 用のプライバシー声明
これをプライバシー声明に貼り付け、角かっこの部分を置き換えてください。Google Play やほかのストアにも使えます。AppGallery Connect では、アプリのプライバシーラベルで、サードパーティ SDK がアプリのアクティビティ(操作)と診断データ(クラッシュログ)を収集し、共有も広告利用もしないことを申告してください。
- エラー監視とセッションリプレイ。当アプリは、Louward Labs FZC LLC(アラブ首長国連邦アジュマーン)が運営するエラー監視サービス Blipit をデータ処理者として利用しています。お客様の同意がある場合、アプリはアプリ自身の画面を短くマスクした記録(テキスト、画像、入力内容は保存前にお使いの端末上で隠されます)、タップと画面遷移、端末モデル、OS、アプリのバージョンを保持します。これはエラーが発生したとき、バグ報告を送信したとき、またはごく一部のサンプルセッションについてのみ、暗号化された接続(HTTPS)で送信され、アプリの問題の発見と修正にのみ使われます。販売や広告に使われることはありません。記録は [7/14/30] 日後に自動で削除されます。同意はいつでも [設定 > プライバシー] で撤回でき、データの開示や削除は [連絡先] から依頼できます。
14App Store のプライバシーラベル(iOS 版向け)
今後の iOS SDK 向けです。App Store Connect の App Privacy で次のように申告します:
- Usage Data > Product Interaction:App Functionality、Analytics。
- Diagnostics > Crash Data と Other Diagnostic Data:App Functionality、Analytics。
- ユーザーの身元には紐づけない。ただし Blipit.setUser を呼ぶ場合は紐づけありにします。
- トラッキングには使用しない。
知っておくと便利
- 月あたりのリプレイ: Free 25件、Solo 500件、Team 2,500件、Scale 5,000件。保持期間は Free 7日、Solo 14日、Team と Scale 30日です。その月のリプレイを使い切ると、翌月までプロジェクト設定はオフとして応答し、料金は発生しません。
- 記録は60分、500セグメント、または 20 MB で停止します。チャンクは10秒ごとまたは 1 MB ごとに gzip で送信され、最後のチャンクはタブを閉じたときに送信されます。
- Web サイトでは Blipit のブラウザスクリプトがリプレイを記録し、Android アプリでは Blipit Android SDK がリプレイを送信します。
- モバイルのリプレイは Web のリプレイと同じ月間枠と保存期間を共有し、動画ファイルはリプレイと一緒に削除されます。
お困りですか?support@blipit.io までメールしてください。各プロジェクトのキーとプロジェクト ID は app.blipit.io の「APIキー」にあります。