Skip to main content
In-app messages are configured in the AppDNA Console and displayed automatically by the SDK when trigger conditions are met. No code is required to show messages.

​
How It Works

  1. You create an in-app message in the Console with content, layout, and trigger rules.
  2. The message definition is synced to the SDK via the config bundle.
  3. On every track() call, the SDK evaluates all active message triggers.
  4. If conditions match, the message is presented automatically.
In-app messages are fully server-driven. You can change the message content, trigger rules, and audience without an app update.

​
Message Types

TypeDescription
bannerSmall bar at the top or bottom of the screen
modalCentered overlay with a dimmed background
fullscreenFull-screen takeover
tooltipSmall popup anchored to a UI element

​
Module Access

final messages = AppDNA.inAppMessages;

​
Module Methods

MethodSignatureDescription
suppressvoid suppress()Suppress all in-app messages
unsuppressvoid unsuppress()Resume showing in-app messages
set delegateset delegate(InAppMessageDelegate?)Set a delegate for message callbacks

​
Suppressing Messages

Suppress messages during critical flows: 
AppDNA.inAppMessages.suppress();
startPurchaseFlow();

// Resume after purchase completes
void onPurchaseComplete() {
  AppDNA.inAppMessages.unsuppress();
}

​
InAppMessageDelegate

class MessageHandler extends InAppMessageDelegate {
  @override
  void onMessagePresented(String messageId, String messageType) {
    print("Message shown: $messageId ($messageType)");
  }

  @override
  void onMessageAction(String messageId, String action, String? url) {
    if (url != null) {
      navigate(url);
    }
  }

  @override
  void onMessageDismissed(String messageId) {
    print("Message dismissed: $messageId");
  }
}

AppDNA.inAppMessages.delegate = MessageHandler();

​
Auto-Tracked Events

EventTrigger
message_presentedAn in-app message is displayed
message_actionUser taps an action in the message
message_dismissedMessage is closed

​
Full Example

import 'package:appdna_sdk/appdna_sdk.dart';

class AppCoordinator extends InAppMessageDelegate {
  AppCoordinator() {
    AppDNA.inAppMessages.delegate = this;
  }

  void startOnboarding() {
    AppDNA.inAppMessages.suppress();
    presentOnboardingFlow();
  }

  void onboardingDidFinish() {
    AppDNA.inAppMessages.unsuppress();
  }

  @override
  void onMessagePresented(String messageId, String messageType) { }

  @override
  void onMessageAction(String messageId, String action, String? url) {
    switch (action) {
      case "deep_link":
        if (url != null) navigate(url);
        break;
      case "dismiss":
        break;
    }
  }

  @override
  void onMessageDismissed(String messageId) { }
}
In-app messages are created in the Console under Engagement > In-App Messages. Design the message, set trigger rules, and publish.