ガイド表示アラート

最終更新日: 2026年07月14日 09:36

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

アラート

アラートは、アラートタイプごとにガイドステップで生成されます。アラートタイプの詳細については、この記事の「アラートタイプ」を参照してください。

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

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

タブの概要

［アラート（Alerts）］リストには、表示できなかったガイドステップごとのアラートが表示されます。リストには、次の詳細情報も表示されます:

アラートの種類
影響を受ける訪問者
ステップが表示に失敗した頻度

［アラートステータス（Alert Status）］、［ミュート（Mute）］、［メモを表示（Show Notes）］は、アラートレビューのワークフローで使用します。対応中のアラートのステータスを追跡して共有したり、誤検知によるアラートをミュートしできます。

要件

Web SDKバージョン2.41.1以降

ガイドアラートへの対応

ガイドアラートが表示された場合は、一連の手順に従って問題の特定および解決を行うとともに、必要に応じて訪問者をフォローアップします。アラートを解決するために必要なアクションはガイドによって異なりますが、まずはアラートタイプを確認するところから始めます。［影響を受けた訪問者数（Visitors Impacted）］と［アラート率（Alert Rate）］は、問題の重大度を示します。［影響を受けた訪問者数］には、そのガイドステップを表示できなかった訪問者が表示されます。［アラート率］には、そのガイドを利用した訪問者のうち、そのステップを表示できなかった割合が表示されます。［最初のアラート日付（First Alert Date）］と［最後のアラート日付（Last Alert Date）］から、アラートが発生した期間を確認できます。この情報を使用して、アラートの原因を調査してください。

ガイドステップの調査

［トリアージ（Triage）］を選択して、アラートを調査中であることを示します。これによりサブスクリプション内の他のユーザーは、このアラートが対応中であることがわかります。また、未調査のアラートを追跡する際に役立ちます。

［アラートタイプ（Alert Type）］を確認し、調査が必要なガイドの箇所を特定します。さまざまなアラートタイプについて詳しくは、この記事の「アラートタイプ」を参照してください。
影響を受けたステップを選択して、ガイドの詳細ページを開きます。［アクティベーション（Activation）］セクションで、ターゲットページとターゲット要素の設定を確認し、このステップの問題を調査します。これらの設定を変更するには、［アプリで編集（Edit in my app）］を選択してビジュアルデザインスタジオを開きます。

マルチステップガイドの場合、ビジュアルデザインスタジオを開いて特定のステップを表示する必要があります。影響を受けたステップをコンテンツプレビューで探し、そのステップにカーソルを合わせて、ステップ上でデザイナーを起動します。

3. ［ページの不一致（Page Mismatch）］または［要素が見つかりません（Element Missing）］アラートが表示されている場合は、ビジュアルデザインスタジオの起動時にデフォルトで開く［コンテナを編集（Edit Container）］ウィンドウの［場所（Location）］タブを確認します。アプリケーションの正しいページにいること、およびUIがガイドステップの正しい状態にあることを確認します。ウォークスルーなどのマルチステップガイドでは、設定を確認または更新する前に、アプリケーション内の適切な場所まで操作を進める必要がある場合があります。

［ページの不一致］アラートを解決するには、選択したページ位置がまだ動作するかを確認します。ページ位置が正しくない場合は、新しいページを選択するか、新しいページにタグを付けます。
［要素なし］アラートを解決するには、ターゲット要素が存在するかどうか、およびターゲットルールが対象となる要素を識別しているかを確認します。ターゲット要素が正しくない場合は、新しい要素をターゲットに設定します。
［その他］のアラートを解決するには、ガイドの内容を調べます。コードブロックなど、ガイドのカスタム要素を確認して、技術的な問題でガイドが中断されていないかを判断します。ガイドに不具合が見つからない場合は、ガイドの内容と設定以外の原因を探します。

誤検知（False Positives）

ガイドアラートの感度により、誤検知が発生する場合があります。適切なユーザー体験を提供するために選択したガイド設計であっても、それが原因でアラートが誤って発報されることがあります。たとえば、ユーザーが操作するまで表示されない要素や、アプリケーション内で処理が完了した後に表示される要素を、ガイドステップのターゲットに設定している場合です。この想定される遅延によって、表示エラーのしきい値が経過する前に要素が存在しなかった場合、要素欠落アラートが発生する可能性があります。この場合、ガイドに技術的な問題はなく、ユーザーまたはアプリケーションが期待どおりに応答しませんでした。このような状況下では、アラートをミュートして［アラート］リストから非表示にできます。

備考の追加

アラートごとに備考を追加することで、アラートリストには表示されない補足的なコンテキストを、サブスクリプション内の他のPendoユーザーに共有できます。自分が開発したアプリであれば、アラートのデータを補完し、他のユーザーがアラートを理解するのに役立つ情報が分かっています。表示アラート担当のチームがある場合は、問題が対処中であることを他のユーザーに連絡し、作業の重複を防止します。ミュート済みガイドにアラートを追加して、その理由を記載しておくことで、他の人が個別に調査を行わないようにします。

影響度の評価

［アラート（Alerts）］リストに表示される詳細情報は、問題の重大度を判断するために役立ちます。修正対応や次のアクションを決定する際は、利用可能なすべての情報とガイドの重要性を考慮してください。単純な機能のウォークスルーでアラートが発生しても望ましいことではありませんが、重大なリスクや影響につながる可能性は低いでしょう。一方、重要な通知に関するアラートは、追加の調査やフォローアップが必要になる場合があります。［アラート］リストは、アプリ内メッセージの状況を把握するための支援ツールです。根本原因の分析や対応プロセスは、組織ごとに異なります。

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

［アラート率（Alert Rate）］は、そのステップでアラートが発生した訪問者数を、そのステップを完了した訪問者総数に対する割合で示します。割合が高いほど、多くの訪問者がガイドステップを期待どおりに表示できなかったことを意味します。割合が低い場合は、特定の訪問者のみに影響しているか、誤検知である可能性があります。

アラート日付は、表示の問題がユーザーに影響した期間を特定するのに役立ちます。アラートは、実際にガイドを利用しようとした訪問者に対してのみ生成されます。アラートの原因となった不具合は、［最初のアラート日付（First Alert Date）］より前から存在し、［最後のアラート日付（Last Alert Date）］以降も継続している場合があります。また、アプリやPendoタグの変更がガイドに意図せず影響し、そのタイミングでアラートが発生している可能性もあります。この情報は、表示アラートの根本原因を特定する際に役立ちます。調査中の他のPendoユーザーに対応済みであることを知らせるためにも、アラートステータスを［解決済み（Resolved）］へ変更することが重要です。

アラートリストに表示されるデータは、ページ上部のフィルターで設定した日付範囲に基づきます。［最初のアラート日付］と［最後のアラート日付］には、選択した日付範囲内で最初と最後に発生したアラートが表示されます。実際に記録された最初と最後のアラートは、選択した日付範囲の外に存在する場合があります。根本的な問題が長期間続いている可能性がある場合は、日付範囲を広げて調査し、表示の問題が発生していた期間全体を確認してください。

表示の問題の調査と修正が完了したことを示すには、［アラートステータス（Alert Status）］を［解決済み（Resolved）］に変更します。新しいアラートが発生しない限り、ステータスは［解決済み］のまま維持されます。新たなアラートが発生すると、ステータスは［未レビュー（Not Reviewed）］に戻ります。

トップ統計

［トップ統計（Top Stats）］セクションには、選択した日付範囲およびアプリにおけるアラート数と現在のステータスの概要が表示されます。ミュートされたアラートは合計数には含まれません。

アラート一覧

アラートリストには、ページ上部で選択したフィルターに基づいて、すべてのアラートと影響に関するデータが表示されます。アラートは、指定した時間内にガイドステップが表示されなかった場合に発生します。1つのガイドステップには、アラートタイプごとに複数のアラートを生成できます。また、1つのガイドには、各ガイドステップに対するアラートを生成できます。

アラート行には、影響を受けたステップ、ガイド名、アラートタイプ、アラートステータス、影響を受けた訪問者数、アラートレート、最初のアラート日付、最後のアラート日付が表示されます。列をカスタマイズして、合計訪問者数、最終更新日、アクティベーション方法、セグメント、およびアプリケーションの列を追加できます。列はソートできます。［影響を受けた訪問者］または［アラートレート］でソートすれば、最も重要なアラートに優先順位を付けるときに便利です。

各アラートのコントロールで、ステータスの変更やアラートのミュートができます。リスト上部のオプションを使用すると、ミュートしたアラートの表示／非表示の切り替え、ガイドごとのアラートのグループ化、アラート設定の更新、表示列の編集を行えます。

アラートタイプ

アラートタイプは、表示問題の推定原因を示します。アラートを調査する場合は、最初にアラートタイプを使用します。

ページの不一致。訪問者の現在のURLがガイドステップの設定で選択されているページと一致しなかったため、ガイドステップを表示できませんでした。
要素が見つかりません。ガイドステップの［場所］設定で選択したターゲット要素が存在しなかったため、ガイドステップを表示できませんでした。
その他。［ページの不一致］や［要素が見つかりません］以外の原因です。カスタムコードの問題、アプリケーションエラー、接続の問題などが含まれます。

アラートステータス

アラートステータスは、未確認の新しいアラートがあるかどうか、または既存のアラートがPendoユーザーによって積極的に対応されているかどうかを示します。新しいアラートは［未レビュー（Not Reviewed）］ステータスでリストに表示されます。一方、［トリアージ（Triage）］と［解決済み（Resolved）］は、アラートの対応状況を共有するためにPendoユーザーが手動で設定します。

未レビュー（Not Reviewed）：未対応の新規アラート、または解決済みアラートに対して同じアラートが新規に発生したことでステータスが変更されたもの
トリアージ。アラートを調査中であることを示す場合に設定します。
解決済み。このステータスを設定してアラートが修正されたことを示します。このステータスのアラートは、新しいアラートがない場合、最終的にリストから削除されます。

訪問者への影響

［影響を受けた訪問者数（Visitors Impacted）］、［総訪問者数（Total Visitors）］、および［アラート発生率（Alert Rate）］の各列には、表示の問題による影響を受けた訪問者数が表示されます。アラート発生率は、総訪問者数に占める影響を受けた訪問者数の割合です。

アラートのミュート

アラートを調査した結果、誤検知であることが判明した場合は、そのアラートをミュートできます。ミュートするとリストから非表示になり、その後同じ誤検知アラートが発生しても［未確認（Not reviewed）］として表示されなくなります。

アラートをミュートするには、アラートにカーソルを合わせて［アラートをミュート（Mute Alert）］アイコンを選択します。これにより、すべてのユーザーのリストからアラートが非表示になり、追加のアラートが発生しても再表示されなくなります。ミュートしたアラートを表示するには、リスト上部の［ミュートしたアラートを表示（Show muted alerts）］チェックボックスを選択します。

備考

備考を使って、サブスクリプション内の他のPendoユーザーにアラートに関する連絡ができます。アラートの調査を開始したとき、根本原因を見つけたとき、またはガイドを修正しているときに、備考を追加して、問題が処理されていることをチームの他のメンバーに知らせることができると便利です。ミュートしたアラートにコンテキストを追加するのにも役立ちます。

［ノートを表示（Show Notes）］を選択してガイドアクティビティパネルを開きます。

ノートを入力し、［ノートを追加（Add Note）］を選択します。

ノートは、このアラートに関連付けられたノート一覧に日時とともに追加されます。必要に応じてノートを編集または削除できます。編集したノートにはメッセージの末尾に「（edited）」が追加されますが、日時は変更されません。

アラート一覧

［ミュートしたアラートを表示］には、ミュートしたすべてのアラートが一覧表示されます。この数字は、現在ミュートしているアラートの数を示します。

［ガイド別グループ化（Group by Guide）］は、同じガイド内のステップのアラートをグループ化することで、1つのガイドのアラートすべてをまとめて管理できます。アラートは、アラートタイプごとにガイドステップで生成されます。1つのガイドステップには、アラートタイプごとに1つずつ、全体で最大3つのアラートを設定できます。ガイド別にグループ化すると、多数のアラートを統合できます。ガイド別にグループ化すると、列のソートの効果が制限されます。アラートはガイドグループのコンテキスト内でソートされるため、このビューでは最も重大な表示上の問題を特定するのは難しくなります。

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

［列の設定（Column Settings）］は、リスト内の列の追加、削除、および順序の変更に使用します。列ヘッダーをクリックすると、その列がソートされます。

よくある質問