Adopture Docs
Getting Started

Verify Events

Confirm your SDK integration is working by checking the Realtime view.

After installing the SDK, the next step is to verify that events are flowing correctly from your app to the Adopture dashboard.

Check the Realtime View

  1. Open your app on a physical device or emulator.
  2. Navigate to the Realtime tab in the Adopture dashboard.
  3. You should see events appearing within seconds.

What to Look For

Once your app is running with the SDK initialized, you should see the following events:

  • session_start — Tracked automatically when the app launches (if autoCapture is enabled, which it is by default).
  • Screen events — If you've set up a navigation observer, screen view events will appear as you navigate through your app.
  • Custom events — Any events you've added via Adopture.track() will show up here as well.

Troubleshooting

If no events appear within 30 seconds, work through these checks:

Verify Your App Key

Make sure the App Key you passed to Adopture.init() matches the one shown in your app's settings on the dashboard. A mismatched key means events are silently discarded.

Enable Debug Mode

Initialize the SDK with debug mode to see detailed logging in your console:

await Adopture.init(
  appKey: 'ak_your_app_key_here',
  debug: true,
);

In debug mode, the SDK prints each event as it is queued and sent, along with any errors it encounters.

Check Network Connectivity

Ensure your device or emulator has an active internet connection. The SDK sends events to api.adopture.com over HTTPS. If you're behind a corporate firewall or proxy, make sure this domain is reachable.

Confirm Initialization Order

The SDK must be initialized before you track any events. If you call Adopture.track() before Adopture.init() completes, those events will be dropped. Make sure init is awaited before any tracking calls:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Adopture.init(appKey: 'ak_your_app_key_here');
  runApp(const MyApp());
}

Next Steps

Once you see events appearing in the Realtime view, your integration is complete. From here you can:

On this page