この記事では、モバイルアプリケーションでのフィーチャーのタグ付けの詳細設定について説明します。アナリティクスの正確性の確保に役立てることができます。詳細設定には、フィーチャールールを調整し、収集されたデータの正確性を向上させる修飾子と属性が含まれます。
モバイルでのフィーチャーのタグ付けの詳細設定に関する動画は、Pendo Academyをご覧ください。
修飾子と属性の違い
修飾子と属性は共にフィーチャールールの調整に使用され、データの精度を向上させます。次の表では、これらの設定の違いと、使用に適しているケースについてまとめています。
設定タイプ | 機能 | 使用に適しているケース | サンプルシナリオ |
属性 | テキストラベル、位置、IDなど、フィーチャー固有の特性を定義します。これらの特性によって、Pendoが各機能を識別する方法が決定します。 |
デフォルトのルールでは、フィーチャーを正確に識別することができないケース。 フィーチャーに固有の、静的な、またはローカリゼーションに対して安全な特性があり、確実にタグ付けできるケース。 |
テキスト(「Sign In」)または不変のID(「login_button」)で一意に識別されるボタン。 |
修飾子 | フィーチャーを識別するために使用するルールを直接変更せずに、データ収集の動作を調整します。修飾子を使うことでデータ収集がより柔軟になります。 |
フィーチャールールは正しいが、データ収集に柔軟性が必要なケース。 フィーチャーが複数の場所に存在したり、より動的に存在したりするケース。 |
すべてのアプリ画面に表示される動的リスト、またはナビゲーションメニュー内で位置を変更するボタン。 |
詳細設定の使用に適しているケース
デフォルトのフィーチャールールは述語(Predicate)と呼ばれ、その値はアプリ内のフィーチャーの位置属性と階層から取得されます。これらのデフォルト属性が正確でないか、フィーチャーを正確に識別するのに十分でない場合、またはフィーチャーデータの収集でさらに柔軟性が必要な場合は、詳細設定を使用して選択を改善してください。
フィーチャーにタグ付けするときに詳細設定が必要になるケースには、以下のようなものがあります。
- 複数のフィーチャーの強調表示:ナビゲーションバー全体や複数の要素が強調表示されるなど、タグ付けツールの精度に問題がある場合があります。
- フィーチャーの想定外のトラフィック:トラフィックが多すぎたり少なすぎたりすると、選択が不正確になる場合があります。
- アナリティクスの中断:アナリティクスが突然停止した場合は、タグを更新する必要があります。
- アプリのローカライズやボタンの移動:アプリのローカライズや、ボタンが画面上で動的に移動するのはよくあることです。
詳細設定にアクセスする
フィーチャーの詳細設定は、ビジュアルデザインスタジオ内のフィーチャーの詳細にあります。次の手順に従って移動します。
- [プロダクト(Product)]>[ページ(Pages)]に移動し、フィーチャーがあるページを選択します。
- ページの右上にある[ページを管理(Manage Page)]を選択して、デザイナーを開きます。
-
[タグ付きフィーチャー(Tagged Features)]テーブルで、該当するフィーチャー行にカーソルを合わせ、編集アイコンを選択します。
-
詳細設定を開きます。
修飾子を適用する
現在のフィーチャールールで正確に要素が識別されている場合でも、より柔軟で包括的なデータ収集が必要な場合は、修飾子を使用します。
修飾子は、フィーチャールール自体に直接影響を与えることなく、フィーチャーデータの整理、収集、表示の方法を調整します。 これらの設定は、アナリティクスやレポート作成のためにデータの取り扱いをカスタマイズします。 次の3つのオプションを使用できます。
- アプリ全体(App-wide)
- リスト内のインデックスを無視する
- バンドル名を無視する
アプリ全体(App-wide)
この修飾子は、ナビゲーションメニューやタブバーボタンなど、モバイルアプリ全体に表示されるフィーチャーに使用されます。「アプリ全体」を使用すると、ページがアプリ内でタグ付けされているかどうかに関係なく、Pendoはこれらのフィーチャーのクリックイベントを収集できます。
ベストプラクティスとして、ホーム画面からアプリ全体のフィーチャーにタグを付けるか、自分や他の人が簡単に見つけられるように命名規則を使用します。例:Info (tagged on Home)。
一般的なユースケースには、以下のようなものがあります。
- ナビゲーションメニューまたはタブバー:あるフィーチャーがアプリのどこに移動しても存在する場合。
- 共通のフィーチャーインタラクション:ユーザーがどのページにいるかに関係なく、ユーザーのインタラクションを追跡したい場合。
リスト内のインデックスを無視する
この修飾子はリスト内のフィーチャーの場所(インデックス)を無視し、フィーチャーの位置が変わってもユーザーのインタラクションを確実に追跡できるようにします。
有効にした場合、ユースケースに基づいて次のオプションのいずれかを選択します。
- リスト内の場所に関わらず、リスト内の特定のフィーチャーのクリック数を追跡する。特定のリスト項目やボタンの位置が動的に変化しても、その項目やボタンのアナリティクスを取得したい場合に使用します。
- どのフィーチャーがクリックされるかに関わらず、リスト内のクリックをすべて追跡する。リストの特定の項目ではなく、任意の部分に対する一般的なインタラクションに関心がある場合に使用します。
一般的なユースケースには、以下のようなものがあります。
- 動的リスト:頻繁に位置が変更、更新されるコンテンツまたはデータテーブルで、一貫したデータ収集ができます。
- 権限ベースのリストビュー:ユーザーの権限に応じて項目が表示または非表示になるリストやテーブルで、インタラクションには一貫性のあるトラッキングが必要です。
- インタラクションの一覧表示:個々の静的な機能にのみ焦点を当てるのではなく、動的なリスト内での全体的なエンゲージメントを理解する、または一覧項目を選択した後のガイドのアクティベーションを目的とします。
バンドル名を無視する(iOSのみ)
この設定を有効にすると、バンドル名は無視されます。バンドル名はiOSアプリケーション固有のもので、Apple App Storeでアプリケーションの識別子として使用されます。
一般的なユースケースには、以下のようなものがあります。
- ホワイトラベルアプリ:バンドル名を無視すると、アナリティクスとレポートでアプリのすべてのバージョンが1つのエンティティとして扱われるようになります。
- 開発環境:バンドル名を無視することで、同じアプリのすべてのバリエーション(本番、開発、テストなど)のデータをまとめることができます。
修飾子の詳細
ルール名 | 説明 | カテゴリー | iOSまたはAndroid | 位置的に動的な要素への対応 |
ローカリゼーションへの対応 |
アプリ全体(App-wide) |
すべてのページからこのフィーチャーのクリック数を収集し、他のページでタグ付けする必要がないようにします。 |
修飾子 |
両方 |
可 |
可 |
リスト内のインデックスを無視する | リスト内のこのフィーチャーの位置を無視します。 | 修飾子 | 両方 | 可 | 可 |
バンドル名を無視する | バンドル名を無視します。バンドル名はiOSアプリケーション固有のもので、AppleのApp Storeでアプリの識別子として使用されます。 | 修飾子 | iOS | 可 | 可 |
属性を使用する
属性は、Pendoがモバイルフィーチャーを識別するために使用する特定の特性を定義します。場合によっては、自動的に選択された属性ではフィーチャーを正確に識別できないことがあります。フィーチャー固有の特性を明示的に選択してフィーチャールールを調整する必要がある場合は、属性を使用します。
属性には3つのカテゴリがあります。
- 位置(Positional):フィーチャーがアプリケーション内のどこに配置されているか、または空間配置を説明する属性。
- テキストベース(Text-based):ラベルや説明などのテキスト情報で識別される属性。
- 一般(General):特定の言語の翻訳や空間配置に紐づけられていない属性。
位置(Positional)属性
位置属性は、モバイルアプリケーション内での空間配置に基づいてフィーチャーを識別します。
ヒント:位置属性は、要素が静的な場合、つまりユーザー権限、ユーザーセッション、その他の条件を問わず位置が一貫している場合にのみ使用してください。
テキストベース(Text-based)属性
これらの属性は、ラベルや説明など、表示されるテキストに関する情報を提供します。
ヒント:動的またはローカライズされたテキストの場合、アプリが複数言語で開発される可能性があります。そのため、異なる開発やユーザー設定に基づいてフィーチャーのテキストが変更されるかどうかを把握する必要があります。変更される場合、ページとフィーチャーへのタグ付けの際に注意してください。テキストに依存しない他のタグを使用することをお勧めします。
アプリが一貫して単一の言語を使用している場合にのみ、テキストベースの属性を使用してください。
一般(General)属性
一般属性はローカリゼーションに対して安全であり、位置指向ではありません。以下のものが含まれます。
- 動作(Action)
- ユーザー補助(アクセシビリティ)識別子
- 閲覧タグ
- ID
- 画像名
注:SDKが要素を確実に認識するためには、一般属性が推奨されます。
属性の詳細
すべてのフィーチャーに対してすべての属性が表示されるわけではありません。フィーチャーごとに異なる属性セットがあります。
ルール名 | 説明 | カテゴリー | iOSまたはAndroid | 位置的に動的な要素への対応 |
ローカリゼーションへの対応 |
動作(Action) | ユーザーがフィーチャーをタップまたはクリックすることによってトリガーされるアクションです。 | 一般 | 両方 | 可 | 可 |
テキスト | フィーチャーのテキストを表示します。 | テキスト | 両方 | 可 | いいえ |
ユーザー補助(アクセシビリティ)のヒント | アクセシビリティとユーザーの理解に役立つ、実行したアクションの説明です。 | テキスト | iOS | 可 | いいえ |
ユーザー補助(アクセシビリティ)ラベル | アクセシビリティとスクリーンリーダーを支援する、フィーチャーの説明テキストです。 | テキスト | 両方 | 可 | いいえ |
ユーザー補助(アクセシビリティ)識別子 |
アクセシビリティとテストに役立つ、フィーチャーを識別するためのテキストです。 |
一般 |
iOS |
可 |
可 |
索引 |
親フィーチャー内のフィーチャーの位置です。 |
位置 |
両方 |
いいえ |
可 |
閲覧タグ |
コード内での参照や操作を簡単にする、フィーチャーの識別子です。 |
一般 |
両方 |
可 |
いいえ |
子要素のテキスト |
子要素のテキストがこのページで一意である場合は、この属性を使用します。 |
テキスト |
両方 |
可 |
いいえ |
セル行 |
テーブル内の行の位置です。 |
位置 |
iOS |
いいえ |
可 |
セルセクション |
テーブル内のセクションの位置です。 |
位置 |
iOS |
いいえ |
可 |
画像名 | 画像資産の名前です。 | 一般 | iOS | 可 | 可 |
ID | コード内で開発者によって割り当てられた一意の識別子です。 | 一般 | Android | 可 | 可 |
ビューコントローラー | アプリの画面階層におけるフィーチャーのコンテナ要素です。 | 一般 | iOS | 可 | 可 |
フィーチャークラス |
フィーチャーのクラス名です。 |
一般 |
両方 |
可 |
可 |
アイコンコード |
フォント内のアイコンに割り当てられた一意の値です。 |
一般 |
両方 |
可 |
可 |
Pendoタグ |
コード内で開発者が設定した要素の一意の識別子です。 |
一般 |
Android |
可 |
可 |
選択可能(Selectable) |
要素を選択できます。 |
一般 |
Android |
可 |
可 |
切り替え可能 |
要素はトグルボタンを使ってオンとオフを切り替えることができます。 |
一般 |
Android |
可 |
可 |
編集可能 |
要素のテキストは編集できます。 |
一般 |
Android |
可 |
可 |
役割 |
要素の役割。 |
一般 |
Android |
可 |
可 |
親IDの優先順序(Hierarchy of parent IDs) |
機能の階層における親要素の識別子。 |
一般 |
Android |
可 |
可 |