Quickstart

Get AppDNA running in your app in five steps. By the end, you will have the SDK installed, configured with your API key, a user identified, and your first event flowing into the dashboard.

API keys are found in Console → Settings → SDK → API Keys. Production keys start with adn_live_, sandbox keys with adn_test_.

Step 1: Install the SDK

iOS
Android
Flutter
React Native

Add the AppDNA SDK via Swift Package Manager:

In Xcode, go to File → Add Package Dependencies…
Enter the repository URL:

https://github.com/appdna-ai/appdna-sdk-ios.git

Select the package AppDNASDK and add it to your target.

Requirements: iOS 16+, Swift 5.9+

Add the dependency to your module-level build.gradle:

dependencies {
    implementation("ai.appdna:sdk:1.0.12")
}

Make sure mavenCentral() is in your project-level repositories.Requirements: Android SDK 24+ (Android 7.0), Kotlin 1.9+

Add the package to your pubspec.yaml:

dependencies:
  appdna_sdk: ^1.0.12

Then run:

flutter pub get

Requirements: Dart 3.0+, Flutter 3.10+

Install via npm or yarn:

npm install @appdna-ai/react-native-sdk

For iOS, install the native pods:

cd ios && pod install

Requirements: React Native 0.72+, iOS 16+, Android SDK 24+

Step 2: Configure the SDK

Initialize AppDNA as early as possible in your app’s lifecycle — ideally in your app delegate, application class, or root component.

iOS
Android
Flutter
React Native

import AppDNASDK

// In your AppDelegate or App init
AppDNA.configure(
    apiKey: "adn_live_xxx",
    environment: .production,
    options: AppDNAOptions(logLevel: .debug)
)

import ai.appdna.sdk.AppDNA
import ai.appdna.sdk.Environment
import ai.appdna.sdk.AppDNAOptions
import ai.appdna.sdk.LogLevel

// In your Application.onCreate()
AppDNA.configure(
    context = this,
    apiKey = "adn_live_xxx",
    environment = Environment.PRODUCTION,
    options = AppDNAOptions(logLevel = LogLevel.DEBUG)
)

import 'package:appdna_sdk/appdna_sdk.dart';

// In your main() or initState
await AppDNA.configure(
  "adn_live_xxx",
  environment: AppDNAEnvironment.production,
  options: AppDNAOptions(logLevel: AppDNALogLevel.debug),
);

import { AppDNA } from '@appdna-ai/react-native-sdk';

// In your App component or index.js
await AppDNA.configure("adn_live_xxx", "production", {
  logLevel: "debug",
});

Replace adn_live_xxx with your actual API key. Use adn_test_ keys during development to send events to the sandbox environment at sandbox-api.appdna.ai.

Step 3: Identify the User

Once your user signs in (or you have a stable user identifier), call identify to link events to that user. You can also pass traits that AppDNA uses for segmentation and experiment targeting.

iOS
Android
Flutter
React Native

AppDNA.identify(
    userId: "user-123",
    traits: ["plan": "premium"]
)

AppDNA.identify(
    userId = "user-123",
    traits = mapOf("plan" to "premium")
)

await AppDNA.identify(
  "user-123",
  traits: {"plan": "premium"},
);

await AppDNA.identify("user-123", {
  plan: "premium",
});

Before identify is called, the SDK generates an anonymous ID on first launch. Events are tracked against this anonymous ID and automatically linked when you call identify.

Step 4: Track Your First Event

Send a custom event with properties. These events flow into AppDNA analytics and can be used as experiment goals, retention triggers, and webhook payloads.

iOS
Android
Flutter
React Native

AppDNA.track(
    event: "workout_completed",
    properties: ["duration": 45]
)

AppDNA.track(
    event = "workout_completed",
    properties = mapOf("duration" to 45)
)

await AppDNA.track(
  "workout_completed",
  properties: {"duration": 45},
);

await AppDNA.track("workout_completed", {
  duration: 45,
});

Step 5: Verify in the Dashboard

Open the Event Debugger in console.appdna.ai to confirm your events are arriving:

Navigate to Console → Events → Debugger.
Select your app and environment.
You should see workout_completed appear within a few seconds.

If you see your event in the debugger, you are all set. The SDK is installed, configured, and sending data to AppDNA.

What’s Next?

Core Concepts

Learn about offline-first design, config bundles, experiment bucketing, and more.

Paywalls

Design and deploy server-driven paywalls without app updates.

Experiments

Run A/B tests with deterministic, cross-platform bucketing.

Push Notifications

Send targeted push campaigns and automated retention journeys.

Getting Started

​Quickstart

​Step 1: Install the SDK

​Step 2: Configure the SDK

​Step 3: Identify the User

​Step 4: Track Your First Event

​Step 5: Verify in the Dashboard

​What’s Next?

Core Concepts

Paywalls

Experiments

Push Notifications

Quickstart

Step 1: Install the SDK

Step 2: Configure the SDK

Step 3: Identify the User

Step 4: Track Your First Event

Step 5: Verify in the Dashboard

What’s Next?