アプリケーションの特定のページから開始する必要があるガイドをリソースセンターに追加するには、ガイド作成後に追加のステップが必要です。ガイドが特定のページ上で、または特定の要素が存在する場合に自動的に表示されるように設定している場合、そのページまたは要素が利用できない場合は表示されません。
この記事では、必要となるすべてのページにおいて、リソースセンター内でガイドにアクセスできるようにする方法について説明します。
要件
- Pendoの管理者アカウント権限または次のいずれか。
- ガイドの権限を作成する
- ガイドの権限を公開する
- 対象セグメント:全員またはカスタムセグメント
- リソースセンターにも含める特定のページまたは要素にタグ付けされたガイド
ガイドを定義する
リソースセンター内でサイト全体に表示されるページ固有のガイドを定義するためには、次の4つのステップがあります。
- 元のページ固有のガイドのパーマリンクを取得します。
- リソースセンターのガイドを作成します。
- ガイドをリソースセンターに追加します。
- ガイドをテストします。
この例では、リソースセンターに配置するワンステップガイドの作成方法を説明します。リソースセンターがどこに表示されていても、ガイドはそれらのページで利用可能です。ユーザーがリソースセンターでページ固有のガイドを選択すると、そのページへのショートカットとして機能し、ガイドが自動的に開始されます。
ステップ1. 元のページ固有ガイドのパーマリンクを取得する
- Pendoで[ガイド(Guides)]>[ガイド(Guides)]に移動し、元のページ固有のガイドを選択してガイドの詳細ページを表示します。
- 「ガイドのパーマリンクを作成する」の手順に従って、ステップ1のパーマリンクを取得します。
- 後で使用できるようにこの値を保存します。
ステップ2. リソースセンターのガイドを作成する
- 左側のメニューで[ガイド(Guides)]>[ガイド(Guides)]に移動し、[ガイドを作成(Create Guide)]を選択します。
- [レイアウト(Layouts)]ページで、[ライトボックス:最初から作成する(Lightbox: Start from Scratch)]レイアウトを選択します。
- ガイドに名前(例:ガイドA - リソースセンターステップ)を付けて、[ガイドを作成(Create Guide)]を選択します。
- ガイドの詳細ページで、[アプリ内で管理(Manage In-App)]を選択してビジュアルデザインスタジオ(Visual Design Studio)を開きます。
- ビジュアルデザインスタジオ(Visual Design Studio)の上部メニューバーにあるアクティベーション(Activation)アイコンを選択し、すべてのアクティベーション方法をオフにします。これにより、このガイドはリソースセンターによってのみ有効化されます。
- ガイドステップにテキストとボタンを追加し、ガイドがアプリケーション内の別のページから始まることをユーザーに説明します。以下はその一例です。
- 最初のガイドボタン(例では[今すぐ始める(Start now)]ボタン)を編集します。
- ボタンのテキストを編集し、ユーザーがすでに正しいページにいる場合に、このボタンを選択する必要があることを示します。
- ボタンアクションを[次のステップ(Next Step)]から[ガイドの起動(Launch Guide)]に変更します。
- 元のページ固有のガイドを選択します。
-
[完了(Done)]を選択します。
- 2番目のガイドボタン(例では[そこに移動(Take me there)])を編集します。
- ユーザーが正しいページにいない場合、かつ自動的に正しいページにリダイレクトさせる場合は、ボタンのテキストを編集し、このボタンを選択する必要があることを示します。
- ボタンのアクションを[次のステップ(Next Step)]から[URLリンク(URL Link)]に変更します。
- ユーザーがリダイレクトされるページのURLリンクを入力します。
- ページ固有のガイドのパーマリンクをURLの末尾に追加します。例えば、URLリンクがhttps://app.pendo.io/reportsの場合、パーマリンクを追加した完全なURLは次のようになります。https://app.pendo.io/reports?pendo=26u5F_DJiXkOXc33-M1B2fOBGbw&step=A7t88OqRqJ3badBSDBd7m3WZWT0
- [リンクを新しいタブで開く(Open link in new tab)]のチェックボックスをオフにします。
-
[完了(Done)]を選択します。
- [保存して終了(Save and Exit)]を選択します。
- ガイドの詳細ページから、対象のセグメントを設定して保存します。
- ガイドを[公開(Public)]ステータスに設定します。
ステップ3. リソースセンターにガイドを追加する
ガイドをガイドリストモジュールまたはオンボーディングモジュールに追加します。段階的な手順については、ガイドリストモジュールで「ガイドリストにガイドを追加する」を参照してください。
ステップ4. ガイドをテストする
最終的に、2つのガイドがPendoに作成されました。元のガイドは、特定のページ上で、または特定の要素が存在する場合に自動的に表示されるように、既存の設定を保持します。新しく作成されたシングルステップガイドは、リソースセンター専用として使用され、元のガイドが起動される正しいページにユーザーが到達するための橋渡しの役割を果たします。
URLが静的でない場合の追加設定オプション
ターゲットページのURLが変わる場合、2番目のガイドボタンのアクションで完全なURLを使用しても機能しません。代わりに、URLのどの部分が一意であるかに基づいて使用できる他のオプションがあります。
- 一意のサブドメインには相対URLを使用します。
- 動的URLに対しては2番目のガイドボタンを使用しないでください。
一意のサブドメインに相対URLを使用する
URLの変更部分がサブドメインの場合(例:「https://customer1.pendo.io/reports」と「https://customer2.pendo.io/reports」を比較)、完全なURLリンクの代わりに相対URLを使用できます。これにより、ボタンのアクションでユーザーが現在いるドメインを自動的に取得し、URLフィールドに入力した相対パスをサブドメインの末尾に追加します。必ずガイドのパーマリンクを末尾に追加してください。
- 完全なURLの例:https://customer1.pendo.io/reports
- 相対URLの例:/reports
- ガイドのパーマリンクが追加された相対URLの例:/reports?pendo=26u5F_DJiXkOXc33-M1B2fOBGbw&step=A7t88OqRqJ3badBSDBd7m3WZWT0
2番目のガイドボタンまたは動的URLは使用しない
URLの一意の部分がサブドメイン以外の場所を指す場合、2番目のガイドボタンを使ってエンドユーザーを正しいページに自動的に移動させることはできません。これは、URLにエンドユーザーごとやセッションごとに変わるIDが含まれている場合によく起こります(例:「https://app.pendo.io/customer1/reports/」と「https://app.pendo.io/customer2/reports」を比較)。
代わりにエンドユーザーに対して、アプリケーション内の正しいページに移動して、ページ固有のガイドを起動する準備ができたら[今すぐ始める(Start now)]を選択するように促します。