ガイド表示アラート

最終更新日: 2024年08月29日 19:35

アプリケーションの変更やページルールの変更、ユーザー入力に依存する要素ターゲット、カスタムコードなどのさまざまな理由により、ガイドが期待どおりに表示されなかったり、完全に表示されなかったりすることがあります。この記事は、ガイドアラートの解釈方法と操作方法をまとめたものです。この情報にアクセスするには、左側のメニューから［ガイド（Guides）］に移動し、［ガイドアラート（Guides Alerts）］タブを開きます。

アラート

アラートは、アラートタイプごとにガイドステップで生成されます。アラートタイプについては、本記事の 影響を受けたステップを調査するのセクションを参照してください。

アラートは、実際の訪問者がガイドを使用しようとした場合にのみ生成されます。アラートは、設定時間内に対象の訪問者に対してガイドステップが表示されない場合にトリガーされます。設定時間は変更可能です。詳細については、この記事のアラートテーブルの設定を参照してください。

ガイドステップごとに複数のアラートを設定でき、アラートタイプごとに1つのアラートを設定します。また、ガイドは、ガイドステップごとにアラートを設定できます。1つのガイドステップには、アラートタイプごとに1つずつ、全体で最大3つのアラートを設定できます。

タブの概要

データは、ページ上部のフィルターで設定した日付範囲やアプリによって絞りこむことができます。

フィルターの下にある［上位の情報（Top Stats）］は、設定した日付範囲とアプリの各アラートステータス（未レビュー（Not Reviewed）、トリアージ（Triage）、解決済み（Resolved））で影響を受けたガイドステップ数の概要です。ミュートされているアラートはカウントされません。

このセクションの下にある［アラート（Alerts）］テーブルには、選択した日付範囲とアプリについて、訪問者に表示されなかった各ガイドステップ（影響を受けたステップ（Impacted Step））が一覧表示されます。テーブルの右上にある［列を管理（Manage Columns）］アイコンを選択すると、次のオプション列をカスタマイズできます。

縦棒（Column）	説明
アラートタイプ	アラートを引き起こした状況のタイプ。アラートの解決に必要なアクションはガイドによって異なりますが、まずはこの列を確認するところから始めます。詳細については、本記事のガイドアラートを調査するのセクションを参照してください。
アラートステータス	アラートをレビューしたかどうかは、［未レビュー］（デフォルト）、［トリアージ］、［解決済み］のいずれかのラベルが付いているかどうかによって判断できます。作業の重複を避けるため、問題を調査中である場合はアラートのステータスを［トリアージ］に、問題が解決された場合は［解決済み］に変更します。
影響を受ける訪問者	ガイドステップが表示されなかった訪問者の数。アラートは、実際の訪問者がガイドを使用しようとした場合にのみ生成されます。
総訪問者数	最後に更新された影響を受けるステップのガイドを見た訪問者の総数。
アラートレート	ガイドステップが表示されなかった訪問者の割合。［影響を受けた訪問者数（Visitors Impacted）］を［総訪問者数（Total Visitors）］で割り、その値に100を乗じて算出します。
初回アラート日	影響を受けたステップの最初のアラートの日付。実際の初回アラート日は、フィルターで選択した日付範囲外である可能性があります。フィルターの日付範囲を広げて確認してください。
最終アラート日	影響を受けたステップの最新のアラートの日付。実際の最終アラート日は、フィルターで選択した日付範囲外である可能性があります。フィルターの日付範囲を広げて確認してください。
アプリ	影響を受けたステップのガイドが属するアプリケーション。
セグメント	影響を受けたステップの対象となるセグメント。
アクティベーション方法	影響を受けたステップのガイドが属するアクティベーション方法。
最終更新者	影響を受けたステップのガイドを最後に更新した社内ユーザー。
最終更新日時	影響を受けたステップのガイドが最後に更新された日時。

アラートテーブルの設定

［アラート］テーブルの右上にある［列を管理］アイコンを選択すると、テーブル内の列の追加、削除、順序の変更ができます。

アラート

［アラート］テーブルの各列は、テーブル内の列ヘッダーを選択することで並べ替えることができます。［影響を受けた訪問者数（Visitors Impacted）］または［アラートレート（Alert Rate）］で並べ替えると、最も重要なアラートに優先順位を付けるときに便利です。

さらに優先順位をつけるには、 ［アラート］テーブル内の各アラートの設定によりステータスの変更やアラートのミュートを実施します。ミュートしたアラートの表示設定を変更したり、ガイド別にアラートをグループ化したり、アラート設定を変更したりすることもできます。

［ミュートしたアラートを表示（Show Muted Alerts）］は、ミュートしているすべてのアラートをテーブルに表示します。このオプションの横の数字は、テーブル内のミュートしているアラートの現在の数を示します。

［ガイド別にグループ化（Group By Guide）］は、各ステップのアラートをガイド別に整理し、1つのガイドに対してすべてのアラートをまとめて管理できます。ガイド別にグループ化すると、列の並べ替えの効果が制限されます。アラートはガイドグループのコンテキスト内で並べ替えられるため、このビューで最も重大な表示上の問題を特定するのは難しくなります。

［アラート設定（Alert Settings）］には、表示アラートをトリガーするまでの経過時間を制御する ［表示エラーしきい値（Display Error Threshold）］設定もあります。デフォルトの時間は10秒です。

ガイドアラートを調査する

［アラート］テーブルは、アプリ内メッセージの状況監視に役立つツールです。ガイドアラートを受信したら、テーブルの情報からアラートの原因を調査し、問題を特定して解決するとともに、必要に応じて訪問者をフォローアップします。根本原因の分析と対応プロセスは、組織によって異なります。

アラートステータスを変更する

まず、アラートが調査中であることを示すために、該当するステップの［アラートステータス（Alert Status）］ドロップダウンから［トリアージ］を選択します。これによりサブスクリプション内の他のユーザーは、どのアラートが対応中であるか判断できます。また、レビューされていないアラートを追跡する際にも役立ちます。

影響を受けたステップを調査する

次に、影響を受けたステップの ［アラートタイプ（Alert Type）］を確認します。

［ページの不一致（Page Mismatch）］は、訪問者の現在のURLがガイドステップの［場所（Location）］設定で選択したページと一致しなかったため、ガイドステップを表示できなかったことを示します。
［要素なし（Element Missing）］は、ガイドステップの［場所］設定で選択したターゲット要素が存在しなかったため、ガイドステップを表示できなかったことを示します。
［その他（Other）］には、［ページの不一致］または［要素なし］以外の原因として、カスタムコードの問題、アプリケーションエラー、接続に関する問題などが含まれます。

影響を受けたステップを調査する際には、［アラート］テーブル内の利用可能なすべての情報とガイドの内容の重要性をもとに、修正対応とその次の手順を決定してください。単純な機能のウォークスルー中にアラートが表示されるのは困りますが、リスクを引き起こすものではない可能性があります。重大な通知に関するアラートでは、さらに調査とフォローアップが必要な場合があります。

重大度を評価する

［影響を受けた訪問者数］と［アラートレート］は、問題の重大度を示します。

［影響を受けた訪問者数］は、影響を受けたガイドステップを見なかった訪問者の数を示します。数字を選択すると、該当する訪問者のリストが表示されます。リストから個々の訪問者IDを選択すると、訪問者のタイムラインが表示されます。ウォークスルーでの誤った要素の選択や誤ったURLへの移動など、ステップが表示されなかった理由をここで特定できます。訪問者リストをすべてCSVとしてダウンロードして、影響を受けたユーザーのグループ全体に対する追加の分析用またはコミュニケーション用のセグメントを作成できます。

［アラートレート］は、総訪問者数に対するアラートをトリガーした訪問者の割合を表します。パーセンテージが50%を超える場合、ユーザーの多くがそのガイドステップを予定どおり表示できなかったことを意味します。パーセンテージが低い場合は、アラートが特定のユーザーに限られているか、誤検知の可能性があります。

タイムフレームを把握する

アラート日（初回アラート日と最終アラート日）を使用して、アラートがいつ発生したかを把握し、問題のタイムフレームを特定します。アラート発生のタイミングが、ガイドに偶発的に影響を与えたアプリやPendoタグの変更時期と合致している場合、タイムフレーム特定の参考になります。ガイドに常に問題があるため、再設計が必要な場合もあります。アラートの原因となっている実際の問題は、［初回アラート日］より前に発生し、［最終アラート日］以降も引き続き存在している可能性もあります。

初回アラート日と最終アラート日の各列には、ページ上部のフィルターで選択した日付範囲内の最初と最後のアラートが表示されます。実際に記録された最初と最後のアラートは、選択した日付範囲外である可能性があります。より広い日付範囲を調査して、問題のタイムフレーム全体を確実に見つけてください。

ガイドの詳細を見る

さらに詳しく調査するには、 ［影響を受けたステップ］列からステップを選択して、該当するガイドの詳細ページに移動します。

シングルステップガイドの場合は、［アクティベーション（Activation）］タイルの［ターゲットページ（Page Location）］と［ターゲット要素（Target Element）］を確認して、問題のトラブルシューティングを行います。これらの設定を変更するには、［自分のアプリで管理（Manage in my app）］を選択して、ビジュアルデザインスタジオ（Visual Design Studio）を開きます。

マルチステップガイドの場合は、ビジュアルデザインスタジオを開いて特定のステップの設定を確認し、問題のトラブルシューティングを行います。ガイドの詳細の［コンテンツ（Content）］セクションで、該当するステップにカーソルを合わせ、［デザイナーを起動（Launch Designer）］を選択します。

トラブルシューティング

［ページの不一致］または［要素なし］アラートが表示された場合は、［コンテナ設定（Container Settings）］内の［場所］タブを確認します。このタブは、ビジュアルデザインスタジオを開いたときにデフォルトで開きます。アプリケーションの正しいURLにいること、およびUIがガイドステップの正しいコンテキストにあることを確認します。ウォークスルーのような複雑なガイドでは、設定に関するトラブルシューティングを開始する前に、アプリ内を移動する必要がある場合があります。

［ページの不一致］アラートの場合は、選択した場所がまだ動作するかを確認します。ターゲットページが正しくない場合は、新しいページを選択するか、新しいページにタグを付けます。［要素なし］アラートの場合は、ターゲット要素が存在するか、およびターゲットルールが対象となる要素を識別しているかを確認します。ターゲット要素が正しくない場合は、新しい要素を再度ターゲットとして設定します。

［その他］のアラートタイプのトラブルシューティングを行うには、ガイドの内容を調査してください。コードブロックなど、ガイドのカスタム要素を確認して、技術的な問題でガイドが中断されていないかを判断します。ガイドに不具合が見つからない場合は、ガイドの内容と設定以外の原因を探します。

アラートを解決する

アラートの根本原因を発見し、トラブルシューティングに成功したら、ステータスを［解決済み］に変更します。該当するステップの［アラートステータス］ドロップダウンから［解決済み］を選択します。再度アラートがトリガーされない限り、ステータスは解決済みのままになります。別のアラートがトリガーされた場合、アラートステータスは［未レビュー］に戻ります。

アラートをミュートする

ガイドアラートの感度や特定のガイド設計によっては、誤ってアラートをトリガーする誤検知が発生する可能性があります。このような場合、新たな誤検知アラートがトリガーされるたびに［未レビュー］として表示されないよう、アラートをミュートして非表示にできます。

たとえば、ユーザーがアクティブ化するまで表示しない要素、またはアプリケーションのプロセス実行後に表示する要素のガイドステップをターゲットにした場合、この時間差により表示エラーしきい値内に要素が存在しないと判断され、［要素なし］アラートがトリガーされることがあります。この場合、ガイドに技術的な問題はなく、訪問者またはアプリケーションが予期したとおりに応答しなかったことによる誤検知です。このような状況下では、アラートをミュートして［アラート］テーブルで非表示にできます。

アラートをミュートするには、テーブル内の影響を受けたステップの行にカーソルを合わせ、行の端のメモ（吹き出し）アイコンの隣にある［アラートをミュート（Mute Alert）］（ベル）アイコンを選択します。この操作により、該当するアラートはすべてのPendoユーザーのテーブルで非表示になり、再度アラートが表示されることはありません。

ミュートしたアラートをテーブルに表示したい場合は、［アラート］テーブルの上部にある［ミュートしたアラートを表示］を選択します。

メモの追加

アラートデータを補足する詳細やコンテキスト情報が存在する場合に、メモを追加することで、［アラート］テーブルの列にないその他の情報を含めることができます。たとえば、チームで次のようなアラート処理を行っている場合、作業の監査証跡を作成し、他の社内ユーザーに通知できます。

作業の重複を避けるために問題を処理しているとき
問題の根本原因と内容を発見したとき
ガイドを修正しているときと修正方法

メモはリマインダーとして機能し、サブスクリプション内の他のPendoユーザーとのコミュニケーションに役立ちます。ミュートしたアラートの場合、アラートをミュートした理由を説明するためにもメモを活用できます。

アラートにメモを追加するには、テーブル内の影響を受けたステップの行にカーソルを合わせ、行の端のミュート（ベル）アイコンの隣にある［メモを表示（Show Notes）］（吹き出し）アイコンを選択します。

右側に開いたパネルにメモを入力し、 ［メモを追加（Add Note）］を選択します。ノートは、日付、時刻、ノートを追加した人のユーザー名の下にあるフィードに表示されます。必要に応じて、ノートを編集または削除できます。編集したノートの末尾には「（編集済み）」と追記されますが、日付とタイムスタンプは変更されません。

影響を受けたステップにすでにメモが関連付けられている場合、吹き出しアイコンの横に、そのステップについて入力済みのメモの数を表す数字が表示されます。

よくある質問