一般的に、ガイド表示に関する問題の多くは、ガイドの設定、セグメントの動作、または広告ブロッカーが原因です。ガイドプレビューを使用したガイドのテスト、 デバッガーツールの使用、テストセグメントの作成、またはブラウザの広告ブロッカーをオフにすることで、いつでもテストすることができます。
どの方法を行ってもガイドが表示されない理由がわからない場合は、以下のガイドラインを読んで支援を受けることができます。この記事では、ガイドが期待どおりに表示されない場合のトラブルシューティングのガイドラインを紹介します。
プロダクトエリア：［ガイド（Guides）］（ウェブ）
ブラウザの設定を確認する
広告ブロッカーは、ポップアップガイドなどの広告がウェブサイトに表示されないようにするためにブラウザに追加できるプラグイン拡張機能です。ブラウザの広告ブロッカーをオフにして、Pendoガイドの表示を許可できます。
CNAMEを追加して、イベントを収集し、ファイアウォールなどの広告ブロックソフトの対象となる訪問者に確実にガイドを提供することもできます。
ガイドの設定を確認する
ガイドを表示するには、Pendoがページまたはiframeにインストールされている必要があります。ガイドの表示が必要なページやiframeにPendoがインストールされていることを確認したにも関わらず問題が発生する場合は、以下のガイド設定を確認します。
アクティベーション
ターゲット要素がページ上にあり、有効なCSSターゲティングルールが設定されていることを確認します。自動ガイドは、閉じるまで表示されます。アクティベーションセットがない場合、プログラマティックアクティベーションは、ボタン、リソースセンター、またはAPIでガイドを起動します。
ガイドの順序設定とスロットリング
ガイドがガイドの順序付けやスロットリングによって制限されていないことを確認します。
場所
ガイドを表示する場所とドメインが一致していることを確認します。ガイドの場所は、ガイドの手順1の［場所（Location）］タブで設定します。場所に関するよくある問題には、以下のようなものがあります。
- ターゲット要素が表示されない。要素のターゲットルールが正しくないか、要素がターゲットページに存在しません。
- ターゲットページの設定。サイト全体またはページ固有の選択により、表示が制限されています。
- ページターゲットが一致しない。訪問者のブラウザURLがターゲットページのルールと一致しません。
- iframeでのターゲティング。ページターゲットが、訪問者にガイドが表示されるiframeのURLと一致しません。
ガイドのステータス
ガイドが、テスト環境があるステージングに表示するように設定されているか、ライブドメインがある公開に設定されていることを確認します。ドラフトおよび非アクティブなガイドは表示されません。
セグメント
訪問者が、ガイドを表示するために適用されるセグメントルールを満たしていることを確認します。訪問者のデータは静的ではなく、ページ読み込みイベントが発生するたびに訪問者の資格が更新されるため、訪問者はセグメントルールから外れることがあります。リソースセンターをセグメント化する場合、コンテンツを表示するには、関連するリソースセンターモジュールのセグメントに訪問者を含める必要があります。
スケジュール
現在の日付と時刻の範囲が、ガイドのスケジュールされた期間と一致していることを確認します。
以前の閲覧
訪問者がガイドを進めたり、閉じたりしていないことを確認します。バッジとターゲット要素のインタラクションや、自動起動のためのリピートガイド表示など、繰り返し表示を許可する起動方法が設定されていない限り、一度進んだり閉じたりすると、ガイドは再び表示されません。訪問者がガイドを見たかどうかは、ガイドの指標で確認できます。
アプリの設定を調整する
これらのアプリケーションレベルの設定を確認して、ガイドが期待通りに表示されるようにします。
ローカライズ設定
ローカリゼーションがアプリケーションで有効になっている場合、次の設定を確認して、ガイドが訪問者に期待通りに表示されることを確認してください。
- ［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］>［アプリケーション（Applications）］に移動します。
- アプリを選択し、［ローカライズ設定］ タブを開きます。
- サポートされている言語（Supported languages）セクションで、各訪問者に渡されたメタデータ値が「メタデータ値」列の期待値と一致していることを確認します。
- ［翻訳言語がない場合の動作］セクションで、［翻訳がない場合、デフォルトの言語を表示する］設定にチェックを入れます。
MutationObserverの設定
ガイドのパフォーマンスを向上させるため、2023年6月以降に作成されたアプリケーションでは、［MutationObserverを500msタイマーに優先する（Prefer MutationObserver to 500ms timer）］設定がデフォルトでオンになっています。この設定により、ウェブページの変更に対するWeb SDKの応答性が向上します。
ただし、MutationObserver APIはShadow DOMツリー内の要素の変更を検出しません。この制限に対処するために、［Shadow DOM要素でMutationObserverを使用する（Use MutationObserver on Shadow DOM elements）］アプリ設定を提供しています。この設定は、［MutationObserverを500msタイマーに優先する］設定がオンになっている場合にのみ使用できます。
ターゲット要素が表示された際にガイドが正しく表示されるように、［エンジニア設定］セクションで以下の調整を行うことをお勧めします：
-
［Shadow DOM要素で
MutationObserverを使用する］アプリ設定をオンにします。 - または、［
MutationObserverを500msタイマーに優先する］アプリ設定をオフにします。
これらの調整は、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］に移動し、該当するアプリを開き、対応する設定を変更することによって行うことができます。調整を行うごとに、忘れずにガイドの表示をテストしてください。
ガイドの表示に関する問題やセグメントの質問についての詳細は、「ガイドに適用する際に対象となる訪問者のセグメントが異なる」をご覧ください。