IOSOR 가이드
리포트는 전송 건수가 아닌 DLR 수신 확인과 일치해야 합니다
전송 요청이 완료되었다고 해서 실제 발송이 완료된 것은 아닙니다. 재무 및 제품 리포트 내보내기는 반드시 DLR 수신 내역을 따라야 하며, 수신 수락 수치만으로 정산을 진행해서는 안 됩니다.
전송 요청 건수는 착시를 줍니다. API가 메시지를 수락했으므로 해당 주간의 처리가 잘 끝난 것처럼 보입니다. 그러나 이러한 안도감은 정산 주간에 무너집니다. 전송 요청을 성공으로 집계하는 리포트는 DLR 수신 내역, 다중 세그먼트 트래픽에 대한 지갑 차감 내역, 웹훅 감사 결과와 상충하게 됩니다.
IOSOR는 명확한 규칙을 적용합니다. 리포트 내보내기는 배달 수신 내역을 따릅니다. 전송 요청됨(Submitted), 대기 중(Queued), 전송 수락됨(Accepted-for-send)은 운영상의 과정 지표로만 남습니다. 재무 및 제품 팀이 검토해야 하는 핵심 열은 전달 완료(Delivered), 실패(Failed), 미확인(Unknown)입니다.
전송 요청은 과정일 뿐 마감 지표가 아닙니다
전송 수락은 시스템이 작업을 수용했음을 증명할 뿐, 수신자 단말기에 SMS가 도착했음을 의미하지 않습니다. 리포트의 주요 KPI가 전송 요청 건수라면, 실패나 미확인 비중이 늘어날 때 성공률을 과대평가하게 됩니다. 전송 요청 수치는 전체 처리량 확인용으로만 유지하고, 전달 완료의 대용으로 사용해서는 안 됩니다.
마감 절차를 정례화하십시오. 먼저 DLR 열(미확인, 실패, 전달 완료)을 열어 확인한 후, 전체 볼륨 파악을 위해 전송 요청 수치를 참고합니다. 제품 출시 검토에서도 동일한 순서를 적용하여 마케팅 자료에서 성공의 정의가 주중에 임의로 변경되지 않도록 합니다.
내보내기 열은 수신 확인 내역을 따릅니다
내보내기 스키마는 수신 상태를 명확히 정의합니다. 전달 완료는 DLR이 필수적입니다. 실패는 최종 실패 신호가 필요합니다. 미확인은 수신 확인이 도착할 때까지 미확인 상태로 유지되며, 이를 임의의 성공으로 간주해서는 안 됩니다. 마감 주간에 미확인 상태를 성공 속에 숨기면 미발송 문제에 대한 불필요한 분쟁이 발생합니다.
세그먼트 산식과 실제 청구서가 일치하지 않을 때는 추정 세그먼트를 곱한 전송 요청 수치가 아니라, 수신 내역이 확인된 행과 해당 세그먼트 수에서 조사를 시작하십시오. SMS 청구 주간의 세그먼트 경로는 엄격하게 유지되어야 하며, 리포트는 전송 요청을 전달 완료로 처리하는 것을 거부해야 합니다.
동일한 수신 확인을 기준으로 웹훅과 장부 조정
선불 장부 내보내기에 대한 웹훅 감사 조정은 리포트가 실제 데이터에 기반하고 있음을 증명하는 방법입니다. 일일 웹훅 로그, DLR 상태, 선불 장부 내역은 동일한 결과를 가리켜야 합니다. 웹훅에서는 실패로 표시되는데 리포트에서 성공으로 표시된다면 리포트 로직이 잘못된 것입니다. 지갑 잔액을 임의로 수정하지 말고 내보내기 로직을 수정하십시오.
감사 주기를 명확히 유지하십시오. 하루 분량의 웹훅 수신 내역, 장부 내보내기, 리포트 팩을 준비하고 메시지 ID를 대조합니다. 차이점은 운영 팀으로 전달하고, 조작된 성공 수치는 스키마 담당자에게 반환합니다.
전송 요청 기반의 정산 주간 거부
전송 요청 수치에만 의존하여 청구하거나 성과를 측정하는 모든 마감 작업은 중단되어야 합니다. 재무 팀이 전달 완료 및 미확인 비중을 중심으로 분석할 수 있도록 리포트를 재구성하십시오. 파트너 계약서에 '성공적인 API 전송'이라는 표현이 남아 있더라도 이를 DLR 참고 사항으로 해석하고, 잘못된 문구에 맞춰 리포트 열을 왜곡하지 마십시오.
관련 운영 경로
IOSOR로 시작하기
IOSOR 콘솔에서 이번 주 리포트 팩을 열고, 헤드라인 KPI가 submit이나 API accept가 아니라 DLR 영수증(delivered, failed, unknown) 기준인지 확인하세요. submit을 성공으로 보는 차트가 있으면 재무 마감 전에 이름을 바꾸거나 제거하세요. 내보내기는 한 번만, 제품과 재무가 같은 영수증 열을 쓰게 하세요.
IOSOR 핵심 요약
리포트는 DLR 영수증(delivered, failed, unknown)으로 마감합니다. submit은 처리량용일 뿐 도달 진실이나 청구 근거가 아닙니다.
할 일: 영수증 필드 단일 내보내기를 고정. 하지 말 것: 제품은 accept를 축하하고 재무는 failed DLR로 다툼.
이 가이드가 도움이 되었나요?
관련 가이드
- 보고서 뷰와 원시 지갑 원장 행 비교
제품 및 재무 보고서 뷰는 DLR 및 지출을 합산합니다. 원시 지갑 원장 항목은 지갑 내보내기에 유지되며 보고서 CSV를 원장으로 취급하지 마십시오.
- 재무와 제품이 하나의 내보내기를 공유합니다
제품 대시보드와 재무 마감은 동일한 DLR 내보내기 데이터를 읽어야 합니다. 더 우호적인 상태가 포함된 두 번째 시트는 정산 실패의 원인이 됩니다.