モバイルガイドの作成

最終更新日: 2026年01月22日 17:09

この記事では、ビジュアルデザインスタジオを使用してモバイルアプリケーションのガイドを作成する方法を概説します。

要件

ビジュアルデザインスタジオを使用するには、次のいずれかの条件を満たす必要があります。

サブスクリプションの管理者であること。
ガイドの編集または公開権限を持っていること。

ステップ1. ガイドを作成する

モバイルアプリケーションがSDK 2.xと統合されていることを確認してください。管理者は［設定］>［サブスクリプション設定］にアクセスして確認できます。統合されたアプリには［統合済み（Integrated）］ラベルが表示されているはずです。
左側のメニューで［ガイド（Guides）］>［ガイド（Guides）］に移動します。
［ガイド（Guides）］ページで、［ガイドを作成（Create guide）］を選択します。
ドロップダウンメニューから該当するモバイルアプリを選択します。
お好みのガイドレイアウトを選ぶか、Guides Proをご利用の場合はAI支援のオプションのいずれかを使用します。

ステップ2. ガイドコンテンツを追加する

ガイドを作成した後、ガイドの詳細ページで、左上隅にあるデフォルト名を選択して名前を付けます。任意で、ガイド名の下にあるドロップダウンを使用してプロダクトエリアとガイドカテゴリーを割り当てることができます。

ヒント：多くの場合、複数のガイドが存在するため、命名規則を設定し、グループを使用して検索しやすくすることをお勧めします。

次に、［コンテンツ］セクションの右上にある［自分のアプリで編集］を選択します。

ガイドの編集は、［コンテナを編集（Edit Container）］ボックス内で行うことができます。コンテナのデフォルト設定は、アプリのテーマによって設定されます。

コンテナの設定を編集するには、［テーマ（Theme）］を［カスタム（Custom）］に変更します。
最初の編集が完了したら、［完了（Done）］を選択します。
ガイドのプレビュー内のプレースホルダーアイテムにカーソルを合わせて選択し、編集します。
ガイドに新しいビルディングブロック（ボタン、タイトル、画像、文字、投票とアンケート調査など）を追加するには、アイテム間にマウスポインタを合わせ、青い線を表示させます。
＋を選択して、ビルディングブロックを追加します。

ステップ3 .ガイドトランジションアニメーションを選択する

ガイドが各ステップに遷移する方法を選択します。

遷移を変更するには、［コンテナを編集］>［遷移（Transitions）］>［アニメーションタイプ（Animation Type）］に移動し、必要に応じて［アニメーションタイプ］、［期間（Duration）］、［方向（Direction）］を選択します。デフォルトの遷移タイプである［なし（None）］に加えて、［フェード（Fade）］、［ポップ（Pop）］、または［スライド（Slide）］を選択することもできます。

ヒント：マルチステップ、フルスクリーン、またはポップアップガイドの場合は、スライドアニメーションを使用することをお勧めします。

注意：ツールチップには現在、トランジションは利用できません。

ステップ4. ガイドを有効にする

ガイドを作成するときは、ガイドをアクティブにする方法を決定する必要があります。

利用可能なアクティベーションオプションは以下のとおりで、これらは［アクティベーション設定（Activation Settings）］のアクションバーにあります。

アプリの起動

ガイドは、モバイルアプリを開いた後に起動されます。新規ユーザーのオンボーディングや新しいアプリバージョンの新機能の表示など、ページ固有ではないアンケートガイドやお知らせに最適です。startSessionメソッドが呼び出され、モバイルセッションが開始されると同時に、セグメントされた訪問者にガイドが開始されます。

ガイドの繰り返し表示（Repeat Guide Display）。訪問者がガイドを完了または閉じた場合でも、ガイドを訪問者に表示します。

ページの表示

ガイドは、訪問者がアプリ内の特定のページに移動した後に起動されます。アプリ内の特定のページで新しい訪問者を案内したり、特定の画面がメンテナンス中であることを訪問者に通知するなど、ページ固有のオンボーディングやページ固有の機能のお知らせに最適です。ガイドが表示されるアプリ内のページを選択します。既にタグ付けされているページを選択するか、［新しいページをタグ付け（Tag New Page）］ボタンを選択して新しいページにタグを付けます。この場合、新しいページをキャプチャするためには、デバイスが接続されている必要があります。詳細については、「モバイルデバイスの接続」を参照してください。複数のページを選択した場合、いずれかのページを最初に見たときにガイドが起動します。

注：ガイドのステップによって、アクティベーション用に設定されるページが異なる場合があります。別のページにあるガイドの次のステップにユーザーを誘導するには、ディープリンクまたはツールチップを使用したオーガニックなユーザーナビゲーションをお勧めします。

ターゲット要素

訪問者がアプリ内の固有の機能を選択すると、ガイドが起動されます。機能固有のオンボーディング、機能固有のアンケート、ヘルプセンターのアクティベーションに最適です。モバイルアプリでは、バッジからガイドをアクティベーションするオプションはサポートされていません。

目的のページを選択した後、スクリーンショットでガイドを選択してアクティブにする要素を選択します。UI要素が保存されていない場合は、新しいUI要素を保存するように求められます。

トラックイベント

ガイドは1つ以上のトラックイベントに基づいて表示されます。これは、プロセス完了後にガイドを表示したり、ユーザーが特定のサーバー応答を受け取った際にトラブルシューティングを行うのに理想的です。

トラックイベントを使用してガイドをアクティベートする方法は2つあります。

トラックイベントのアクティベーション：トラックイベントをアクティベーションタイプとして選択すると、直接トラックイベント設定ページに移動します。ガイドをリリースするには1つ以上のイベントを選択します。選択したイベントのいずれかが発生するとガイドが表示されます。複数のイベントを含めるにはORオプションを使用します。
トラックイベントプロパティのアクティベーション：プロパティベースのロジックを使用して、ガイドが表示されるタイミングを定義します。プロパティの種類、演算子、値を選択します。複数のプロパティ条件を含めるにはORオプションを使用します。

詳細については、トラックイベントを参照してください。

ガイドからガイドを起動する

他のガイドからガイドを起動するには、特定のアクティベーション方法を設定する必要はなく、すべてのアクティベーション方法を未選択のままにしておきます。またこのオプションは、他のアクティベーション方法と組み合わせることができます。

ステップ5. デバイスでガイドをテストする

ビジュアルデザインスタジオが提供するのはガイドの「ウェブプレビュー」に過ぎないため、公開前に必ず実際のモバイルデバイスでガイドの見え方をテストすることが非常に重要です。

ガイドをテストするには、［テスト（Test）］を選択します。

注：デバイスが接続されていない場合は、デバイスを接続する必要があります。詳細については、「モバイルデバイスの接続」をご参照ください。

テスト中、Pendoはセグメントとスロットルルールを無視し、毎回ガイドを表示します。ガイドで指定されたターゲット要素、ページ、アクティベーション方法は、このプレビュー方法に対して設定されている必要があります。

注：モバイルガイドには、ガイドをテストする際のステージング環境の概念はありません。模擬ライブシナリオでガイドをテストしたい場合は、テストに使用している現在の訪問者IDにガイドをセグメント化することができます。詳細については、「セグメント」を参照してください。

ガイドの作業が終わったら、右上の［保存（Save）］ボタンで変更内容を保存し、［終了（Exit）］を選択してデザイナーを終了するか、［保存］の横にある下向きアイコンを選択して［保存して終了（Save and Exit）］を選択します。

ステップ6. ガイドのセグメントとスケジュール

ガイドに問題がなければ、ガイドの詳細ページに移動して、ガイドのセグメントとスケジュールを調整します。

ガイドを受け取る訪問者のセグメントを選択します。デフォルトのセグメントは［全員（Everyone）］です。選択したセグメントに含まれているユーザーの数と、対象となる訪問者の数を確認できます。
ガイドがいつ公開されるか（必要であれば、いつ公開を停止するか）をスケジュールします。

対象となる訪問者の数がセグメントよりも少ないことがあります。この要因としては、ユーザーの中に旧バージョンのアプリとSDKを継続して使っている人がいることが考えられます。この場合、これらのユーザーはPendoの新機能を利用できない可能性があります。

重要：ガイドセグメントには、セグメントで明示的に除外されていない限り、アナリティクスから除外された訪問者が含まれます。

ステップ7. ガイドを公開して検証する

ガイドを公開するには、ガイドのステータスを［公開（Public）］にします。モバイルには「ステージング」オプションがないため、モバイルデバイスでフロー全体をテストせずにモバイルガイドを公開しないようにしてください。もしお客様が当該ガイドのセグメント対象であり、公開した後にご自身のデバイスでガイドを確認したい場合は、以下の操作を行います。

Pendoとお使いのデバイスとの接続を解除します。具体的には、デバイスで［Pendo FAB］を選択し、［ペアリングモードを終了（Exit Pairing Mode）］を選択します。
アプリを閉じて再起動します（ガイドは「セッション」の開始時にデバイスに送信されます）。
ガイドのセグメントに含まれている場合は、ガイドの「アクティベーション（activation）」基準をトリガーすることで、アプリでガイドを表示できます。
「毎回表示する（show every time）」に設定されていない限り、ユーザーが一度ガイドを表示した後に、再度表示されることはありません。

ヒント：広範なユーザーセグメントにガイドを公開する前に、小規模な「テストグループ（test group）」に公開することをお勧めします。チームのユーザーのテストセグメントを作成し（訪問者IDまたはアカウントIDを使用）、このテストセグメントにガイドを公開することができます。結果に問題がなければ、より幅広いユーザーベースに向けてガイドを公開します。

簡易エディターで既存のガイドを編集する

ガイドの詳細ページで［Pendoで編集］を選択すると、簡易エディターで既存のガイドを更新できます。

このエディターでは、次のことができます。

ガイド内のテキストを直接選択して、テキストとボタンの内容を編集します。
表示される矢印アイコンを選択して、最近のテキスト変更を元に戻します。このオプションは、フォーカスを移動すると消えます。
ガイドステップの下にある+アイコンを選択して新しいステップを追加し、その後レイアウトを適用します。
ステップの上にマウスを移動し、関連するアイコンを選択して、ステップを複製または削除します。
右上隅の［テーマ］ドロップダウンを選択して、ガイドのテーマを更新します。

完了したら、ページの右上隅にある［ガイドを保存］を選択して変更を適用します。

注：サブスクリプションでGuides ProとAIによるガイド作成をオンにしている場合、Guides AIエージェントがエディターの左側に表示されます。自然言語を用いて、テキストの変更を提案したり、トーンを調整したり、その他の編集を行うことができます。詳細については、「会話型AIを使用してガイドを作成する」を参照してください。

スタイリング、アクティベーション、ターゲティングなどの高度なガイド設定を行うには、ガイドの詳細ページで［自分のアプリで編集］を選択し、ビジュアルデザインスタジオを開きます。

よくある質問

ガイドが公開された後でも表示されないのはなぜですか？

ガイドのアクティベーションタイプに関係なく、アプリケーションは、ガイドペイロードにそのガイドが含まれている場合にのみ、エンドユーザーが新しいガイドの対象となるかどうかを判断できます。ペイロードが更新されるのは、次のいずれかが発生したときのみです。

startSessionが呼び出された場合。
アプリケーションが30分（デフォルト）以上バックグラウンドで動作した場合。この時間はアプリごとに設定できます。デフォルト設定の変更をご希望の場合は、当社のサポートチームにお問い合わせください。

このように、startSessionは通常、アプリを閉じて再び開くときに呼び出されます（ただし、いつ呼び出されるかは開発者が決めるので、お使いのアプリでは当てはまらないかもしれません）。アプリを閉じて再度開き、新しく公開したガイドをアクティブ化してみることをお勧めします。これが機能しない場合は、開発者に連絡してstartSessionがいつ呼び出されるかを明確にするか、サポートチームに問い合わせる必要があります。

テストデバイスと本番環境の両方で同じAPIキーを使用する必要がありますか？

必須ではありませんが、将来のリリースをテストする場合を除いて、全く同じ顧客体験を再現することをお勧めします。モバイルアプリは、（Pendoで別の開発アプリケーションを作成しない限り）テストと本番環境で同じAPIキーを使用し、同じAPIキーを使用した場合に収集されるデータに違いはありません。これは、アナリティクスに影響を与える可能性があります。ただし、除外リストを利用して、アナリティクスから自分のデータをフィルタリングするオプションがあります。開発環境と本番環境のそれぞれにAPIキーが必要な場合は、Pendoのアカウント担当者にお問い合わせください。

IPアドレスだけでモバイルガイドをテストできますか？

現在、これを行うためのネイティブな解決策はありません。ユーザーを開発アプリのバージョンにセグメント化するテストセグメントを作成することができます。

ガイドが閉じられ、再表示の対象ではなくなったとみなされるのは、どのような場合ですか？

場合によっては、ユーザーがAndroidデバイスでホームボタンを押すか、iOSデバイスで上にスワイプするかIDボタンにタッチして、スマートフォンのバックグラウンドでアプリを実行していることがあります。この時、ガイドが表示されても終了せず、アプリリリース時に再表示されることが期待されます。閉じるアクションのボタンを選択する、角にある［x］ボタンを選択する、ガイドの最後のステップを完了する、またはアプリを終了すると、ガイドは閉じられたと見なされます（再び表示されることはありません）。

注：Androidデバイスで［戻る（Back）］ボタンを選択すると、ポップアップガイドが閉じます。