ガイドを公開する前に、SDKのインストールを確認するためにモバイルデバイスを接続し、タグ付けするモバイルページやフィーチャーをキャプチャし、本番環境のモバイルデバイスでテストする必要があります。Pendoでは、ペアリングプロセスを通じてAndroidやiOSのデバイスまたはシミュレーターを接続できます。
モバイルデバイスを接続する
新しいデバイスを接続するには、以下の2つの方法があります。デバイスのカメラまたはデバイス専用のQRスキャナーアプリでQRコードをスキャンします。
専用のテストデバイスまたはシミュレーターを使用する場合は、URLをブラウザにコピーしてデバイスを接続します。ペアリングディープリンクをデバイスのブラウザで開くと、ページをアプリで開くよう求めるプロンプトが表示されます。
デバイスが接続されると、タグ付けモードになりアプリ上に小さなPendoアイコンが表示されます。ドラッグアンドドロップでカメラアイコンを移動できます。
デバイスがPendoに接続されている間は、ガイドのセグメントやスロットルに関係なく、ステップのデザインを表示し、選択したアクティベーション方法でガイド全体をテストして、公開前にガイドを確認することができます。また、ページを収集してページやフィーチャーをタグ付けすることもできます。
ボタンは実行中のタスクに応じて変化します。
| ボタン | タスク |
| ペアリングモード（接続、検証、デバッグ）。デバイスはPendoに接続されています。ペアリングされると、フローティングアクションボタンにシェブロンが表示されます。 | |
|
キャプチャモード。ページにタグを付けると、フローティングアクションボタンにカメラアイコンが表示されます。 カメラアイコンをタップすると、3秒間のカウントダウンが開始され、ページ構造とフィーチャーのスナップショットが取得されます。 |
|
|
ガイドテストモード。ペアリングして本番環境のデバイス上でガイドをテストすると、フローティングアクションボタンが目のアイコンに切り替わります。 ガイドがあるページに移動し、ガイドを表示およびテストするために設定したアクティベーションオプションを使用してガイドを有効化します。 |
一度デバイスが接続されると、切断するまでPendoに接続された状態を維持します。デバイスでアプリを閉じて開くと、すぐに再接続されます。
Pendoとの接続を解除する
Pendoとの接続を解除するには、Pendoのピンクのアイコンを選択して、［ペアリングモードを終了（Exit Pairing Mode）］を選択します。次にデバイスを接続する際には、デバイスのQRコードを再スキャンする必要があります。
デバイス接続のトラブルシューティング
QRコードをスキャンしてもアプリが起動しない
QRコードをスキャンしてもアプリケーションが起動しない場合は、URLスキームが正しいことをアプリケーション開発者に確認してください。もしくは、WebSocketがブロックされていないかどうかネットワーク管理者に確認してください。
アプリケーションが起動してもPendoのピンク色のアイコンが表示されない場合は、お使いのデバイスにインストールされているアプリのバージョンにPendo SDKが統合されていることを、アプリの開発者に確認してください。
ブラウザにエラーメッセージが表示される
［アドレスが無効なため、ブラウザでページを開くことができません（Safari cannot open the page because the address is invalid）］というエラーメッセージが表示されることがあります。
考えられる原因は次のとおりです。
- スキームIDが追加されていないか、間違っている
- DNSがサイトを制限しているため、許可リストへの登録が必要
- SDKが正しくインストールされていない
アプリを起動してもフローティングアクションボタンが表示されない
エンジニアがインストール手順を確認して、setup()が正しく呼び出されていることを確かめることを推奨します。