알림톡/브랜드메세지 통계관련 문의

[wjdrhks11]

안녕하세요. 얼마 전 통계 관련 문의드렸던 건에 대해, 댓글로 추가 답변이 없어 다시 글 남깁니다.

알림톡·브랜드톡 오픈률 관련해 아래 6가지 여쭙습니다.

1. "집계 단위"의 정확한 기준

"발송 성공 10건 이하인 집계 단위는 제공되지 않고, 기간 합계가 아닌 일자별·시간대별로 각각 적용된다"고 안내받았는데, 무엇을 하나로 묶어서 10건을 세는지가 저희 쪽에서 갈립니다. 아래 경우를 각각 알려주시면 정확히 이해하겠습니다.

(가) 같은 1시간 안에 템플릿 A 5건 + 템플릿 B 6건 = 11건
→ 합쳐서 11건이니 집계되나요? 아니면 각각 5건·6건이라 둘 다 안 되나요?

(나) 같은 1시간 안에 템플릿 A 11건 + 템플릿 B 3건
→ A만 되고 B는 안 되나요? 아니면 그 시간대 합계가 14건이라 둘 다 되나요?

(다) 13시에 템플릿 A 9건, 14시에 템플릿 A 5건 (하루 14건)
→ 시간대별로는 9건·5건이니, 하루 합계가 14건이어도 전부 안 잡히나요?

(라) 일자 단위가 따로 자격을 갖나요?
저희 2026-09-03은 하루 합계 23건인데 readCount는 22였고, 1건만 보낸 15시 구간은 시간이 지나도 계속 0이었습니다.
→ 일자 값은 "조건을 넘은 시간대들의 합"일 뿐이고, 일자 합계가 10건을 넘는 것만으로는 자격이 생기지 않는 것으로 이해했는데 맞나요?

(마) 시간대 구간의 경계는 어떻게 되나요?
정시 단위(예: 18:00~18:59)가 맞나요? 그리고 구간을 가르는 기준 시각은 저희가 요청을 보낸 시각인가요, 비즈고 접수 시각인가요?
저희는 대량 발송 시 200명씩 여러 요청으로 나눠 보내는데, 보내다가 정각을 넘으면 22건이 11건·11건으로 쪼개져 두 구간 다 탈락하게 되는지 궁금합니다.

(바) "10건 초과"의 경계 — 정확히 10건이면 제공되지 않고 11건부터 제공되는 것이 맞나요? 저희는 11건짜리에서 값을 받았습니다.

(사) 발신프로필도 묶는 단위인가요? 한 계정에 발신프로필이 여러 개일 때 10건은 발신프로필별로 세는 것이 맞나요?

정리하면, 10건을 세는 묶음이 (일자 + 시간대)인지, (일자 + 시간대 + 템플릿)인지가 핵심 질문입니다. 어느 단위로 발송을 몰아야 지표가 나오는지 설계에 직접 걸리는 부분이라 여쭙습니다.

2. 발송 성공 건수(successCount)도 2시간이 지나야 나오나요?

"2시간"은 읽음에만 걸리는 조건으로 이해했는데, 실제로는 2시간 전에는 그 시간대 구간 자체가 응답에 나오지 않았습니다. 의도된 동작인지 확인 부탁드립니다.

3. buttonClickCount에 어떤 버튼이 포함되나요?

웹링크(WL)가 잡히는 것은 저희가 확인했습니다. 채널추가(AC)·봇키워드(BK)·배송조회(DS) 등 다른 타입도 포함되나요?
그리고 listClickCount · thumbnailClickCount · etcClickCount는 각각 어떤 클릭인지 알려주시면 감사하겠습니다.

4. failCount와 각 비율의 분모

- failCount에는 어떤 실패가 들어가나요? 카카오 발송 실패만인지, 대체발송으로 넘어간 건도 포함인지 궁금합니다.

• sendRate = successCount ÷ (successCount + failCount) 가 맞나요?
• readRate = readCount ÷ successCount 가 맞나요?
• clickRate와 ctr은 무엇이 다른가요? 저희 값은 17.4와 18.2로 서로 달랐습니다.

5. 브랜드메시지 통계도 같은 조건인가요?

/api/comm/v1/center/statistics/brandmessage 도 2시간·10건 조건이 동일한지 궁금합니다.

6. 2시간 만에 나온 값과 D+3 확정값이 다를 수 있나요?

D+2까지 재조회해서 덮어쓰라는 안내는 잘 이해했습니다. 다만 이번엔 발송 2시간 만에 22건 중 22건이 나왔는데,

- 이 값이 D+1·D+2에 더 늘어날 수 있는 성격인가요? (예: 뒤늦게 읽은 사람이 반영)

• 발송 건수가 더 늘지 않았더라도 값이 갱신되나요?

감사합니다.

[cliff]

안녕하세요. 비즈고입니다.
문의 주신 알림톡·브랜드메시지 통계 관련 항목별로 답변드립니다.

1. “집계 단위”의 정확한 기준

읽음/클릭 지표는 카카오 정책상 발송 성공 10건 이하인 집계 단위에서는 제공되지 않습니다. 즉, 정확히 10건은 제공 대상이 아니며 11건 이상부터 제공 대상으로 보시면 됩니다.

다만 문의 주신 예시처럼 같은 시간대에 템플릿 A 5건 + 템플릿 B 6건을 합산해 11건으로 보는지, 또는 템플릿별로 각각 5건·6건으로 보는지에 대해서는 현재 공개 문서만으로 확답드리기 어렵습니다.

현재까지 확인된 기준은 “기간 전체 합계가 아니라 일자별·시간대별 기준으로 각각 적용된다”는 점입니다. 따라서 하루 합계가 10건을 초과하더라도, 특정 시간대의 발송 성공 건수가 10건 이하라면 해당 시간대의 읽음/클릭 지표는 제공되지 않을 수 있습니다.

또한 발신프로필별로 통계가 조회되는 구조이므로, 여러 발신프로필을 사용하는 경우에는 발신프로필별 발송량 기준으로 집계되는 것으로 이해해 주시는 것이 안전합니다.

문의 주신 “템플릿까지 집계 단위에 포함되는지”, “시간대 경계 기준이 요청 시각인지 접수/발송 시각인지”는 발송 설계에 직접 영향을 주는 항목이므로 내부 확인 후 추가로 정확히 안내드리겠습니다.

2. successCount도 2시간이 지나야 나오는지

통계 문서 기준으로 발송 시간별 통계와 반응 통계는 발송 후 일정 시간이 지난 뒤 조회 가능합니다. 특히 읽음/클릭과 같은 반응 지표는 발송 후 약 2시간 이후부터 확인되는 구조입니다.

다만 문의 주신 것처럼 2시간 전에는 해당 시간대 구간 자체가 응답에 나타나지 않는 현상이 의도된 동작인지, 또는 센터 통계 API의 집계 처리 방식 때문인지는 추가 확인이 필요합니다.

현재로서는 통계 수집 배치 및 카카오 반응 데이터 집계 지연을 고려해, 발송 직후보다는 최소 2시간 이후 조회하는 방식으로 설계하시는 것을 권장드립니다.

3. buttonClickCount에 포함되는 버튼

웹링크(WL) 버튼 클릭은 buttonClickCount 집계 대상입니다.

카카오 통계 원문 기준으로는 알림톡 버튼/바로연결 클릭 타입에 WL 외에도 AC, BK, DS 등 여러 버튼 타입별 클릭 항목이 존재합니다. 다만 비즈고 센터 통계 API의 buttonClickCount가 이 항목들을 모두 합산하는지, 또는 일부 타입만 포함하는지는 추가 확인 후 안내드리는 것이 정확합니다.

각 클릭 항목은 아래와 같이 이해하시면 됩니다.

- buttonClickCount: 버튼 영역 클릭 수

• listClickCount: 리스트형 메시지의 리스트 영역 클릭 수
• thumbnailClickCount: 썸네일 또는 이미지 영역 클릭 수
• etcClickCount: 위 항목 외 링크가 포함된 클릭 요소의 클릭 수입니다. 예를 들어 스킴, 웹뷰, 랜딩 등 액션이 발생하는 기타 클릭이 여기에 포함될 수 있습니다.

4. failCount와 각 비율의 분모

failCount는 알림톡/브랜드메시지 기준으로 카카오 발송에 실패한 건을 의미합니다.

대체발송으로 문자, LMS, MMS가 발송되더라도 해당 건은 카카오 알림톡 또는 브랜드메시지로는 최종 성공한 것이 아니므로, 알림톡/브랜드메시지 통계에서는 failCount에 포함됩니다.

따라서 sendRate는 아래 산식으로 이해하시면 됩니다.

sendRate = successCount ÷ (successCount + failCount)

readRate는 일반적으로 아래 산식 기준으로 이해하시면 됩니다.

readRate = readCount ÷ successCount

다만 clickRate와 ctr은 실제 응답값에서 서로 다른 값이 확인된 만큼, 두 지표의 정확한 분모와 산식은 추가 확인이 필요합니다. 추정으로 답변드리기보다는 내부 기준 확인 후 별도로 안내드리겠습니다.

대체발송 성공 여부는 알림톡/브랜드메시지 성공률과 별개로 문자 발송 결과 또는 리포트 기준에서 확인해 주셔야 합니다.

5. 브랜드메시지 통계도 같은 조건인지

브랜드메시지도 통계 API에서 동일하게 제공되는 상품군이며, 읽음/클릭 통계의 10건 이하 미제공 조건과 집계 지연 조건이 적용되는 것으로 보시면 됩니다.

즉, /api/comm/v1/center/statistics/brandmessage 조회 시에도 발송 성공 10건 이하인 집계 단위에서는 읽음/클릭 데이터가 제공되지 않을 수 있고, 반응 지표는 발송 후 일정 시간 경과 후 확인 가능합니다.

다만 알림톡과 브랜드메시지의 세부 집계 기준이 완전히 동일한지, 특히 템플릿/그룹태그/타겟팅 기준까지 동일하게 적용되는지는 내부 확인 후 보완 안내드리겠습니다.

6. 2시간 후 값과 D+3 확정값이 달라질 수 있는지

네, 달라질 수 있습니다.

읽음/클릭 데이터는 사용자의 실제 반응 시점과 카카오/비즈고 집계 반영 시점에 따라 D+1, D+2에 추가 반영될 수 있습니다. 따라서 발송 건수가 더 늘어나지 않더라도 readCount, clickCount 등 반응 지표는 이후 재집계 과정에서 변경될 수 있습니다.

운영 배치 기준으로는 해당 일자 데이터를 D+2까지 재조회하여 갱신하고, D+3 이후에는 확정값으로 고정하는 방식을 권장드립니다.

단, 발송 성공 10건 이하인 집계 단위는 시간이 지나도 읽음/클릭 데이터가 새로 제공되지 않을 수 있으므로, 이 조건은 별도로 고려해 주셔야 합니다.

감사합니다.

[cliff]

안녕하세요. 비즈고입니다.

앞서 추가 확인이 필요하다고 안내드렸던 항목들에 대해 카카오 측 확인 결과를 받아 보완 안내드립니다.

1. 10건 초과 여부를 판단하는 집계 단위

   읽음/클릭 데이터 제공 여부를 판단하는 10건 초과 기준은 통계 API 응답값의 디멘전 기준으로 적용됩니다.

   예를 들어 “템플릿 유효 읽음 시간별 통계”의 경우 응답값에 아래 항목들이 포함됩니다.

   date, hour, send_date, send_hour, sender_key, uuid, template_code, template_name, message_type, read_count

   이 중 카운트 값인 read_count와 수집 기준 시간인 date, hour를 제외한 나머지 값들이 발송수 판단 디멘전이 됩니다.

   따라서 같은 시간대라도 템플릿, 발신프로필, 메시지 타입, 발송 시간 등이 다르면 각각 별도 집계 단위로 판단됩니다.

   • 템플릿 A 5건 + 템플릿 B 6건: 각각 5건, 6건으로 판단되어 미제공
   • 템플릿 A 11건 + 템플릿 B 3건: A만 제공, B는 미제공
   • 같은 템플릿 A를 13시 9건, 14시 5건 발송: 발송 시간별로 각각 판단되어 모두 미제공
   • 일별 통계: 일 단위 디멘전 기준으로 판단
   • 시간별 통계: 시간 단위 디멘전 기준으로 각각 판단
   • 정확히 10건: 미제공, 11건부터 제공
   • 발신프로필이 여러 개인 경우: 발신프로필별로 각각 11건 이상이어야 제공

   정리하면, 10건 초과 여부는 단순 기간 합계가 아니라 조회 API의 응답 디멘전 단위로 판단됩니다.

2. 시간대 경계 및 기준 시각

   시간대 기준은 정시 단위입니다.

   예를 들어 13시 구간은 13:00:00부터 13:59:59까지, 14시 구간은 14:00:00부터 14:59:59까지입니다.

   시간대 구분 기준은 고객사 요청 시각이나 비즈고 접수 시각이 아니라 실제 카카오 발송 처리 시각입니다.

   따라서 대량 발송 중 실제 카카오 발송 처리 시각이 정각을 넘으면, 각 시간대별로 분리되어 10건 초과 여부가 판단됩니다.

3. successCount 제공 시점

   H+2 제공 기준은 읽음/클릭 지표뿐 아니라 successCount/failCount를 포함한 통계 제공 전반에 적용됩니다.

   다만 H+2는 안정적인 제공을 위한 버퍼가 포함된 기준이며, 웹훅이 도달했다면 실제 데이터는 생성된 것으로 볼 수 있습니다.

4. buttonClickCount 및 기타 클릭 항목

   buttonClickCount에는 문서상 제공되는 모든 버튼 타입과 쿠폰 클릭이 포함됩니다.

   • buttonClickCount: 문서상 제공되는 버튼 타입 전체 및 쿠폰 클릭
   • listClickCount: 카탈로그, 아이템리스트 영역 클릭
   • thumbnailClickCount: 카탈로그와 와이드아이템리스트를 제외하고, 말풍선 상단 이미지를 노출하는 메시지 타입의 이미지 영역 클릭
     예: 알림톡 이미지형, 브랜드메시지 이미지형, 와이드이미지형, 캐러셀피드형, 캐러셀커머스형
   • etcClickCount: 위 항목 외 클릭 요소 클릭
     예: 본문 내 링크, 공유하기 버튼 등 말풍선에서 제공하는 일부 스킴 기능

5. clickRate와 ctr 산식

   카카오 측에서는 별도의 rate 값을 내려주지는 않으며, 내부 지표 계산 시에는 아래 수식을 사용한다고 확인했습니다.

   전체 클릭 수 ÷ 전체 열람 수

6. 브랜드메시지 통계 조건

   브랜드메시지도 알림톡과 동일하게 응답값의 디멘전 기준으로 10건 초과 여부가 판단됩니다.

   발송 성공 10건 이하인 집계 단위에서는 읽음/클릭 데이터가 제공되지 않으며, 11건 이상부터 제공됩니다.

   브랜드메시지의 경우 템플릿, 그룹태그, 타겟팅, 친구 타입 등 통계 응답에 포함되는 디멘전 값들이 10건 초과 판단 단위에 포함됩니다.

7. H+2 이후 값과 D+3 확정 전 변경 가능성

   발송 일시와 수집 일시는 분리되어 관리됩니다.

   발송 건수는 발송 일시 기준으로 고정되지만, 사용자가 뒤늦게 메시지를 열람하거나 클릭하면 해당 반응이 발생한 수집 시간 기준으로 집계되어 제공됩니다.

   따라서 발송 건수가 더 늘어나지 않더라도, 사용자가 나중에 열람하거나 클릭하면 readCount 또는 clickCount는 이후 수집 시간대에 증가할 수 있습니다.

   다만 이미 집계된 시간대에 대해 고정적으로 재집계가 수행되는 것은 알림톡 발송 통계에 한정됩니다.

   읽음/클릭 통계는 고정적인 재집계가 이루어지는 구조는 아니며, 재집계나 보정이 발생하여 조회 내용이 바뀔 수 있습니다.

감사합니다.