Jetpack ComposeのローコードプラグインはAndroid SDK 3.7.0から利用可能です。以下の機能をサポートしています。
- Pendoビジュアルデザインスタジオにおけるセルフサービスタグ付け
- ページのタグ付け
- 機能のタグ付け
- 遡及的アナリティクス
- ページビューイベント
- フィーチャークリックイベント
- ガイド(Guides)
- ページビューによってアクティブになるライトボックスガイド
- フィーチャークリックでアクティブになるライトボックスガイド
- ツールチップガイド
インストール手順については、Githubをご覧ください。
Jetpack Composeのローコードソリューションの使用を開始する
現在Jetpack Composeトラックイベントソリューションを使用している場合は、Githubのインストールガイドをご覧ください。既存のすべてのトラックイベントは通常通り機能し続けます。ローコードソリューションはトラックイベントを置き換えるものではありません。それらの上にさらに情報を追加するだけです。
対応ナビゲーションライブラリ
Android SDK 3.12以降、Pendo SDKはJetpack Composeアプリのナビゲーション状態を自動的に検出します。SDKは以下をサポートしています。
-
Navigation 2 (
androidx.navigation:navigation-compose) -
Navigation 3 (
androidx.navigation3) - ナビゲーション2とナビゲーション3の両方を使用するハイブリッドセットアップ
SDKはComposeのセマンティクスツリーからナビゲーション状態を取得するため、ナビゲーションコントローラをPendoに渡す必要はありません。インストール後、画面追跡機能は自動的に動作します。
注:SDKバージョン3.7.0~3.11では、Composeナビゲーション(ナビゲーション2)を使用するには、セットアップ中にsetComposeNavigationController()を呼び出す必要がありました。SDK 3.12以降では、これは不要になりました。今後は、ナビゲーション検出が完全に自動で行われるため、APIへの呼び出しは無視されます。
Jetpack Composeでページとフィーチャーをタグ付けする
Jetpack Composeでページおよびフィーチャーにタグを付ける方法はいくつかあります。
特定のフィーチャーにタグ付けできない場合は、モーダルコンポーネントの現在の制限事項およびダイナミックコンポーネントの現在の制限事項を参照し、タグ付けする要素がクリック可能であることを確認してください。また、要素にpendoTag修飾子を追加して、Pendoがそれを認識できるようにすることも試してみてください。
それでもページやフィーチャーにタグ付けできない場合は、Pendoサポートにお問い合わせください。
モーダルコンポーネントの現在の制限事項
ModalBottomSheets、パネル、ポップアップなどの追加ウィンドウでは、フィーチャーの特定とクリックアナリティクスはサポートされていません。これらのコンポーネントにpendoTagを追加しても問題は解決しません。
ツールチップガイドもこれらのコンポーネントではサポートされていません。
ポップアップは新しい画面として検出されないため、その中の要素にタグを付けることができません。
DrawerまたはModalBottomSheetLayoutの場合は、インストールガイドのステップ3.1に従ってModifier.pendoStateModifier(componentState)を正しく設定してください。Pendoにページを検出させたくない場合は、bottomSheetStateまたはdrawerStateを更新する必要があります。
BottomSheetScaffoldとModalBottomSheetLayoutは、ローコードタグ付けに完全に対応しています。これはModalBottomSheetには適用されませんが、既知の制限があります。