Note: Check if your app is eligible for our Codeless React Native. Our codeless solution includes all Pendo mobile features supported on native mobile applications: Codeless analytics (which work retroactively to the time the SDK was installed) and all mobile guide types including tooltips and walkthroughs.
Mobile apps created with the React Native framework can use the Pendo SDK to allow you to:
- Collect & analyze usage through ‘Track Events’.
- Create & publish single and multi-step lightbox Guides that are activated when users launch your app or with a track event.
Prerequisites
Your subscription must be enabled for mobile. Check in the Subscription Settings page that there is an Add App button. Select it to show mobile app options.
Available Insights
The following analytics will work for React Native apps using this Track Events solution:
- Track events analytics (under the specific 'Track Events' page: view users and accounts analytics, usage totals and over-time usage)
- Paths & funnels (via track events)
- Data Explorer, Trends (via track events)
- Retention analytics (via track events)
- Visitors and accounts analytics
- Time on application (based on your track events)
- Any dashboard widget that does not relate to page views/button clicks
- Use track event analytics in any Segment you create, for guides or analytics purposes
How to install
- Create iOS and Android apps by choosing 'React Native' app type.
You will be forwarded to the install settings tab of the iOS app. - Follow the instructions to install the SDK into your Javascript React Native code and to integrate the SDK into your iOS application.
Note: In Pendo, two applications will be created under the 'Subscription Setting' page (one for iOS and one for Android). After integrating the iOS SDK, follow the install settings of the Android app in order to integrate the Android SDK into your Android app.
How to track my pages and features?
track: use this API to trace page views and feature clicks and any other significant event in your app. Attach the following call to the screen/feature activity:
PendoSDK.track("EVENT_NAME",{'KEY1':'VALUE1','KEY2':'VALUE2',...})}}
For example, use this to track a feature "submit" click on "order_form" page:
<ListItem
...
onPress={() => {PendoSDK.track(data.name,{'page':'order_form','feature':'submit'})}}>
How to track my visitors and accounts?
PendoSDK.startSession(visitorId, accountId, visitorData, accountData);
PendoSDK.setVisitorData({"KEY1":"VALUE1","KEY2":"VALUE2",...})
PendoSDK.setAccountData({"KEY1":"VALUE1","KEY2":"VALUE2",...})
Frequently Asked Questions
Which guides can I use?
Guide Type: React Native applications can use mobile guides and polls. Tooltips are currently not available for React Native applications.
Guide Activation: You can show guides in your React Native app upon Application launch or when the app triggers a track event. Select App Launch or Track Event as the activation method for your guides. It's recommended to add track events to your app at places where you might want to trigger guides.
What should I report as events?
You can use 'track events' to report on any event happening in your app. A change of a user's status, an exception condition such as 'Server not available', any important business transaction or any action performed by your user, and any button click or page view that you want to collect analytics on.
How do I track my page views and button clicks?
Automatic tracking of pages and features is currently not supported for React Native apps, due to their unique structure. Capturing pages in your React Native application and tagging features will not work.
To get analytics on page view and button clicks, you will need to send a track event for each.
Coming soon: We are working on supporting codeless tracking of Page views and Features in React Native applications.