Use Case: Analytics, Push & Feedback

This guide covers the retention and measurement side of your app: tracking meaningful events, registering for push, measuring user sentiment with surveys, prompting for App Store reviews, and closing the feedback loop.

What You’ll Build

Track key events → Register for push → Handle push taps →
Measure love score (NPS/CSAT) → Ask for a store review at a high point → React to feedback

Step 1: Track Meaningful Events

Custom events power everything in AppDNA — analytics, experiment goals, survey triggers, in-app message triggers, and webhook payloads.

What to Track

Focus on events that represent meaningful user actions:

iOS
Android
Flutter
React Native

// Key user actions
AppDNA.track(event: "workout_completed", properties: [
    "duration_minutes": 45,
    "type": "strength",
    "calories": 320
])

// Engagement milestones
AppDNA.track(event: "streak_achieved", properties: [
    "streak_days": 7
])

// Feature usage
AppDNA.track(event: "recipe_saved", properties: [
    "recipe_id": "r-456",
    "category": "dinner"
])

// Goal changes
AppDNA.track(event: "goal_updated", properties: [
    "from": "lose_weight",
    "to": "build_muscle"
])

AppDNA.track(
    event = "workout_completed",
    properties = mapOf(
        "duration_minutes" to 45,
        "type" to "strength",
        "calories" to 320
    )
)

AppDNA.track(event = "streak_achieved", properties = mapOf("streak_days" to 7))

AppDNA.track(event = "recipe_saved", properties = mapOf(
    "recipe_id" to "r-456", "category" to "dinner"
))

await AppDNA.track("workout_completed", properties: {
  "duration_minutes": 45,
  "type": "strength",
  "calories": 320,
});

await AppDNA.track("streak_achieved", properties: {"streak_days": 7});

await AppDNA.track("recipe_saved", properties: {
  "recipe_id": "r-456",
  "category": "dinner",
});

await AppDNA.track("workout_completed", {
  duration_minutes: 45,
  type: "strength",
  calories: 320,
});

await AppDNA.track("streak_achieved", { streak_days: 7 });

await AppDNA.track("recipe_saved", {
  recipe_id: "r-456",
  category: "dinner",
});

Event Design Guidelines

Use snake_case for event names and property keys
Include relevant properties (duration, type, count, category)
Don’t duplicate auto-tracked events — the SDK already tracks session, onboarding, paywall, billing, push, and experiment events
Events automatically include session ID, device info, and active experiment exposures

Custom events can be used as experiment conversion goals, webhook triggers, in-app message triggers, and survey triggers — all configured in the Console with no code changes.

Step 2: Set Up Push Notifications

Register for Push

iOS
Android
Flutter
React Native

// Request permission and register token
let granted = await AppDNA.registerForPush()

// Set delegate for push callbacks
AppDNA.pushModule.setDelegate(self)

// If you handle token registration yourself:
func application(_ app: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken token: Data) {
    AppDNA.setPushToken(token)
}

// Request permission (Android 13+)
AppDNA.push.requestPermission(activity)

// Register FCM token
class MyFirebaseService : FirebaseMessagingService() {
    override fun onNewToken(token: String) {
        AppDNA.setPushToken(token)
    }
}

// Set delegate
AppDNA.push.setDelegate(this)

final granted = await AppDNA.push.requestPermission();
AppDNA.push.setDelegate(MyPushHandler());

const granted = await AppDNA.push.requestPermission();

Track Push Engagement

AppDNA pushes are tracked for you: the SDK records push_delivered and push_tapped (with the delivery id) for every push it handles — on iOS through its automatic notification handler, on Android through its messaging service and AppDNA.handlePushTap(intent), or your forwarding with AppDNA.push.handleMessage / handleTapData. Do not also track those pushes by hand, or they are counted twice. The manual calls below are only for pushes the SDK does not see (for example a push shown by another system), and they run in your app, not in a Notification Service Extension:

iOS
Android
Flutter
React Native

// Only for a push the SDK does not see (delivery)
AppDNA.trackPushDelivered(pushId: notification.pushId)

// In tap handler
AppDNA.trackPushTapped(pushId: notification.pushId, action: "open_workout")

AppDNA.trackPushDelivered(pushId = notification.pushId)
AppDNA.trackPushTapped(pushId = notification.pushId, action = "open_workout")

AppDNA.push.trackDelivered(notification.pushId);
AppDNA.push.trackTapped(notification.pushId, action: "open_workout");

AppDNA.push.trackDelivered(notification.push_id);
AppDNA.push.trackTapped(notification.push_id, "open_workout");

Handle Push Tap Callbacks

Route the user to the right screen when they tap a push notification:

iOS
Android
Flutter
React Native

class PushHandler: AppDNAPushDelegate {
    func onPushTapped(notification: PushPayload, actionId: String?) {
        guard let action = notification.action else { return }

        switch action.type {
        case "deep_link":
            navigate(to: action.value)
        case "screen":
            openScreen(action.value)
        default:
            break
        }
    }

    func onPushReceived(notification: PushPayload, inForeground: Bool) {
        if inForeground {
            showInAppBanner(title: notification.title, body: notification.body)
        }
    }
}

override fun onPushTapped(notification: PushPayload, actionId: String?) {
    notification.action?.let { action ->
        when (action.type) {
            "deep_link" -> navigate(action.value)
            "screen" -> openScreen(action.value)
        }
    }
}

@override
void onPushTapped(Map<String, dynamic> notification, String? actionId) {
  final value = notification["action_value"] as String?;
  if (value != null) {
    navigate(value);
  }
}

AppDNA.push.setDelegate({
  onPushTokenRegistered: (token) => {},
  onPushReceived: (notification, inForeground) => {},
  onPushTapped: (notification, actionId) => {
    if (notification.action_type === "deep_link") {
      navigate(notification.action_value as string);
    }
  },
});

Step 3: Measure Love Score with Surveys

Trigger-Based (Recommended)

Configure surveys in the Console to appear automatically based on events and conditions. For example:

NPS survey after 7 days of usage and 5+ sessions
CSAT survey after the user completes their 10th workout
Feedback prompt after a support interaction

No code needed for trigger-based surveys — they appear automatically.

Manual Trigger

For precise control over timing, present a survey manually:

iOS
Android
Flutter
React Native

// After a key moment (e.g., user completed their first goal)
AppDNA.surveys.present("nps_q1_2026")

AppDNA.surveys.present("nps_q1_2026")

await AppDNA.surveys.present("nps_q1_2026");

await AppDNA.surveys.present("nps_q1_2026");

Capture Survey Responses

Use the survey delegate to react to responses in real-time:

iOS
Android
Flutter
React Native

class FeedbackHandler: AppDNASurveyDelegate {
    func onSurveyCompleted(surveyId: String, responses: [SurveyResponse]) {
        // Each response is a SurveyResponse with a questionId + answer.
        // Look answers up by the question IDs configured in the Console.
        for response in responses {
            switch response.questionId {
            case "nps_question":
                if let score = response.answer as? Int {
                    handleNPSScore(score)
                }
            case "free_text_question":
                if let feedback = response.answer as? String {
                    logFeedback(feedback)
                }
            default:
                break
            }
        }
    }

    private func handleNPSScore(_ score: Int) {
        if score >= 9 {
            // Promoter -- show referral prompt
            showReferralPrompt()
        } else if score <= 6 {
            // Detractor -- show support link
            showSupportLink()
        }
        // Passives (7-8) -- no action
    }
}

AppDNA.surveys.setDelegate(FeedbackHandler())

AppDNA.surveys.setDelegate(object : AppDNASurveyDelegate {
    override fun onSurveyCompleted(surveyId: String, responses: List<SurveyResponse>) {
        val score = responses.firstOrNull { it.questionId == "nps_question" }?.answer as? Int ?: return

        when {
            score >= 9 -> showReferralPrompt()
            score <= 6 -> showSupportLink()
        }
    }
})

class FeedbackHandler extends AppDNASurveyDelegate {
  @override
  void onSurveyCompleted(String surveyId, List<Map<String, dynamic>> responses) {
    // Each entry is an answer map: {'questionId': String, 'answer': dynamic}.
    final nps = responses.firstWhere(
      (r) => r["questionId"] == "nps_question",
      orElse: () => {},
    );
    final score = (nps["answer"] as int?) ?? 0;

    if (score >= 9) showReferralPrompt();
    else if (score <= 6) showSupportLink();
  }
}

AppDNA.surveys.setDelegate(FeedbackHandler());

AppDNA.surveys.setDelegate({
  onSurveyPresented: (surveyId) => {},
  onSurveyDismissed: (surveyId) => {},
  onSurveyCompleted: (surveyId, responses) => {
    // `responses` is a list of { questionId, answer } maps.
    const nps = responses.find((r) => r.questionId === "nps_question");
    const score = (nps?.answer as number) ?? 0;

    if (score >= 9) showReferralPrompt();
    else if (score <= 6) showSupportLink();
  },
});

Step 4: Asking for a Store Review

Never ask how the user feels and then show the review dialog only to the ones who answered well. Apple’s App Store Review Guidelines and Google Play’s In-App Review policy both forbid it, and an app that does it risks rejection. The SDK will not do it: the two-step “Enjoying the app?” flow was removed, and the AppDNA Console refuses to generate an onboarding step that pairs a review request with a sentiment question.

Choosing when to ask is entirely allowed — the rule is about asking the user to declare a sentiment and branching on the answer, not about picking a good moment. Ask at a high point, and ask everyone who reaches it. There are exactly two shapes, and they are not interchangeable.

The OS review sheet, on a step the user has reached

Set Request store review on an onboarding step. The SDK asks the OS as the step appears. The step must be one the user leaves themselves: a step that advances on a timer walks out from under the sheet, and the Console refuses that combination. Nothing is reported back — neither store will say whether a prompt appeared, by design.

A button that opens the store listing

Give a button the rate_app action. It opens the app’s store page, where the user can write a review themselves. This is the only shape allowed on a tap: the OS sheet must never be requested in response to a button, which Apple names explicitly. A “Rate us” button wired to anything else asks for a review and then simply advances.

Rate-limited: the native store review dialog is requested at most 3 times per year, at least 90 days apart. The SDK enforces this on top of the OS’s own quota, and a request it cannot make does not count against it.

Step 5: Close the Feedback Loop

React to Feedback in Your App

Use survey callbacks to create follow-up experiences based on sentiment:

iOS
Android
Flutter
React Native

func onSurveyCompleted(surveyId: String, responses: [SurveyResponse]) {
    guard let nps = responses.first(where: { $0.questionId == "nps_question" }),
          let score = nps.answer as? Int else { return }

    if score >= 9 {
        // Promoter: encourage sharing
        showReferralPrompt()
        AppDNA.track(event: "nps_promoter", properties: ["score": score])
    } else if score <= 6 {
        // Detractor: offer help
        showSupportOptions()
        AppDNA.track(event: "nps_detractor", properties: ["score": score])
    }
}

override fun onSurveyCompleted(surveyId: String, responses: List<SurveyResponse>) {
    val score = responses.firstOrNull { it.questionId == "nps_question" }?.answer as? Int ?: return

    if (score >= 9) {
        showReferralPrompt()
        AppDNA.track(event = "nps_promoter", properties = mapOf("score" to score))
    } else if (score <= 6) {
        showSupportOptions()
        AppDNA.track(event = "nps_detractor", properties = mapOf("score" to score))
    }
}

@override
void onSurveyCompleted(String surveyId, List<Map<String, dynamic>> responses) {
  final nps = responses.firstWhere(
    (r) => r["questionId"] == "nps_question",
    orElse: () => {},
  );
  final score = (nps["answer"] as int?) ?? 0;

  if (score >= 9) {
    showReferralPrompt();
    AppDNA.track("nps_promoter", properties: {"score": score});
  } else if (score <= 6) {
    showSupportOptions();
    AppDNA.track("nps_detractor", properties: {"score": score});
  }
}

AppDNA.surveys.setDelegate({
  onSurveyPresented: (surveyId) => {},
  onSurveyDismissed: (surveyId) => {},
  onSurveyCompleted: (surveyId, responses) => {
    const score = (responses.find((r) => r.questionId === "nps_question")?.answer as number) ?? 0;

    if (score >= 9) {
      showReferralPrompt();
      AppDNA.track("nps_promoter", { score });
    } else if (score <= 6) {
      showSupportOptions();
      AppDNA.track("nps_detractor", { score });
    }
  },
});

Connect Events to Push Campaigns

In the Console, you can target push campaigns based on user behavior and survey responses:

Send “We’ve improved based on your feedback” push to users who gave NPS <= 6
Send “Share with friends” push to users who gave NPS >= 9
Send re-engagement pushes to users who haven’t triggered workout_completed in 7 days
Send milestone congratulations for streak_achieved events

These campaigns are configured entirely in the Console under Retention > Push Campaigns — no code changes needed.

View Feedback in the Console

Survey responses flow into the Console dashboard automatically:

Feedback > Love Score — NPS/CSAT trends over time
Feedback > Responses — individual responses with sentiment analysis
Feedback > Alerts — get notified when NPS drops below a threshold

Full Wired Example

iOS
Android
Flutter
React Native

import AppDNASDK

class EngagementManager: AppDNAPushDelegate, AppDNASurveyDelegate {
    init() {
        AppDNA.pushModule.setDelegate(self)
        AppDNA.surveys.setDelegate(self)
    }

    // MARK: - Event Tracking

    func trackWorkoutCompleted(duration: Int, type: String, calories: Int) {
        AppDNA.track(event: "workout_completed", properties: [
            "duration_minutes": duration,
            "type": type,
            "calories": calories
        ])
    }

    func trackStreakAchieved(days: Int) {
        AppDNA.track(event: "streak_achieved", properties: ["streak_days": days])

        // A high point: a good moment to show a Console-configured survey.
        // A STORE review is asked for by an onboarding step's "Request store review",
        // or by a `rate_app` button — never from a survey answer (see Step 4).
        if days == 7 || days == 30 {
            AppDNA.surveys.present("milestone_feedback")
        }
    }

    // MARK: - Push

    func onPushTapped(notification: PushPayload, actionId: String?) {
        guard let action = notification.action else { return }
        navigate(to: action.value)
    }

    func onPushReceived(notification: PushPayload, inForeground: Bool) {
        if inForeground {
            showBanner(title: notification.title, body: notification.body)
        }
    }

    // MARK: - Surveys

    func onSurveyCompleted(surveyId: String, responses: [SurveyResponse]) {
        guard let nps = responses.first(where: { $0.questionId == "nps_question" }),
              let score = nps.answer as? Int else { return }

        if score >= 9 {
            showReferralPrompt()
        } else if score <= 6 {
            showSupportLink()
        }
    }

    func onSurveyPresented(surveyId: String) { }
    func onSurveyDismissed(surveyId: String) { }
    func onPushTokenRegistered(token: String) { }
}

import ai.appdna.sdk.*

class EngagementManager : AppDNAPushDelegate, AppDNASurveyDelegate {
    init {
        AppDNA.push.setDelegate(this)
        AppDNA.surveys.setDelegate(this)
    }

    fun trackWorkoutCompleted(duration: Int, type: String, calories: Int) {
        AppDNA.track(
            event = "workout_completed",
            properties = mapOf("duration_minutes" to duration, "type" to type, "calories" to calories)
        )
    }

    fun trackStreakAchieved(days: Int) {
        AppDNA.track(event = "streak_achieved", properties = mapOf("streak_days" to days))
        // A high point: a Console-configured survey. A STORE review is asked for by an
        // onboarding step or a `rate_app` button, never from a survey answer (see Step 4).
        if (days == 7 || days == 30) AppDNA.surveys.present("milestone_feedback")
    }

    // Push
    override fun onPushTapped(notification: PushPayload, actionId: String?) {
        notification.action?.let { navigate(it.value) }
    }

    override fun onPushReceived(notification: PushPayload, inForeground: Boolean) {
        if (inForeground) showBanner(notification.title, notification.body)
    }

    // Surveys
    override fun onSurveyCompleted(surveyId: String, responses: List<SurveyResponse>) {
        val score = responses.firstOrNull { it.questionId == "nps_question" }?.answer as? Int ?: return
        when { score >= 9 -> showReferralPrompt(); score <= 6 -> showSupportLink() }
    }

    override fun onSurveyPresented(surveyId: String) { }
    override fun onSurveyDismissed(surveyId: String) { }
    override fun onPushTokenRegistered(token: String) { }
}

import 'package:appdna_sdk/appdna_sdk.dart';

// Dart abstract classes can't be mixed in, so use one standalone handler
// per delegate and register each with the matching module.
class EngagementManager {
  EngagementManager() {
    AppDNA.push.setDelegate(EngagementPushHandler());
    AppDNA.surveys.setDelegate(EngagementSurveyHandler());
  }

  Future<void> trackWorkoutCompleted(int duration, String type, int calories) async {
    await AppDNA.track("workout_completed", properties: {
      "duration_minutes": duration, "type": type, "calories": calories,
    });
  }

  Future<void> trackStreakAchieved(int days) async {
    await AppDNA.track("streak_achieved", properties: {"streak_days": days});
    // A high point: a Console-configured survey. A STORE review is asked for by an
    // onboarding step or a `rate_app` button, never from a survey answer (see Step 4).
    if (days == 7 || days == 30) await AppDNA.surveys.present("milestone_feedback");
  }
}

class EngagementPushHandler extends AppDNAPushDelegate {
  @override
  void onPushTapped(Map<String, dynamic> notification, String? actionId) {
    final value = notification["action_value"] as String?;
    if (value != null) navigate(value);
  }
}

class EngagementSurveyHandler extends AppDNASurveyDelegate {
  @override
  void onSurveyCompleted(String surveyId, List<Map<String, dynamic>> responses) {
    final nps = responses.firstWhere(
      (r) => r["questionId"] == "nps_question",
      orElse: () => {},
    );
    final score = (nps["answer"] as int?) ?? 0;
    if (score >= 9) showReferralPrompt();
    else if (score <= 6) showSupportLink();
  }
}

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

function useEngagement() {
  useEffect(() => {
    AppDNA.push.setDelegate({
      onPushTokenRegistered: (token) => {},
      onPushReceived: (notification, inForeground) => {},
      onPushTapped: (notification) => {
        if (notification.action_value) navigate(notification.action_value as string);
      },
    });

    AppDNA.surveys.setDelegate({
      onSurveyPresented: (surveyId) => {},
      onSurveyDismissed: (surveyId) => {},
      onSurveyCompleted: (surveyId, responses) => {
        const score = (responses.find((r) => r.questionId === "nps_question")?.answer as number) ?? 0;
        if (score >= 9) showReferralPrompt();
        else if (score <= 6) showSupportLink();
      },
    });

    return () => {
      AppDNA.push.setDelegate(null);
      AppDNA.surveys.setDelegate(null);
    };
  }, []);

  function trackWorkout(duration: number, type: string, calories: number) {
    AppDNA.track("workout_completed", { duration_minutes: duration, type, calories });
  }

  async function trackStreak(days: number) {
    await AppDNA.track("streak_achieved", { streak_days: days });
    // A high point: a Console-configured survey. A STORE review is asked for by an
    // onboarding step or a `rate_app` button, never from a survey answer (see Step 4).
    if (days === 7 || days === 30) await AppDNA.surveys.present("milestone_feedback");
  }

  return { trackWorkout, trackStreak };
}

Use Cases

Guides

Analytics, Push & Feedback

Use Case: Analytics, Push & Feedback

What You’ll Build

Step 1: Track Meaningful Events

What to Track

Event Design Guidelines

Step 2: Set Up Push Notifications

Register for Push

Track Push Engagement

Handle Push Tap Callbacks

Step 3: Measure Love Score with Surveys

Trigger-Based (Recommended)

Manual Trigger

Capture Survey Responses

Step 4: Asking for a Store Review

The OS review sheet, on a step the user has reached

A button that opens the store listing

Step 5: Close the Feedback Loop

React to Feedback in Your App

Connect Events to Push Campaigns

View Feedback in the Console

Full Wired Example

​Use Case: Analytics, Push & Feedback

​What You’ll Build

​Step 1: Track Meaningful Events

​What to Track

​Event Design Guidelines

​Step 2: Set Up Push Notifications

​Register for Push

​Track Push Engagement

​Handle Push Tap Callbacks

​Step 3: Measure Love Score with Surveys

​Trigger-Based (Recommended)

​Manual Trigger

​Capture Survey Responses

​Step 4: Asking for a Store Review

​The OS review sheet, on a step the user has reached

​A button that opens the store listing

​Step 5: Close the Feedback Loop

​React to Feedback in Your App

​Connect Events to Push Campaigns

​View Feedback in the Console

​Full Wired Example

Use Case: Analytics, Push & Feedback

What You’ll Build

Step 1: Track Meaningful Events

What to Track

Event Design Guidelines

Step 2: Set Up Push Notifications

Register for Push

Track Push Engagement

Handle Push Tap Callbacks

Step 3: Measure Love Score with Surveys

Trigger-Based (Recommended)

Manual Trigger

Capture Survey Responses

Step 4: Asking for a Store Review

The OS review sheet, on a step the user has reached

A button that opens the store listing

Step 5: Close the Feedback Loop

React to Feedback in Your App

Connect Events to Push Campaigns

View Feedback in the Console

Full Wired Example