UMS(Unified Messaging System)의 피로도 관리 기능은 특정 수신자에게 과도한 메시지가 집중되는 것을 방지하기 위해 일일 발송 건수를 제한하는 정책입니다.
UMS 엔진의 핵심 동작을 제어하는 설정 파일입니다. 피로도 체크 시 Redis를 활용하므로 대량 발송 시 성능 영향도를 고려해야 합니다.
파일 위치: conf/common.properties
############################################################
# 피로도 설정 (Fatigue Settings)
############################################################
# 1. 피로도 체크 사용 여부
# - Y: 사용, N: 미사용 (기본값: N)
# - 'Y' 설정 시 Redis를 통해 카운트를 체크하며, 대량 발송 시 속도가 약간 저하될 수 있음.
UMS.USE_FATIGUE_YN = Y
# 2. 정보성 메시지 피로도 예외 처리
# - Y: 정보성 메시지는 피로도 체크에서 제외 (무조건 발송)
# - N: 정보성 메시지도 일반 광고성 메시지와 동일하게 피로도 체크 수행
# - 대상 채널: PUSH, RCS, SMS, KKOFRT(친구톡/알림톡)
UMS.INFOMSG_FATIGUE_NO_CHECK = Y
# 3. 피로도 체크 방식 선택 (TOTAL vs CHANNEL)
# - TOTAL: 모든 채널을 통합하여 전체 발송 건수 체크
# (주의: PUSH 발송 시에도 핸드폰 번호가 입력되어야 정확한 통합 체크 가능)
# - CHANNEL: 채널별로 각각 설정된 건수만큼 제한 (예: PUSH 3건, SMS 2건 각각 별도 관리)
UMS.FATIGUE.KIND = CHANNEL
# 4. 피로도 체크 적용 채널 리스트
UMS.FATIGUE_CHK_CHANNEL = ["PUSH", "RCS", "KKOFRT", "SMS"]
DB 기반 발송을 처리하는 UMS Agent의 피로도 관리 설정입니다. 엔진(common.properties) 설정과 동일한 정책을 유지하도록 구성해야 합니다.
파일 경로: conf/config.xml
<FATIGUE>
<USEYN>Y</USEYN>
<INFOMSG>Y</INFOMSG>
<KIND>CHANNEL</KIND>
<CHK_CHANNEL>["PUSH", "RCS", "KKOFRT", "SMS"]</CHK_CHANNEL>
</FATIGUE>
초기화 정책: 모든 피로도 발송 카운트는 매일 00:00(자정)에 자동으로 초기화됩니다.
성능 최적화: 피로도 체크는 Redis를 조회하여 실시간으로 카운트를 계산하므로, 대량 발송 시 처리 속도에 영향을 줄 수 있습니다. 성능이 최우선인 환경에서는 설정 여부를 신중히 검토하십시오.
데이터 일관성: UMS 엔진(common.properties)과 Agent(config.xml)의 설정 정책이 서로 일치해야 채널 간 일관된 피로도 관리가 가능합니다.
TOTAL 모드 유의사항: TOTAL 방식을 사용할 경우, PUSH 발송 시에도 수신자의 핸드폰 번호 정보를 함께 전달해야 정확한 채널 통합 체크가 보장됩니다. 아이디만으로 발송 시에는 PUSH 단독 카운트로만 체크될 수 있습니다.