# In App Message

### ✨ 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. Add a **Title, Message, Image** *(optional),* Set **Positive** and **Negative Buttons**.
4. Choose the **schedule** (date and time).
5. Save your campaign.

Once saved:

* The campaign appears in the **Campaign List**.
* Status will show **Scheduled** with the scheduled time.

{% columns %}
{% column %}

<figure><img src="/files/S6qmk3MYcUljCH6QRlEk" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/U2SLDmj0FVkuGoUkLCaH" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### 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

* **Popup**
* **Banner**
* **Bottom Sheet**
* **Full Screen**

#### 4. Message Content

* Background color
* Add content (title, paragraph, button, image, video) via editor panel

👉 Click **Create Campaign** to finalize.

***

## 👀 Campaign Preview

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

<div data-full-width="false"><figure><img src="/files/qNkuIzraCfkdVfiGmuhA" alt="" width="236"><figcaption></figcaption></figure></div>

***

## 📋 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

<figure><img src="/files/uSOV3vixqfb48flT3p97" alt=""><figcaption></figcaption></figure>

***

### 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)

<figure><img src="/files/rTKkr9EOMitW1FEzPudP" alt=""><figcaption></figcaption></figure>

## 📱 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**.&#x20;
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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.twinr.dev/engage/in-app-message.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.