Implement Observer mode in React Native SDK

If you already have your own purchase infrastructure and aren’t ready to fully switch to Adapty, you can explore Observer mode. In its basic form, Observer Mode offers advanced analytics and seamless integration with attribution and analytics systems.

If this meets your needs, you only need to:

Turn it on when configuring the Adapty SDK by setting the observerMode parameter to true. Follow the setup instructions for React Native.
Report transactions from your existing purchase infrastructure to Adapty.

Tip

In SDK v4, you can also present Adapty-rendered flows and paywalls in Observer mode: set the onObserverPurchaseInitiated and onObserverRestoreInitiated event handlers to perform the purchase or restore with your own code when a user taps the corresponding button. See Present flows in Observer mode.

Observer mode setup

Turn on the Observer mode if you handle purchases and subscription status yourself and use Adapty only for sending subscription events and analytics.

Important

When running in the Observer mode, Adapty SDK won’t close any transactions, so make sure you’re handling it.

import { adapty } from 'react-native-adapty';

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  observerMode: true, // Enable observer mode
});

Parameters:

Parameter	Description
observerMode	A boolean value that controls Observer mode. The default value is `false`.

Using Adapty flows & paywalls in Observer Mode

If you also want to use Adapty’s flows, paywalls, and A/B testing features, you can — but it requires some extra setup in Observer mode. Here’s what you’ll need to do in addition to the steps above:

Display remote config paywalls as usual. For flows & paywalls built in the Flow & Paywall Builder, see Present flows in Observer mode.
Associate flows & paywalls with purchase transactions.