Pendo Mobile & React Native (Track Events solution)

Important: This feature is available with SDK 2.3.2 or higher

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 & walkthroughs.

Overview of our Track Events solution

Mobile apps created with the React Native framework can use the Pendo SDK and will 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

Pre-Requisites

Your subscription should be enabled for mobile V2. To enable your subscription, please contact your Customer Success Manager or Account Executive.

To check if your subscription is enabled for mobile: Under the 'Subscription Settings' page, you should see an "Add App" button. Clicking it will 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

  1. Create iOS and Android apps by choosing 'React Native' app type.
    mceclip2.png
  2. You will be forwarded to the install settings tab of the iOS app. Follow them to install the SDK into your Javascript React Native code and to integrate the SDK into your iOS application.
  3. Note that 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.
    mceclip3.png

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? 

switchVisitor:  use this API to update the current visitor ID and data associated with it (Account ID, Visitor Data and Account data). Mainly used on "Login" activity

 PendoSDK.switchVisitor("NEW_VISITOR_ID", "NEW_ACCOUNT_ID", {"NEW_VISITOR_KEY":"NEW_VISITOR_VALUE",...},{"NEW_ACCOUNT_KEY":"NEW_ACCOUNT_VALUE",...})}}

clearVisitor: use this API to end the current visitor's session, and start a new session without associating it to a visitor ID. Mainly used on "Logout" activity

PendoSDK.clearVisitor()
setVisitorData:  Use this API to update the visitor's data mid-session. Mainly used when the visitor updates details.
PendoSDK.setVisitorData({"KEY1":"VALUE1","KEY2":"VALUE2",...})
setAccountData: Use this API to update Account data mid-session. Mainly used when you want to update the accounts data.
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.