In-App Message¶
In-App Message is a customizable popup message with an image and buttons delivered to targeted group of users at a desirable timing. All you need to do is to create and publish a message from the dashboard. Message will be delivered without making any modification to any of the source code or releasing a new version of the app to the store, which allows marketers to run effective marketing campaigns to improve conversions without having developer's help.
You can deliver effective marketing messages by cusotamizing the settings as follows:
Image
One or two buttons with embedded URL to open a web page from the browser, or a deeplink that routes to anywhere in the app
Schedule
The target of users
Display timing of In-App Message
For example:
Deliver a coupon code to users who put items in the cart but didn't finalize the purchase
Display an appropriate navigation to users who just registered within several days ago to increase their conversion.
Additionally, you can deliver the message to the users who declined to receive the push notification.
Also, the created in-app message judges that it has been "displayed" when either the action button or the close button at the top right of the message has been pressed.
Create In-App Message¶
Here we will create an in-app message from the dashboard.
Go to MARKETING > MESSAGING and click CREATE NEW > In-App Message
Campaign¶
Campaign Name¶
Set the name for the new campaign. This name can be seen from the list of in-app messages.
Set the Conversion Event¶
You can set the campaign goal. This represents the number of users who have executed the specified event within 24 hours from the in-app message delivery. See inapp-measurement for more details.
Create contents¶
Choose the message type from either DIALOG, OVERLAY or BANNER and create content.
DIALOG¶
Image only¶
You can only display an image for Image Only layout of dialog message.
Fill out the below forms to create an In-App Message:
- Background Colors
Choose the background color of the outer area of the message.
- Image
Choose the image you want to insert into the message.
Supported file formats: JPEG, PNG
File size
Recommended: Below 500KB
Maximum: 1MB
Image size
Recommended: 1152px by 1500px (portrait) or 1500px by 1152px (horizontal)
- Deep Link or Web URL (optional)
Fill out the URL which will be opened when the image is clicked. When this is left blank, the message will just close when the image is clicked.
Character Limit
Maximum: 1000
- Button Tracking Event Name (optional)
Specify the page URL to open once the image is tapped in the message. You can change the name of the collected event when the image is clicked.
Note
The long-side of the image for Image Only layout must be 3000px or smaller.
It may take a while to display the message if the selected file is large.
With Button¶
With DIALOG In-App Message with button, you can display image, text and buttons as the content of the message. One or two buttons can be placed in a single message, and you can set the URL to be opened when the button is clicked individually.
Fill out the below forms to create an In-App Message:
- Background Colors
Choose the colors of the background area as well as the dialog area of the message.
- Image (optional)
Choose the image you want to insert into the message.
Supported file formats: JPEG, PNG
File size
Maximum: 1MB
Image size
Recommended: 1152px by 1152px (portrait) or 960px by 960px (horizontal)
- Header (optional)
Fill out the header text. You can also set the text color.
- Body
Fill out the body text. You can also set the text color.
- Button Label
Fill out the button label text. You can also set the background and text colors.
- Deep Link or Web URL (optional)
Fill out the URL which will be opened when the button of the message is clicked. When this is left blank, the message will just close when the buttons is clicked.
Character Limit
Maximum: 1000
- Button Tracking Event Name (optional)
Specify the page URL to open once the button is clicked in the message. You can change the name of the collected event when the button is clicked.
OVERLAY¶
OVERLAY message will cover the whole screen of the app, and you can display image, text and buttons as the content of the message. One or two buttons can be placed in a single message, and you can set the URL to be opened when the button is clicked individually.
Fill out the below forms to create an In-App Message:
- Background Colors
Choose the background color of the outer area of the message.
- Image
Choose the image you want to insert into the message.
Supported file formats: JPEG, PNG
File size
Maximum: 1MB
Image size
Recommended: 1200px by 1200px (portrait) or 832px by 832px (horizontal)
- Header
Fill out the header text. You can also set the text color.
- Body
Fill out the body text. You can also set the text color.
- Button Label
Fill out the button label text. You can also set the background and text colors.
- Deep Link or Web URL (optional)
Fill out the URL which will be opened when the button of the message is clicked. When this is left blank, the message will just close when the buttons is clicked.
Character Limit
Maximum: 1000
- Button Tracking Event Name (optional)
Specify the page URL to open once the button is clicked in the message. You can change the name of the collected event when the button is clicked.
BANNER¶
With BANNER type In-App Message, you can display image and text as an message to cover the top part of the screen. You can set the URL to be opened when the banner is clicked.
Fill out the below forms to create an In-App Message:
- Background Colors
Choose the background color of the outer area of the message.
- Image
Choose the image you want to insert into the message.
Supported file formats: JPEG, PNG
File size
Maximum: 1MB
Image size
Recommended: 240px by 240px
- Body
Fill out the body text. You can also set the text color.
- Deep Link or Web URL (optional)
Fill out the URL which will be opened when the banner is clicked. When this is left blank, the message will just close when the banner is clicked.
Character Limit
Maximum: 1000
- Button Tracking Event Name (optional)
Specify the page URL to open once the banner is pressed in the message. You can change the name of the collected event when the banner is clicked.
Distribute Users Among Variants¶
Distribute target users among Control Group and message variants as configured in Select Target. Control Group refers to the group of users who will not receive the message in order to see how effective the message was by comparing the results between users who received the message and who did not.See A/B Testing for more details how to change the settings with additional variants.
For example, when sending to All Users with Control Group set to 20% and Variant 1 to 80%, 80% of the users randomly chosen from all of the users will receive the message while the 20% rest will not.
Set distribution percentages¶
By default, Control Group is set as 0% and Variant 1 is set as 100% which will make all of the target users receive the message. If you do not wish to use the Control Group, you can leave these settings as is. If you want to use the Control Group then you can adjust the percentages with the total being 100%.
You can assign 50% each to Control Group as well as Variant 1 by clicking Distribute evenly, while Distribute evenly (without control group) will make Control Group 0% and Variant 1 100%.
Note
Control Group's percentage can be anything between 0% and 99%.
Variant 1's percentage can be anything between 1% and 100%.
Only integers can be set.
Changing the distribution settings is not possible after a campaign has been saved.
The actual number of message delivery may fluctuate depending on the volume of the target user.
Delivery¶
- Delivery period
Set the period of time you want the campaign to be delivered to your users. The message will be shown once per user during this period. Users are identified by User ID.
- Display Frequency
You can limit the number of times a message is displayed.
Only once per user
The default is to show the message only once per user.
Multiple times per user
If you select multiple times per user, the same message can be displayed to each user multiple times.
For example, if you want to limit the total number of times a message is being displayed to 3 times, you can use the below settings.
With the above setting, if the message's trigger event occurs 3 times in a day, the same in-app message will be displayed 3 times in that day.
Warning
If you limit the total times to No limit, the message continue to be displayed without limit.
If you allow a user to receive the message multiple times, it is required to limit the total number of times they can receive the same message.
The total times per day setting is optional, so if you wish to set a limit, check the checkbox before launching the campaign.
- Trigger by Event
Specify when the message should be shown. By default, messages will be shown to users when the app lauches.
You can also handle when to display the message using event tracking. Choose the desirable event from the listed events that you have already tracked by event tracking API. The SDK will automatically show the message when you tracked the specified event.
Select Target¶
You can target all users or a segment of users by filtering with events or user profiles with the filters. The filters can be combined as either and , and not, or condition up to 5 in total.
and: Add the users to the delivery target who match all the specified condition.
and not: Exclude the users from the delivery target who match the specified condition.
or: Add the users to the delivery target who match any of the specified condition.
For example:
When deliverying to users who have used the app 3 days ago, but have not done so for 2 days since then
When deliverying to users whose gender is female and have performed either Event A or Event B within the last 3 days
Filtering with audiences¶
You can segment the target by using existing audiences created as explained in Audience
Note
Filtered Audience: This audience cannot be combined with other filtering conditions.
Import Audience: This audience can be combined with other filtering conditions.
Smart Audience ™: This audience can be combined with other filtering conditions.
Filter with Events¶
You can segment the target by the usage of the events, specifying how many times an event has been done within certain period.
Filter with Event Property¶
You can segment the target by the usage of the events and its associated properties, specifying the property value within certain period.
Note
With Event Property filters you cannot specify how many times event has been performed. Users who have done the event with the property at least once within the specified period will be included in the target.
Filter with User Profile¶
You can segment the target by registered user profile data. With either number or date types data set in the SDK, the condition can be constructed using comparison with the assigned value such as 'is more than,' 'is less than,' 'is more than or equal' or 'is less than equal.'
All Users¶
The campaign will be delivered to all the users registered to Repro. If you wish to exclude users who match special conditions, please add desirable filters using combined as and not.
Testers¶
Send message only to test users' devices. You can specify the target users in Testers Management.
Note
The target is automatically specified and cannot be modified if you choose a user group from analytics pages.
First-time Users¶
Deliver in-app messsage to users who have launched the app for the first time.
Note
Please note that the user will not be regarded as First-time if more more than a week has past since the app's installation.
Save As Draft¶
To save an incomplete campaign, such as when all the required fields have not been filled out, please click the SAVE AS DRAFT button. For campaigns that are saved as draft, it is still possible to change all fields including the Campaign Goal and Variants.
You can access your drafted campaigns from the "Draft" tab on the Messaging homepage.
To Launch or Launch As Private¶
Before clicking the "LAUNCH" or "LAUNCH AS PRIVATE" button, please carefully check the contents of the campaign. After a campaign has been launched or launched as private, it is no longer possible to change the Campaign Goal or Variants.
Once your campaign is ready to be launched, please click the LAUNCH or the LAUNCH AS PRIVATE button.
Note
Every in-app message is displayed once per user. If the same user has multiple devices, once the message is shown on one device it will not be shown on the other one.
Campaign Measurement¶
You can check the effectiveness of the campaigns.
Note
This screen will only be applied to campaigns that were created after 2016/10/14.
Delivery Results¶
- Deliveries
Total number of users who saw the delivered message on a daily basis.
- Conversions
Number of total users who have performed the campaign goal event set from the creation page within 24 hours on a daily basis.
- Conversion Ratio
Number of conversions devided by deliveries.
- Campaign Progress
Results of the deliveries, opens and occurrence of the campaign goal event on a daily basis: Note that the results represent the number of users.
A/B Testing¶
A/B testing allows you to see what kind of content drives better open rate or conversion rate by delivering different patterns of the message to divided group of users.
You can also keep the most effective pattern from the A/B testing as the winner of the campaign and only delivery the selected variant.
Create Message¶
By composing a message with two or more variants, an A/B-Test can be performed.
You can create up to 4 different patterns.
Adding or removing message variants is not possible after a campaign has been saved.
Distribute Users Among Variants¶
Distribution percentages can be individually adjusted when having more than 2 variants making the total 100%.
You can assign equal percentages to Control Group as well as each of the variants by clicking Distribute evenly, while Distribute evenly (without control group) will make Control Group 0% and make perecentages even among multiple variants.
Note
Control Group's percentage can be anything between 0% and 99%.
Each of the variants' percentage can be anything between 1% and 100%.
Only integers can be set.
Changing the distribution settings is not possible after a campaign has been saved.
The actual number of message delivery may fluctuate depending on the volume of the target user.
Campaign Measurement （A/BTest）¶
Details screen
You will see the results after a while from the delivery. The charts will show the number of deliveries, button clicks and the conversion rate of each of the patterns. Please see Analytics results aggregation for more details about when the campaign results will be updated.
Note
The overall numbers of Deliveries, Conversions and Conversion Rate will exclude results of Control Group to make it easier to see how effective the campaign itself had been.
Users who belong to Control Group will not receive the message, so the results of Delivery, Button 1 Clicks and Button 2 Clicks will always be shown as -.
The number of Conversions of Control Group shows how many times the campaign goal event had been done among the users who belong to Control Group.
The number of Conversion Rate of Control Group is caluclated dividing number of Conversions by the number of users who belong to Control Group.
Please note that the definition of Button Clicks slightly vary depending on the type of the message. Please refer to the below chart of each definition.
Message Type |
Definition of Button 1 Click |
Definition of Button 2 Click |
|---|---|---|
DIALOG |
Number of taps of Button 1 |
Number of taps of Button 1 |
DIALOG with Image Only layout |
Number of taps on the image |
None |
OVERLAY |
Number of taps of Button 1 |
Number of taps of Button 1 |
BANNER |
Number of taps on the banner area |
None |
During the A/B test, the results of the test will be displayed. Here, you will be able to compare the markers (Button1 CTR, Button2 CTR, CVR) that have selected different patterns, including the control group.
Pattern
Each pattern used to deliver the A/B test, including the control group, will be displayed here.
Baseline
Here, you will be able to select the baseline pattern that will be used as the standard when comparing each pattern. By changing the baseline, you will be able to compare between a variety of different patterns.
Targeted indicator
An indicator is used when comparing patterns to baselines in A/B tests. You can select a ratio value (i.e. Button1 CTR, Button2 CTR, CVR) as the indicator. Also, the indicators listed can be changed through the editing page.
90％ confidence interval
The 90% confidence interval will be displayed when each pattern is compared to the baseline. For the definition of 90% confidence interval, please see the FAQ. Here, we will talk about the most common ways to recognize patterns.
Pattern 1:
When displayed as such, it means that the difference between the pattern and the baseline is significant. We recommend moving onto the winner pattern if enough time has passed since delivery.
Pattern 2:
When displayed as such, it means that the difference between the pattern and the baseline is not significant. Either wait until the results appear or consider moving on to the next campaign if enough time has passed since the delivery.
Pattern 3:
When displayed as such, it means that the difference between the pattern and the baseline is significant. If this is the only window displayed, we recommend determining the baseline pattern as the winner pattern.
Pattern 4:
When displayed as such, it means that the difference can't be calculated because there is no indicator value.
Note
Below is an example of when the winner pattern is selected from the A/B test significant difference results. The comparison results of the rest of each pattern will not be displayed.
Campaign Progress
The graphs show patterns of Button1 CTR, Button2 CTR, Main CVR, Sub CVR for in-app message.
Status List Screen
You will be able to check the status of the A/B test for each campaign here, when the operating campaign is either live or not. Icon display conditions are as follows.
Icon |
Display conditions |
|---|---|
 |
A significant difference exists, and the results of the pattern exceed the baseline at least once |
 |
A significant difference exists, and the results of the pattern are only of ones that fall below the baseline |
 |
Only patterns without significant difference |
 |
If all patterns can't be calculated |
 |
If winning pattern is already selected |
 |
When either the targeted indicator or the baseline pattern of the A/B test is not set |
| ー | When the campaign is not conducting A/B test |
Note
In the instance of a campaign that has a significant difference with the baseline having both exceeding and falling below results, it will be displayed as the results of the pattern with at least one exceeding the baseline.
For questions, please visit the FAQ.
Select the winner¶
Once you select the winner, all after deliveries of the same in-app message will be using the selected pattern to all target users.