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

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.

Last updated