モバイルフィーチャーのタグ付け

この記事では、モバイルアプリケーションでフィーチャーにタグを付ける方法と、フィーチャーのタグ付けのトラブルシューティング方法について詳しく説明します。

新しいフィーチャーへのタグ付け

フィーチャーへのタグ付けは、ページにタグ付けする際に実行することも、［ページの管理（Manage Pages）］からデザイナーにアクセスして実行することもできます。

ページ（Pages）にアクセスし、モバイルアプリにフィルターします。
フィーチャーのタグ付けをしたいページを選択します
［ページの管理］を選択し、フィーチャーのタグ付けを開始します。

アプリ内のフィーチャーにタグ付けするには、右のスクリーンショットにある任意のフィーチャーを選択します。そのフィーチャーが左のテーブルに表示されるので、そこで名前を付け、グループ化し、属性を編集してから保存できます。

フィーチャーへのタグ付けのコードベースソリューション

注：現在、iOSおよびAndroidのネイティブアプリ、およびReact Nativeアプリでのみ使用可能です。今後、Xamarin.Formsにこのフィーチャーを追加する予定です。

Pendoが、アプリのフィーチャーを常に認識するとは限りません。Pendoでタグ付けできないようにすることも、タグ付け可能にすることもできますが、その場合は分析結果は表示されません。弊社のコードベースのソリューションでは、モバイル開発者がAPIを使用して、任意のフィーチャーのタグ付けと分析結果を取得できるようにすることで、この問題を解決しています。

これを実装するには、開発者は以下を行う必要があります。

ネイティブアプリケーションの場合：

iOSの場合、`enableClickAnalytics` APIを使用して、フィーチャーをタグ付け可能としてマークし、その分析結果を収集します。
Androidの場合、PendoのUIはクリックできるビューにしかタグを付けることができないため、フィーチャーのプロパティが`clickable:trueになっていることを確認してください。タグ付けしたフィーチャーに対してアナリティクスが得られない場合は、`sendClickAnalytic` APIを使って解決してください。

この方法でフィーチャーをタグ付けしたら、そのアプリバージョンをデバイスにインストールし、ページにタグ付けするか、既存のものを更新する必要があります。

React Nativeアプリケーションの場合：

任意の要素をクリック可能としてマークするには、「nativeID」プロパティを使用します。

<Image
    nativeID="pendoClickableImage"
    source={require('../../../assets/icons/react_native.png')}
    style={{resizeMode: 'contain', width: 100, height: 100, alignSelf: 'center'}}
    onTouchEnd={()=> { Alert.alert("Wohoo I love react native");}}
/>

「nativeID」は正規表現テンプレートと一致する必要があります。デフォルトは「nativeID」のプレフィックス形式である「pendoClickable」で、この場合設定は必要ありません。他の正規表現テンプレートで、顧客がすでに「nativeID」を定義している場合、開発者は次のように正規表現を構成します。
- navigationOptions.clickableElementsNativeIDsRegex経由のReact Native Navigationライブラリの場合：

const navigationOptions = {library: NavigationLibraryType.ReactNativeNavigation, navigation: Navigation, clickableElementsNativeIDsRegex: '^clickable|^pendo_|customRegex'};
PendoSDK.setup(pendoKey,navigationOptions, options);

- traversalOptionsObject.clickableElementsNativeIDsRegex経由のReact Navigationライブラリの場合：

let traversalOptionsObject: RNTraverseOptions = {clickableElementsNativeIDsRegex: '^clickable|^pendo_|...'};

export default withPendoRN(RootNavigator, traversalOptionsObject);

お客様自身で正規表現を設定する場合、すべての正規表現のテンプレートがデフォルトテンプレートに含まれていることを確認する必要があります。'pendoClickable'つまりclickableElementsNativeIDsRegex: '^clickable|^pendoClickable|customRegex'が含まれていることを確認します。
要素をマークした後にクリックアナリティクスが生成されない場合、開発者は「sendClickAnalytics」APIを呼び出し、「nativeID」をパラメーターとして渡す必要があります。次に、ネイティブSDKはレイアウト階層でこのビューを検索し、要素情報を収集して、アナリティクスを送信します。

onTouchEnd={()=> {
  Alert.alert("Wohoo I love react native");
  PendoSDK.sendClickAnalytic("pendoClickableImage")
}

注：APIを使用する場合、分析は遡及されません。このAPIを使用した後にのみ、データは収集されます（トラックイベントと同様）。

既存のフィーチャーの編集

デザイナーのページから、特定のページのタグ付けされたすべてのフィーチャーにアクセスできます。

タグ付けされたフィーチャーを編集する他の方法として、左側のナビゲーションで［プロダクト（Product）］に移動し［フィーチャー（Features）］をクリックします。次に、［アプリ内フィーチャーの管理（Manage Features In-App）］を選択すると、フィーチャーがタグ付けされているページでデザイナーが開きます。

Screen_Shot_2022-03-01_at_8.45.56.png

フィーチャーの属性

注：フィーチャー属性の編集時には、キャッシュのため、ガイドで新しい属性が反映されるまで5分かかります。

Screen_Shot_2022-03-01_at_8.47.40.png

すべてのテキストを除外（All Text Excluded）

フィーチャーのルールからすべてのテキストフィールドを除外する場合は、この属性を切り替えます。

含まれているテキストに関係なく、フィーチャーを追跡するのに最適です。以下はその例です。

多言語対応のアプリで、ボタンのテキストがユーザーごとに異なる場合
ユーザーや時間帯によってボタンのテキストが異なる場合

アプリ全体のフィーチャー（App-wide Feature）

ナビゲーションメニューやタブバーボタンなど、モバイルアプリ全体に表示されるフィーチャーに使用されます。アプリ全体のタグ付けを使用すると、ページがアプリ内でタグ付けされているかどうかに関係なく、Pendoはこれらのフィーチャーのクリックイベントを収集できます。

ベストプラクティスとして、ホーム画面からアプリ全体のフィーチャーにタグを付けるか、自分（または他の人）が簡単に見つけられるように命名規則を使用します（例："Info (tagged on Home)"）。

注：アプリ全体のフィーチャーは、そのフィーチャーがタグ付けされた元のページから編集できます。この時点では、同じフィーチャーを含む他のページを管理する際に、そのフィーチャーはタグ付きとして表示されません。

リスト内のすべての項目を1つのフィーチャーとしてタグ付け（Tag all items in the list as a single feature）

Pendoは、アプリケーション内のリスト項目（テーブルの行、メニューのエントリなど）にタグ付けする際、リスト内のアイテムの位置またはインデックスで自動的にフィーチャーをタグ付けします。

例：
最初のリスト項目がタグ付けされている場合、Pendoは最初の項目をクリックしたときにのみ分析を収集します。3番目の項目がタグ付けされている場合、Pendoは3番目の項目をクリックしたときのみ分析を収集します。以降同様です。これは通常、静的リストで動作が正常に行われます。

「リスト内のすべての項目を1つのフィーチャーとしてタグ付け」属性は、ユーザーがアプリケーションにログインするたびにリストのコンテンツが変更されるような動的リストに使用できます。これにより、リスト要素の位置に関係なく、その要素をクリックした場合の分析結果を収集できます。

「ガイドの起動」としてリスト項目を選択すると、リスト項目のいずれかをクリックすることでガイドが起動します
リスト項目をツールチップガイドでターゲットにすると、リストの最初の項目がポイントされます

高度なフィーチャーの属性

Pendoは、モバイルフィーチャーをその属性に基づいて識別します。場合によっては、自動的に選択されたデフォルトの属性がフィーチャーを正確に識別できないことがあります。フィーチャーを最もよく識別する属性を切り替えることで、フィーチャールールを調整できます。

注：すべてのフィーチャーにすべての属性が表示されるわけではありません。フィーチャーごとに異なる属性セットがあります。

バンドル名除外（iOSのみ）

バンドル名は、Appleのエコシステムにおいてアプリケーションを一意に識別するためのものです。つまり、2つのアプリケーションが同じバンドル識別子を持つことはできません。バンドル名は要素IDの一部であり、アプリのバージョンによって異なる場合があります（例：本番アプリとテストアプリ）。バンドル名を無視してフィーチャーを識別させたい場合は、フィーチャールールから除外することをお勧めします。

クリックアクション（iOS、React Nativeのみ）

クリックアクションは、フィーチャーがクリックされたときにアプリ内コードで呼び出されるメソッドのシグネチャです。このメソッドのフィーチャークリックアクションでフィーチャーが一意に識別される場合は、この属性を有効にします。

表示テキスト

フィーチャーの表示テキスト。このテキストでこのフィーチャーが一意に識別される場合は、この属性を有効にします。

ユーザー補助（アクセシビリティ）ラベル

テキストは、支援技術（音声）によって、暗黙的なコンテキストに頼ることなく、そのフィーチャーが何をするものであるかを説明するために使用されます。このテキストがこのページのすべてのユーザー補助のヒントに対して一意である場合は、この属性を有効にします。

ユーザー補助（アクセシビリティ）のヒント（iOSのみ）

ユーザー補助の要素に対してアクションを実行した結果の説明を含むテキスト。そのテキストがこのページのすべてのユーザー補助のヒントに対して一意である場合は、この属性を有効にします。

ユーザー補助（アクセシビリティ）識別子（iOSのみ）

開発者向けの文字列で、UI自動化ツールやテストツールがユーザー補助要素を識別するために使用されます。そのテキストがこのページのすべてのユーザー補助識別子に対して一意である場合は、この属性を有効にします。

ネストされたテキスト

そのフィーチャーの子要素の表示テキスト。子要素のテキストがこのページで一意である場合は、この属性を有効にします。

indexInParent

このフィーチャーは、各項目が固有の位置を持つ、順序付けられた項目のコレクションの一部です。コレクション内のフィーチャーの位置（インデックス）が静的な場合は、この属性を有効にします。注：インデックスリストは0から始まります。そのフィーチャーがテーブルビュー内にある場合は使用しないでください。

フィーチャーID（Androidのみ）

コード内で開発者によって割り当てられたフィーチャーID。「フィーチャー分析で問題点を特定する方法」のページにあるこのフィーチャーの一意の識別子であるため、この属性を有効にします。

フィーチャー分析の問題の特定

特定のフィーチャーに対するクリック数が少なすぎたり、多すぎたりしていませんか？もしくは、各フィーチャーが同じクリック数を示していませんか？

これは、Pendoが選択したデフォルトのルールが厳密すぎるか、十分に厳密でないことを意味する可能性があります。分析結果に潜在的な問題が見つかった場合は、フィーチャーのルールを調整することをお勧めします。

アップデート方法：

ページ（Pages）にアクセスし、モバイルアプリにフィルターします。
フィーチャーがオンになっているページを選択し、［ページの管理］をクリックします。
更新するフィーチャーの［編集］ （鉛筆アイコン）を選択します。

Screen_Shot_2022-03-01_at_8.51.32.png

変更を適用する前に、それがフィーチャールールにどのように影響するかを常に確認できます。

Screen_Shot_2022-02-06_at_14.17.01.png

注：変更が処理されてUIに正しく反映されるには、最大で90分かかることがあります。

「below the fold」フィーチャーのタグ付け

一部のフィーチャーが「below the fold」（スクロールしないと見えない領域）にある場合、つまり元のページのスクリーンショットに存在しない場合には、以下の手順に従ってください。

ページをスクロールした状態でキャプチャし、新しいページとして保存します。保存名は、これが「below the fold」のキャプチャであることがわかるようにしても良いでしょう。
この新しいページで、フィーチャーのタグ付けを行います。
この「below the fold」ページのページ分析は元のページと同じになることに注意してください。

よくある質問

フィーチャーを特定する方法は？

フィーチャーはページのコンテキストで常にタグ付けされます。
ルールは、要素の「クラス」、要素のテキストが存在する場合はそのテキスト、リスト内での位置、ページ上での位置、およびその他の多くのパラメータに関連するタグ付けされたフィーチャーごとに作成されます。
フィーチャーが正しく認識されない場合は、サポートにご連絡ください。お客様のニーズに合わせてフィーチャーのルールを変更します。
アプリのバージョンがいずれであっても、フィーチャーは通常は正しく認識されます。ただし、アプリのユーザーインターフェイスを変更し、特にボタンのテキストを変更した場合は、すべてのフィーチャーが正しく識別されるようにモバイルページを更新し、必要に応じてタグ付けを修正する必要があります。

フィーチャーの上にカーソルを置くと、目的のフィーチャーではなく、複数のフィーチャーがハイライト表示されます。どうすればよいでしょうか？

Pendoの自動フィーチャー識別（ルール）では、ページ上の複数のフィーチャーを区別できないという状況を防ぐために、タグに一致するすべてのフィーチャーが強調表示されます。つまり、自動ルールを調整しなければ、これらのフィーチャーは同じものとしてカウントされてしまいます。
これを解決するには、最初のフィーチャーにタグを付け、そのルールをこのフィーチャーに特化したものに調整してから、もう一方のフィーチャーにタグを付けます。

私のアプリケーションでは、いくつかのフィーチャーがタグ付けできません。どうすればよいでしょうか？

アプリ内にモバイルボタンを実装する方法は数多くあるため、SDKがフィーチャーを識別する方法を最適化しています。ただし、特定のモバイルフィーチャーのタグ付けができない場合や分析結果が受信できない場合は、Pendoサポートにお問い合わせください。可能な回避策は、トラックイベントを使用して特定のフィーチャーを追跡し、そのデータを収集することです。

タグ付けされたページの一部で、新しい分析結果が取得できなくなりました。原因は何ですか？

最近、ストアで新しいバージョンのアプリをリリースしましたか？新しくリリースされたアプリのバージョンで、一部のページやフィーチャーが変更された場合は、モバイルページを更新することで更新できます。