モバイルアプリでのページのタグ付け

アプリ内のページをPendoページとしてタグ付けすると、ページトラフィックを表示して、モバイルユーザーのフローと行動を理解できます。

PendoモバイルSDKは、インストールが完了すると分析を収集し始めます。タグ付けを行ったタイミングで、分析の対象はSDKをインストールした時点にまでさかのぼります。つまり、事前にアプリにタグを付けなくてもPendoはアプリ内のユーザーアクションを自動的に追跡します。

モバイルアプリでのページのタグ付け方法については、Pendo Academyの動画をご覧ください。

ページの特定方法

モバイルページにタグを付ける場合、Pendoはページの構造に基づいて、自動的にページルールを設定します。アプリケーションはそれぞれ異なるため、自動ページルールが常に正しいわけではありません。ページルールが正しい分析を生成するように、追加の設定が必要になる場合があります。

ページのタグ付けルール

ページルールと最初のページ閲覧数は、Pendo UIでページにタグ付けしているときに表示されます。ページ閲覧数には、過去24時間の閲覧数と、過去24時間のトラフィック全体におけるビューのパーセンテージが反映されます。これにより、自動的に割り当てられたページルールが正確か、調整が必要かどうかがわかります。

ルールコンポーネント

以下の表は、ページの特定に役立つルールコンポーネントの使用方法についてのガイダンスです。コンポーネントを自由に組み合わせて選択して、ページルールを構築することができます。

次の例におけるPendoの動作は以下のとおりです。

• Pendoはページタイトル［新着（JUST ARRIVED）］を使用してページを特定します。タイトルが［新着］のページのみがこのページとして特定されます。
• Pendoは、選択済みタブのインデックスを使用してページを特定します。Pendoは、選択済みタブが最初のタブである場合にのみ、ビューをこのページによるものとします。別のタブが選択されている場合、Pendoはこれを別のページと見なします。
• Pendoは、ページを特定する際に、選択済みタブのタイトル［到着（Arrived）］は使用しません。このアプリが複数の言語に翻訳されていて、このテキストがユーザー全体で一貫していない場合には合理的な方法です。 
  
  

ページのタグ付け

1. ［プロダクト（Product）］>［ページ（Pages）］に移動し、［ページをタグ付け（Tag Pages）］を選択します。
2. ［モバイルアプリ（Mobile app）］を選択し、リストからアプリを選択します。
3. ［デザイナーを起動（Launch Designer）］を選択します。
4. ［新しいデバイスに接続（Connect a new device）］ボタンでモバイルデバイスを接続し、指示に従って操作するか、すでにデバイスが接続されている場合はアプリを再起動します。デバイスが接続されると、カメラアイコンがデバイスに表示されます。
5. アプリ内で、タグ付けしたいページに移動し、デバイスのカメラアイコンをクリックして、ページ要素にタグ付けします。
6. Pendo UIにページのスクリーンショットが表示されたら、ページに名前を付け、必要であればグループに割り当てます。
7. ［保存して終了（Save and Exit）］を選択して、新しくタグ付けされたページを保存します。または、［フィーチャーをタグ付け（Tag Features）］を選択したり、他のページのタグ付けを行うこともできます。

いつでもページやフィーチャーにタグを追加できます。アナリティクスは遡及的に収集されます。

ページの更新

タグ付きフィーチャーのあるページを更新すると、古いキャプチャが新しいキャプチャに置き換わります。つまり、新しいスクリーンショットにはないタグ付きフィーチャーが存在する可能性があります。新しいフィーチャーのあるページを更新する必要があります。手順については、「モバイルアプリでのフィーチャーのタグ付け」を参照してください。

ページルールの管理

最初にタグ付けを行った後は、［ページルール（Page Rules）］設定にアクセスし、さらに編集を行ってページルールを管理し、必要に応じて［カスタム識別子（Custom identifier）］を追加できます。Pendoでの操作：

1. ［ページ（Pages）］にアクセスし、該当するページを選択します。
2. ［ページを管理］を選択します。
3. ［ページルール（Page Rules）］タブに移動します。
4. 必要な変更を行い、カスタム識別子を追加します。

ヒント：変更を行う場合は、過去24時間のページ閲覧数を確認して、変更の影響を把握することを検討してください。

カスタム識別子

カスタム識別子は、特定のページに固有のラベルです。アプリケーション内のページは、類似したページ構造を持つため一意に識別できない場合があり、その結果、データが重複することがあります。

ページ上の要素が特定の属性を使用している場合は、カスタム識別子を作成できます。iOSアプリの場合、カスタム識別子は、テキスト、アクセシビリティ（ユーザー補助）ラベル、アクセシビリティのヒント、またはアクセシビリティ識別子の属性を使用します。要素にはこれらの属性の少なくとも1つが必要で、カスタム識別子は要素に存在するすべての属性を使用して作成されます。

注：ユーザー補助（アクセシビリティ）識別子属性はローカリゼーションに対応していますが、テキスト属性は対応していません。ローカリゼーションを使用するiOSアプリで、テキスト属性とユーザー補助（アクセシビリティ）識別子属性の両方を使用する要素がある場合、テキスト属性がアプリでサポートされている言語ごとに異なるため、カスタム識別子には使用しないことをお勧めします。ユーザー補助（アクセシビリティ）識別子属性のみを持ち、テキスト、ユーザー補助（アクセシビリティ）ラベル、ユーザー補助（アクセシビリティ）ヒント属性を持たない要素を使用してください。

Androidアプリの場合、カスタム識別子は、テキスト属性とユーザー補助（アクセシビリティ）ラベル属性のみを使用する要素で使用してください。この要素には少なくとも1つの属性が必要で、カスタム識別子はこれらの属性のうち1つまたは両方を使用して作成されます。

カスタム識別子を追加する方法は以下のとおりです。

1. データが重複しているページの1つを選択し、［ページの管理（Manage Page）］を選択します
2. ［ページルール（Page Rules）］タブに移動します。
3. ページを識別するテキストラベルをマークするなど、カスタム識別子をページに追加します。
4. ページの閲覧数が正しいことを確認します
5. ［+カスタム識別子を追加（+ Add Custom Identifier）］を選択し、アプリの画面からテキストラベルを選択します。
   
   
   
   
6. 表示される［選択モード（Selection Mode）］バーでチェックマークを選択してページルールに追加し、フィーチャーが存在する正確なページを指定します。

注：スクロールしないと表示されない画面の一部をキャプチャする場合、カスタム識別子を持つキャプチャを削除しても、識別子はページルールから削除されません。 ページを削除したことを通知する警告が表示され、ページを再度キャプチャするかどうかを決定できます。

カスタム識別子は、すべてのアプリバージョンに存在するページに対してのみ追加できます。 

Pendoは、ページを一意にするためのカスタム識別子も推奨します。推奨はテキスト形式で、このページに固有のものであるため、選択することでページを一意にします。

1. 推奨された識別子にカーソルを合わせ、［識別子を追加（Add identifier）］を選択します。または、［手動で追加（Add manually）］を選択して、独自の識別子を追加することもできます。詳細については、「カスタム識別子」を参照してください。
   
   
2. 識別子を削除するには、識別子の上にカーソルを合わせてゴミ箱アイコンを選択します。

ルールやカスタム識別子を追加することで、ページがより一意になり、重複するページの数が減少します。ページが一意な場合、確認メッセージが表示されます。

取得したページを一意にする

一意のページは、ページ構造とその一意のコンポーネントによって定義されます。新しいページが取得されると、Pendoは既存のページと一致するページルールによって、取得したページが既存のページと重複しているかを自動的に検出します。その場合、データの重複が発生します。Pendoはすぐにユーザーに通知し、次のステップを決めるための手助けをします。

重複したページがないことを確認するために、次のいくつかの方法を試すことができます。

• ［異なるページをタグ付けします（I want to tag a different Page）］を選択して、他のページと区別します。
• ［既存のページの異なる部分をタグ付けします（I want to tag a different part of an existing Page）］を選択して、新しいキャプチャを既存のページの末尾に追加します。
• ［既存のページの新しいバージョンをキャプチャします（I want to capture a new version of an existing Page）］を選択して、現在のページを更新または上書きします。

異なるページをタグ付けする

Pendoが重複として検出したページをキャプチャした場合、推奨されたカスタム識別子を追加してページを一意にすることができます。Pendoは、このページキャプチャを一意にするためのカスタム識別子を推奨します。

異なるページをタグ付けするには次の手順に従います。

1. ［異なるページをタグ付け（Tag a different Page）］を選択します。
2. ［ページ名（Page Name）］フィールドに新しいページの名前を入力します。
3. （任意）［説明（Description）］フィールドに、説明を追加します。
4. （任意）［プロダクトエリアに割り当てる（Assign to Product Area）］ドロップダウンメニューから、プロダクトエリアを選択します。
5. ルールコンポーネントが表示された場合、矢印を使用して展開し、ページルールを表示して調整します。

同じページの異なる部分をタグ付けする

既存のページの末尾に新しいキャプチャを追加することで、同じページの異なる部分にタグ付けすることができます。

1. ［既存のページの異なる部分をタグ付けする（Tag a different part of an existing Page）］を選択します。［ページ選択（Page selection）］ウィンドウが開き、キャプチャしたページと同じSDKバージョンとアプリバージョンを持つページのみが表示されます。
   
   
   
   
2. どれか1つのページにカーソルを合わせて選択します。
3. 確認メッセージで［続行（Continue）］を選択して、選択を確定します。［ページを管理（Manage Page）］ウィンドウが開き、新しいキャプチャは既存のページの末尾に追加されます。
4. ページのルールとカスタム識別子を追加し、フィーチャーにタグ付けします。

既存のページの新しいバージョンをキャプチャする

既存のページの新しいバージョンをキャプチャする場合、かつアプリのバージョンが異なる場合は、ページは新しくキャプチャしたバージョンで更新されます。新しいページが既存のページと同じアプリバージョンであるとPendoが検出した場合、新しいバージョンを保存すると古いバージョンが上書きされます。

既存のページの新しいバージョンをキャプチャするには、次の手順に従います。

1. ［既存のページの新しいバージョンをキャプチャ（Capture a new version on an existing Page）］を選択します。SDKバージョンとアプリバージョンに関係なく、すべての重複ページは［ページ選択（Page selection）］ウィンドウに表示されます。
   
   
2. ページにカーソルを合わせて選択します。
   • 異なるアプリバージョンのページを選択した場合は、［ページを更新（Update Page）］の確認メッセージで［続行（Continue）］を選択します。ページが更新され、以前のデータが保存されます。
   • 同じアプリバージョンのページを選択した場合は、［ページを上書き（Override page）］の確認メッセージで［上書き（Override）］を選択します。新しいキャプチャは既存のページを上書きし、既存のページルールとカスタム識別子を削除します。
3. ページのルールとカスタム識別子を追加し、フィーチャーにタグ付けします。