How Can We Help?

Pendo Mobile: React Native Codeless Support (Closed Beta)

Important: This feature is available with SDK 2.5 or higher. 

Overview

Mobile apps created with the React Native framework can use Pendo SDK.

Depending on your React Native version and navigation library version, you might be eligible for our codeless beta.

This beta includes all of Pendo goodness just like any native mobile application: codeless analytics (which work retroactively to the time the SDK was installed) and all mobile guide types including tooltips and walkthroughs.

You will not need to instrument code events, but your track events will continue working.

If you are not eligible for this, we can offer a track-event based solution at the moment. We are working on enabling codeless analytics for more configurations in the next few months.

Pre-Requisites

  • React Native applications built over React Native version 0.6 and above
  • React Native applications using the"React Native Navigation" library version 6.x.
  • Your subscription should be enabled for mobile V2. To enable your subscription, please contact your Customer Success Manager or Account Executive.

Check with your developers which React Native configuration your apps use.

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. 

How to install

  1. Create iOS and Android apps by choosing 'React Native' app type.image2020-1-7_4-47-11.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.
  4. Once the apps are integrated with the Pendo SDKs, you can start tagging pages and creating guides for each of your applications. 
    Screen_Shot_2020-02-26_at_8.33.46.png

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",...})

What if I am not eligible for this beta?

We are now working to enable Codeless support for React Native v0.6 for applications using the "react-navigation" library version 5.x.

This release (planned as beta) will allow you to get codeless analytics (which work retroactively to the time the SDK was installed) and all mobile guide types including tooltips and walkthroughs. You will no longer need to instrument code events.

Note that if you start with the SDK supporting track events, these events will continue working with the SDK supporting codeless analytics, so you will have continuity of analytics and guides.

We also plan to add in the future the option to activate guides by track events. At any place in the app where you send a track event, you'll be able to set up that a guide will show

Frequently Asked Questions

How do I join the beta?

If you are eligible and want to join the beta, please contact your Customer Success Manager.

 

Related articles