概要
ガイドを公開する前に、ガイドをプレビューしてテストすることを強くお勧めします。方法については、以下の手順に従ってください。
要件
Visual Design Studioを使用するには、Pendoユーザーは以下の2つの権限のいずれかが必要です。
- Pendo管理者権限
- 最低でも以下を実施できるPendoユーザー権限
- レイアウトからガイドを作成する
- 公開されたガイドを管理する
- ガイドとレイアウトを最初から作成する
ガイドの作成
モバイルガイドの作成を開始するには、モバイルアプリケーションがSDK 2.xと統合されていることを確認してください。確認するには、[サブスクリプション設定（Subscription Settings）] に移動すると、統合されたアプリに [統合済み（Integrated）] ラベルが表示されているはずです。
アプリはV2 SDKと統合されています
左側のナビゲーションメニューから[ガイド（Guides）]を選択し、右上の[Visual Design Studio]ボタンのドロップダウンから[新しいガイドの作成（Create New Guide）]を選択します。
新しいガイドの作成
ドロップダウンメニューから該当するモバイルアプリを選択します。
利用可能なモバイルレイアウトテンプレートを選択し、ガイドの名前を変更します。
ガイド内容のカスタマイズ
[自分のアプリで管理する（Manage in My App）]をクリックしてVisual Design Studioを開き、ガイドを編集します。
自分のアプリで管理する
ヒント：ガイドのプレビューにカーソルを合わせると、[自分のアプリで管理する（Manage in My App）]オプションが表示され、ビジュアルデザイナーが起動します。
ガイドの編集は、[コンテナの編集（Edit Container）]ボックス内で行うことができます。コンテナのデフォルト設定は、アプリのテーマによって設定されます。コンテナの設定を編集するには、[テーマ（Theme）]を[カスタム（Custom）]に変更します。
コンテナの設定を編集
最初の編集が完了したら、[適用（Apply）]をクリックします。次に、ガイドのプレビュー内のプレースホルダー項目にカーソルを合わせ、クリックして編集します。新しいビルディングブロックをガイドに追加するには、アイテムの間にカーソルを置くと青い線が表示されるので、「プラス」記号をクリックして、希望するビルディングブロックを追加してください。
ガイドにビルディングブロックを追加する
ガイドのトランジションアニメーションを選択する
ガイドが各ステップに遷移する方法を選択します。これを変更するには、[コンテナの編集（Edit Container）] > [遷移（Transitions）] > [アニメーションタイプ（Animation Type）]に移動し、必要に応じて[アニメーションタイプ（Animation Type）]、[期間（Duration）]、[方向（Direction）]を選択します。
スライドアニメーションの例
ガイドのプレビュー
「デバイスでのガイドのプレビュー（Preview Guide On Device）」を使用して、ガイドがモバイルデバイスでどのように表示されるかを確認します。デバイスを接続するように指示され、ガイドがデバイスに表示されます。
ビジュアルデザイナーはガイドの「ウェブプレビュー」に過ぎないため、公開前に実際のモバイルデバイスでガイドがどのように見えるかをテストすることが非常に重要です。
実機またはエミュレーターでガイドをプレビューする
ガイドのアクティベーション方法
ガイドをどのようにアクティベートするかを選択します。利用可能なアクティベーションオプションは、アクションバー > [アクティベーション設定（Activation Settings）]で確認できます。
- アプリの起動（App Launch）：アプリ起動時にアクティベーションします。
- ページビュー（Page View）：ユーザーが定義したページのいずれかを表示したときにアクティベーションします。
- ターゲット要素（Target Element）：定義したフィーチャーをユーザーがクリックしたときにアクティベーションします。
- トラックイベント（Track Event）：定義したトラックイベントが呼び出されたときにアクティベーションします（SDK 2.7以降）。
- ガイドからガイドを起動（Launch Guide From Guide）：他のガイド（SDK 2.10以降）からガイドを起動するために、特定のアクティベーション方法を設定する必要はありません（すべてのアクティベーション方法を選択しないでおくことができます）。このオプションは、他のアクティベーション方法と組み合わせることもできます。
モバイルガイドのアクティベーションタイプを選択
アプリの起動（App Launch） - startSessionメソッドが呼び出され、モバイルセッションが開始されると同時に、セグメントされた訪問者にガイドが開始されます。
一般的なユースケース：
- アプリの新しいバージョンで「新機能」を表示する
- 新しいユーザーのオンボーディングを開始する
- バージョンの廃止
ページビュー（Page View） - ガイドが表示されるアプリ内のページを選択します。すでにタグ付けされているページを選択するか、「新しいページをタグ付け（Tag New Page）」ボタンをクリックして新しいページをタグ付けします。この場合、新しいページをキャプチャーするためには、デバイスを接続する必要があります（デバイスを接続）。複数のページを選択した場合、いずれかのページを最初に見たときにガイドが起動します。
すでにタグ付けされているモバイルページを選択してガイドをアクティベーションするか、新しいページをタグ付けします
一般的なユースケース：
- 新規訪問者にアプリ内の特定のセクションを案内する
- 特定のアプリ画面がメンテナンス中であることを訪問者に通知する
ターゲット要素（Target Element） - 目的のページを選択した後、スクリーンショットでガイドをクリックしてアクティブにする要素を選択します。
ターゲットモード - 要素を選択する
一般的なユースケース：
- コンテキストヘルプを表示するためにアプリにヘルプボタンを追加する、表示頻度を毎回設定する。
- 特定のフィーチャーのオンボーディングをする
トラックイベント（Track Event）：このようにガイドのトリガーとして使用するトラックイベントを選択します。トラックイベントが呼び出されると、セグメント化された訪問者にガイドが表示されます。
- これにより、プロセスの完了やサーバーの応答の際など、いつでもどこでも好きな時にガイドを起動できるようになります。
デバイス上のテストガイド
選択したアクティベーションが期待どおりに動作しているかどうかを確認するには、「デバイスでのガイドのプレビュー（Preview Guide On Device）」をご利用ください。
ガイドの作業が終わったら、左上の [保存（Save）]ボタンで変更内容を保存し、[終了（Exit）]をクリックしてデザイナーを終了します。
ガイドのセグメント化とスケジュール
ガイドに問題がなければ、ガイドの詳細ページに移動して、ガイドのセグメントとスケジュールを調整します。
- ガイドを受け取るユーザーのセグメントを選択します。デフォルトのセグメントは「全員（Everyone）」です。選択したセグメントに含まれているユーザーの数と、対象となる訪問者の数を確認できます。
- ガイドがいつ公開されるか（必要であれば、いつ公開を停止するか）をスケジュールします。
- 対象となる訪問者：対象となる訪問者の数がセグメントよりも少ないことがあります。これは、ユーザーの中に、まだアプリの古いバージョンとSDKの古いバージョンを使っている人がいる可能性があるためです。この場合、これらのユーザーはPendoの新機能をまだ利用できないことがあります。
ガイドの公開と検証
ガイドを公開するには、ガイドのステータスを [公開（Public）]に更新します。モバイルには「ステージング」オプションがないため、モバイルデバイスでフロー全体をテストせずにモバイルガイドを公開しないでください。
- デバイスをPendoから切断します（デバイスのPendo FABをクリックし、[切断（Disconnect）] -> [完全に切断（Permanently Disconnect）]を選択します）
- アプリを閉じて再起動します（ガイドは「セッション」の開始時にデバイスに送信されます）。
- ガイドのセグメントに含まれている場合は、ガイドの「アクティベーション」基準をトリガーすることで、アプリでガイドを表示できます。
- ユーザーがガイドを見ると、二度と表示されなくなることに注意してください。