For the complete documentation index, see llms.txt. This page is also available as Markdown.
In-App Message Fatigue Management
This document covers in detail the display limit condition check step of the in-app message display determination process.
Overview
Display limit (fatigue management) is a feature that prevents the same in-app message from being displayed to a user excessively and repeatedly.
Each time an in-app message is displayed, a display record is left, and at the next display point, this record is used to determine whether the configured limit has been exceeded.
Display Limit Criteria
Category
Meaning
Basis
Per Session
Limits the number of displays during a single session
$sessionId
Per Device
Limits the number of displays on a single device
$deviceId
Per User
Limits the number of displays during a configured period
Display timestamp stored in the device cache
Regardless of the display limit category, all display records are stored on the user's device.
Therefore, if the app is deleted or its data is reset, the display records are lost and the count is aggregated again from 0.
Examples
1 time per session per user — Within the same session, the in-app message is displayed only once.
3 times per device per user — On that device, the in-app message is displayed a total of up to three times.
2 times in 7 days per user — If it has been displayed twice within the last 7 days, it is no longer displayed.
Process Details
At the point of in-app message display, the display limit is determined in the following order.
1
Retrieve Display Records
All stored display records for that in-app message are loaded. Each record contains the identifier at the time of display and the display timestamp.
2
Aggregate Display Counts by Criterion
For each configured criterion (per session, per device, per user), the number of display records matching the condition is counted.
Per session / per device: aggregate records with matching identifiers
Per user: aggregate records that occurred within the configured period
3
Determine Whether the Limit Is Exceeded
If any of the configured criteria reaches its limit count, the display is restricted.
Each criterion is judged independently, and the in-app message is displayed only if it passes all criteria.
If you configure multiple criteria together, the in-app message is displayed only if it satisfies all the configured limit conditions simultaneously.
