Ometria React Native SDK

Ometria helps your marketing department understand and better engage with your customers by delivering personalised emails and push notifications.

Read the documentation »

The app has two key objectives:

• Getting information about customers (what do they like?)
• Reaching out to customers (saying the right thing to the right people)

For your mobile app, this means:

• Tracking customer behaviour through events. A subset of events is automatically handled by the Ometria SDK, but you have to customize it to your needs. See the event tracking plan
• Sending and displaying push notifications, which requires app developer integration

You can also look at the sample apps we have included for reference implementations. See example-expo

Before you begin, visit the Ometria help centre and follow the steps there to get an API key. Get an API key

Quick start

The recommended setup for new projects is Expo with the New Architecture.

1. Install the package

pnpm add react-native-ometria
# or
yarn add react-native-ometria
# or
npm install react-native-ometria

2. Add the Ometria and Firebase plugins to your app.json / app.config.ts

{
  "expo": {
    "plugins": [
      ["react-native-ometria"],
      "@react-native-firebase/app",
      "@react-native-firebase/messaging",
      [
        "expo-build-properties",
        {
          "ios": {
            "useFrameworks": "static",
            "forceStaticLinking": ["RNFBApp", "RNFBMessaging"]
          }
        }
      ]
    ]
  }
}

3. Start using the SDK

import Ometria from 'react-native-ometria';

...

Ometria.initializeWithApiToken('YOUR_API_KEY').then(() => {
  Ometria.trackProfileIdentifiedByEmailEvent('user@example.com');
});

Documentation

• Installation - Detailed installation guide including bare React Native setup
• Event Tracking - Track customer behaviour
• Push Notifications - Set up Firebase and push notifications
• Deep Linking - Handle app links from emails