Connecting a mobile device is used for tagging mobile pages and features, as well as testing your guides on a mobile device before publishing them.
How do I connect?
A device can be connected via the "Connect a new device" button either when:
Tagging Mobile Pages or Creating a mobile guide, either for guide preview or when selecting the guide's activation.
The "Connect a new device" button will be prompt 2 options to connect:
- Scan the QR code
- Copy/Paste a URL in your device browser
Scanning the QR code can usually be done with the device's camera, or with a QR scanner dedicated application on your device.
Connect your device
What happens when I’m connected?
Once connected small Pendo icon will appear hovering over your app (the icon can be moved in case it's hovering over an important part of your app.)
While your device is connected to Pendo, you can “Preview on device” and “Test full flow on device” to see guides before they are published regardless of the guide’s segment or throttling. You can also capture pages to tag pages and features.
Once connected, your device stays connected to Pendo until you disconnect it. If you close and open the app on your device, it will immediately re-connect.
How do I disconnect?
To disconnect from Pendo, click the Pendo pink icon and select from:
- Permanently Disconnect- you will need to re-scan the QR code on your device the next time you want to connect your device.
- Disconnect from this session - will disconnect the current session and re-connect the next time the app is launched.
Troubleshooting
I Scanned the QR Code and Nothing Happened
If the application does not launch after scanning the QR code, check with the application developer to ensure that the URL scheme is correct. Alternatively, check with your network admin that WebSockets are not blocked.
If the application launched, but you don’t see the Pendo pink icon, verify with the application developer that the application version, which is installed on your device, has the Pendo SDK integrated.
Safari Triggered an Error Message Saying Safari cannot open the page because the address is invalid
Scenarios that resulted in this issue are:
- Scheme id not added / incorrect
- DNS restricts site and requires to add to whitelist
- The SDK was not installed correctly