Create a In-App Message Campaign

πŸ“˜

To use in-app messages, you must use the following or above SDK version

Web : javascript 11.29.0, react 11.29.0
App : Android 2.35.0, iOS 2.30.0, React Native 3.8.0, Flutter 2.5.0

You can create a new in-app message campaign by clicking the "+ Create Campaign" button located in the upper right corner of the "In-app Messages" menu in the dashboard.

Create a new campaign

Create a new campaign

Step 1. Campaign info

Campaign info

Campaign info

  • Name (Must): Name of the campaign
  • Description (Optional): Having descriptions can be very helpful for team members to understand what campaigns are being conducted by others.

Step 2. Status

After creating a campaign, you can view the campaign key, title, description, and status.

  • Campaign Key: It is a unique value that distinguishes the campaign and can be used to extract users exposed to a specific campaign.
  • Campaign Title / Description: You can modify the title and description of the campaign.
  • Campaign Status: When you first create a campaign, its status is "Draft." After setting up the campaign content, you can start the campaign. If you want to modify an ongoing campaign, you need to change its status to "Paused". You can also end a campaign if you no longer want to continue it.
Campaign status

Campaign status

Step 3-1. Campaign Settings > Type

You can choose the platform environment and layout for message delivery.

Message type

Platform, Layout Setting

  • Supported platform
    • Web : PC Web, Mobile Web
    • App : Android, iOS
  • Layout
    • Orientation : Portrait, Landscape
    • Modal Popup:
      • Image + Button
      • Image + Text + Button
    • Full-screen Popup (coming soon)
    • Bottom Sheet (coming soon)

Step 3-2. Campaign Settings > Message

  • You can freely configure the message contents. The configured content will be automatically displayed in the preview area on the right side of the screen.
Image configuration

Image configuration

  • Image:
    • Recommended aspect ratio and size for each layout
    • You should upload a separate image for landscape
      • Image + Button
        • Portrait : 2:3 / 1200px:1800px
        • Landscape : 3:2 / 1800px:1200px
      • Image + Text + Button
        • Portrait : 29:10 / 1450px:500px
        • Landscape : 29:10 / 1450px:500px
    • File format: PNG, JPG, JPEG
    • File size: Maximum 1MB
    • Click action
      • None
      • Move to link
        • Open Link in a (supported for Web only) : Same Window, New Window, New Tap
        • Dismiss the message on click : On, Off
  • Popup Style : Color for background, X button
  • Text:
    • Title: Maximum 30 characters
    • Body: Maximum 70 characters
    • Color : Color for title text, Body text
  • Buttons:
    • Maximum 2 buttons
    • Color : Color for button Background, Border, Text
    • Click action :
      • Close
      • Do not show again for a day
      • Move to link
        • Open Link in a (supported for Web only) : Same Window, New Window, New Tap
        • Dismiss the message on click : On, Off
Message configuration

Text, Button configuration

  • You should save the changes by clicking the "Save" button at the top of the screen.
Save the campaign settings

Save the campaign settings

Step 3-3. Campaign Experiment > Setting

You can choose the best one through A/B Test with various messages.

  1. Create A/B Test
  • By clicking the [+A/B Test] button to create the various messages for A/B Test.

  • You can add more Group and remove the group as below image.

  • About Measure

    • Traffic distribution is called MAB.
      The experiment measures the performance of each message based on the 'click rate', maintains traffic distribution every 1/24/48 hours after the message is exposed, and adjusts traffic distribution based on the performance of each message
    • CTR(Click-through rate) only calculates the click-through rate of links entered in the in-app message settings. (Close button is not included in the click-through rate.)

Step 4. Trigger

You can configure when the message will be displayed based on specific events. If you're wondering how to add events, you can refer to Create a New Event for more information.

Trigger event

Trigger event

  • Start Event
    • You can configure when the message will be displayed based on specific events. If you're wondering how to add events, you can refer to Create a New Event for more information.
  • Filters (Optional)
    • You can set more detailed conditions through event properties. In the example image, the view_productDetail event's category_id property is used to set the condition of displaying the message when visiting a specific category's product page.
  • Exposure Frequency
    • You can set the frequency of displaying the message to prevent customer fatigue. If multiple conditions are set, they will be applied with an AND condition.
      • How many times to display within one session of the same user.
      • How many times to display to the same user's device (regardless of the period).
      • How many times to display to the same user daily/hourly.

Step 5. Period

You can configure whether to keep the message displayed continuously or for a specific duration.

Scheduling

Scheduling

  • If you select "Display permanently", the message will be immediately displayed when you click "Start", and it will continue to be displayed unless explicitly "End" is triggered.
  • If you set a customized schedule, the message will only be displayed during the configured period.

Step 6. Run the campaign

You can also target specific users instead of stead of all users. Utilize various properties to define your desired customer segments!

Targeting

Targeting

If you want to test the message on internal user devices before exposing it to actual customers, you can input the desired user identifier into the test devices.

Step 7. Run the campaign

Once you have completed all the fields, click the "Start" button at the top to launch the campaign.

Ongoing campaigns can be paused or terminated.

Start the campaign

Activate the campaign

Step 7-1. Campaign with A/B Test

  • Start with A/B Test : Once you have set up an experiment, you can also start the experiment by pressing the
    [Start]
    button in the same way.
Start

Start

  • Implement the A/B Test
    • Once the experiment set up, you can see the number of exposures and conversions, conversion rates, and the best probability of each group. ("Conversion" means click)
    • Referring to below image, you can see more information such as conversion rate trends, traffic distributions, and cumulative distribution status for each group.
A/B Test Graph

A/B Test Graph

  • [Pause] and [End] of A/B Test
    • End : If you want to choose the best one after monitoring the performance of each message, you can click the [End] button of the test (Red button). then the winner you choose will be exposed for targets.
    • Pause : Press [Pause] button to pause the exposure of the message. then a/b test will be paused at the same time.

  • End of exposure
    • After the end of the experiment, press the [End] button to end the in-app message campaign.