Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

In App Message

The In-App Messaging feature allows you to create and deliver targeted messages directly inside your application. Unlike push notifications, these messages appear when users are actively using the app

✨ Key Highlights

  • Delivers messages inside the app screen.

  • Supports customizable content (title, description, image, button actions).

  • Flexible scheduling – send immediately, once, or based on campaign schedule.

  • Provides analytics (views & clicks).

🎯 Create a Campaign

How to Create an In-App Message Campaign?

  1. Go to Campaigns → In-App Messages

  2. Click Create Campaign

  3. Complete the following sections:

1️⃣ Audience

  • Show to all users

  • Show to a particular segment

2️⃣ Schedule

  • Start Date & Time – When the campaign begins

  • End Date & Time – When the campaign stops

  • Show Forever – Always visible once the app is installed

3️⃣ Display Type

Choose how the message appears in the app:

  • Popup

  • Banner

  • Bottom Sheet

  • Full Screen

4️⃣ Message Content

Content Type

You can now choose how you want to design your in-app message:

🔹 Drag & Drop (Default)

Use the visual editor to:

  • Add Title

  • Add Description

  • Add Image

  • Add Button

  • Customize Background color

  • Set Corner Radius

  • Enable/Disable Close Button

This option is ideal for quickly creating standard promotional messages without coding.

🔹 HTML Editor (New)

Select HTML Editor if you want full design control using custom HTML and CSS.

When selected:

  • A code editor appears

  • You can write custom HTML

  • Apply inline CSS styling

  • Design fully custom layouts

The middle section shows a live preview of how your HTML message will appear inside the app.

Example HTML Structure:

📌 Best Practices for HTML Messages:

  • Keep layout mobile-friendly (recommended max width: 360–420px)

  • Use optimized images

  • Avoid heavy external scripts

  • Use inline CSS for better compatibility

👉 After configuring all sections, click Create Campaign to finalize.

Once saved:

  • The campaign appears in the Campaign List

  • Status will show Scheduled (if future date selected)

👀 Campaign Preview

The middle section shows a live preview of how your message will appear in the app.

📋 Campaign Status

  • Scheduled

    • Visible in campaign list with start date/time

    • Can edit or delete

  • Active (on start date/time)

    • Status changes automatically

    • Date/time hidden

    • Can only view, delete, or end campaign

    • All user activity (views, clicks) is tracked in Analytics

  • Ended (on end date)

    • Campaign stops automatically

    • No longer visible in the app

📊 Campaign Analytics

Stats Tab

  • Viewed – Number of times users saw the message

  • Dismissed – Users who closed without interaction

  • Clicked – Users who engaged with the CTA (buttons/links)

  • Split of Clicks – Breakdown of clicks across multiple buttons/links

  • CTR (Click-Through Rate) – % of users who clicked vs. total viewed

Overview Tab

Track how your in-app messages are performing with detailed insights:

  • Campaign Name & ID

  • Start & End Date

  • Target Segment

  • Message Preview (exactly how it appeared to users)

📱 User Experience

  • On app launch, system checks for campaigns:

    • If 1 campaign → show directly

    • If multiple campaigns → show earliest one first, then next after dismiss/click

    • If none → show nothing

  • If new campaigns are created while app is running → shown only on next launch

❓ Frequently Asked Questions (FAQs)

  1. Can I schedule In-App Messages? Yes. You can set a start and end time for each campaign. Once scheduled, the message will automatically appear at the chosen time.

  2. Can I customize the design of the In-App Message? Yes. You can edit the title, description, image, and buttons. Additionally, colors, fonts, and styles can be customized to match your brand.

  3. What happens if multiple campaigns are active at the same time? If two or more In-App Messages overlap, the priority will be given based on the latest scheduled campaign. You can also control visibility by targeting specific audiences.

  4. How can I target my audience ? You can target users based on:

    • User behavior (app activity, clicks)

    • User profile (location, subscription plan, preferences)

    • Specific app events (login, purchase, etc.)

  5. Can I track the performance of my In-App Messages? Yes. Analytics include:

    • Views (how many users saw the message)

    • Clicks (how many users engaged with the buttons)

    • CTR (Click-Through Rate) for overall effectiveness

  6. Can users dismiss an In-App Message? Yes. Users can dismiss the message by clicking the Close (X) button. You can configure whether the message reappears on the next session or not.

  7. Is this feature available for all plans? In-App Messaging is available only for Premium plan customers.

  8. Can I edit or delete a campaign after it's created? If status = Scheduled → You can edit or delete it. If status = Active → You can delete, view and End it If status = Ended → You can only delete it.

PreviousInactivity Push NotificationNextOverview

Last updated