React Native: Track Your First Event and Read the Data

Overview

With the AppAmbit SDK already installed, tracking a custom event in React Native is one line — the part that matters is what you do with it next. This is the core analytics loop: fire an event, then read what it tells you on the dashboard.

What You'll Learn

• Calling AppAmbit.trackEvent from a React Native app
• Passing custom properties along with an event
• Where a tracked event shows up in the AppAmbit dashboard
• Reading event data back as something you can act on

Prerequisites

Before you begin, make sure you have:

1. A React Native app with the AppAmbit SDK already installed and initialized (SDK setup guide if you haven't yet — this video doesn't cover installation)
2. An AppAmbit account (sign up for free)
3. Your app running on a device or simulator

Track a Custom Event

With the SDK already initialized via AppAmbit.start("<YOUR-APPKEY>");, tracking an event is a single call to AppAmbit.trackEvent:

import AppAmbit from 'appambit';

AppAmbit.trackEvent('purchase', {
  plan: 'pro',
  price: 29.99,
});

The first argument is the event name; the second is an object of custom properties — any key/value pairs relevant to that action.

Read It on the Dashboard

Back in AppAmbit, open the app's Events tab. The event you just fired shows up with its name, occurrence count, and the custom properties you passed — plan and price in this case. From here you can filter by property, see it break down by app version or device, and start building a picture of what users are actually doing, not just that they opened the app.

Next Steps

After this tutorial, check out:

• Advanced Analytics Guide