인앱 메시지 피로도 관리

이 문서는 인앱 메시지 노출 판단 과정의 노출 제한 조건 확인 단계를 자세히 다룹니다.

개요

노출 제한(피로도 관리)은 동일한 인앱 메시지가 사용자에게 과도하게 반복 노출되는 것을 막는 기능입니다.

인앱 메시지가 한 번 노출될 때마다 노출 기록이 남으며, 다음 노출 시점에 이 기록을 바탕으로 설정한 제한을 초과했는지 판단합니다.

노출 제한 기준

구분	의미	기준
세션 당	하나의 세션 동안 노출 횟수를 제한	$sessionId
디바이스 당	하나의 기기에서 노출 횟수를 제한	$deviceId
사용자 당	설정한 기간 동안 노출 횟수를 제한	기기 캐시에 저장된 노출 시점

노출 제한 구분에 관계없이 모든 노출 기록은 사용자의 기기에 저장됩니다. 따라서 앱을 삭제하거나 데이터를 초기화하면 노출 기록이 사라지고 횟수가 다시 0부터 집계됩니다.

예제

• 사용자에게 세션 당 1회 — 같은 세션 안에서는 인앱 메시지가 한 번만 노출됩니다.

• 사용자에게 디바이스 당 3회 — 해당 기기에서 인앱 메시지가 총 세 번까지만 노출됩니다.

• 사용자에게 7일 2회 — 최근 7일 이내에 두 번 노출되었다면 더 이상 노출되지 않습니다.

과정 상세

인앱 메시지 노출 시점에 노출 제한은 다음 순서로 판단됩니다.

1

노출 기록 조회

해당 인앱 메시지의 저장된 노출 기록을 모두 불러옵니다. 각 기록에는 노출 당시의 식별자와 노출 시각이 담겨 있습니다.

2

기준별 노출 횟수 집계

설정된 각 기준(세션 당·디바이스 당·사용자 당)에 대해, 조건에 해당하는 노출 기록의 수를 셉니다.

• 세션 당·디바이스 당: 식별자가 일치하는 기록을 집계

• 사용자 당: 설정 기간 이내에 발생한 기록을 집계

3

제한 초과 여부 판단

설정된 기준 중 하나라도 제한 횟수에 도달하면 노출을 제한합니다. 각 기준은 서로 독립적으로 판단되며, 모든 기준을 통과해야 인앱 메시지가 노출됩니다.

여러 기준을 함께 설정한 경우, 설정한 모든 제한 조건을 동시에 만족해야 인앱 메시지가 노출됩니다.