Connecting a mobile device is used for verifying Pendo’s installation, 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.
- Verifying installation to validate Pendo is integrated correctly.
There are two options to connect a new device:
- Scan the QR code
- Copy/paste a URL into your device browser
Scanning the QR code can usually be done with the device's camera or with a dedicated QR scanner application on 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 view the step design and test the full guide with the selected activation method 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 immediately re-connects.
How do I disconnect?
To disconnect from Pendo, click the Pendo pink icon and select Exit Pairing Mode. You must re-scan the QR code on your device the next time you want to connect your device.
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
The error message states that Safari cannot open the page because the address is invalid.
Possible causes of this are:
- Scheme ID has not been added or is incorrect
- DNS is restricting the site, and it must be added to the whitelist
- SDK is not installed correctly