Android SDKでフロースクリーンのビューを追跡する
ユーザーがフロー内のスクリーンを開くたびに、SDKはflow_screen_showedイベントをアプリに報告します。このイベントをAmplitude、Mixpanel、またはご利用中のプロダクトアナリティクスに転送することで、フロースクリーンをアプリの他のイベントと合わせて分析できます。
各スクリーンに到達したユーザー数や離脱箇所を確認するのにコードは不要です。フローファネルでAdapty ダッシュボード上から確認できます。このガイドは、同じファネルを自社の分析ツールで構築したい場合や、フロースクリーンとAdaptyが把握していないイベントを紐付けたい場合にご活用ください。
始める前に
以下が必要です:
- Adapty Android SDK v4以降:フローの分析コールバックは、それ以前のバージョンには存在しません。
- この機能がリリースされた後に公開されたフローバージョン:Adaptypはフローを公開するときにスクリーンイベントを生成するため、それ以前に公開したフローからはイベントが報告されません。イベントがアプリに届かない場合は、フローの新しいバージョンを公開して再度お試しください。
受け取る内容
フローはユーザーがいずれかの画面を開くたびに flow_screen_showed を報告します。Adapty はこれらのイベントを独自のフロー分析でカウントし、アプリにも配信するため、同じファネルを自社の分析ツールで構築できます。
| パラメーター | 説明 |
|---|---|
instanceId | ユーザーが開いた画面の ID。 |
screen_order | フロー内での画面の位置。 |
is_last_screen | 画面にそれ以上の遷移先がない場合に true となります。分岐のあるフローは複数の異なる画面で終了することがあり、それぞれが true を報告します。ペイウォール画面では、いずれかのアウトカムアクションが別の画面へ遷移する場合(購入または復元の結果によらず)、false を報告します。Navigate back アクションはカウントされません。また、ペイウォールよりも前にすべてのユーザーが当該画面を通過する場合、その画面への遷移もカウントされません。 |
このイベントでは isBackendEvent と isCustomerEvent のどちらも true となります。Adapty はカウントを続けつつ、アプリにもイベントを配信します。
デフォルトでは、これらのIDは自動生成されます。そのため、アプリが受け取るのは welcome ではなく scr_oAPBHPa7 のような値になります。アナリティクスでIDを読み取る必要がある場合は、独自のIDを設定してください。フロービルダーで入力欄や選択可能なグループに名前を付け、flow-generatorスキルでスクリーンの名前を変更します。詳しくはアナリティクスが認識するIDに名前を付けるを参照してください。
スクリーンビューは、他のすべてのフローイベントと同じ analytics コールバックに到達します。登録方法については、フロー&ペイウォールイベントの処理を参照してください。
すべての画面表示をアナリティクスに転送する
コールバックはフローから他のイベントも受け取るため、他の情報を読み取る前にまずイベント名で絞り込んでください。
override fun onAnalyticEvent(
name: String,
params: Map<String, Any?>,
context: Context,
) {
if (name != "flow_screen_showed") return
val screenId = params["instanceId"]
val screenOrder = params["screen_order"]
// Send screenId and screenOrder to your analytics provider here.
}
ユーザーがフローの最後に到達したときにコードを実行する
is_last_screen は、フローがそれ以上進めない画面で true になります。これを使って、コンテンツのアンロック、オンボーディング完了のマーク付け、または独自の完了イベントの送信を、ビルダーでボタンアクションを追加せずに行うことができます。
override fun onAnalyticEvent(
name: String,
params: Map<String, Any?>,
context: Context,
) {
if (name != "flow_screen_showed") return
if (params["is_last_screen"] != true) return
// The user reached the end of the flow.
}
フローの最後の画面に到達することは、フローが閉じられることとは異なります。ユーザーは最終画面を表示したまま、何もアクションを取らずにフローを閉じることができます。また、分岐のあるフローでは複数の異なる画面で終了することがあります。フロー自体が閉じられたことを知るには、代わりに onFlowClosed を使用してください。