전달 지표
OneSignal은 푸시 알림을 푸시 서비스(Google FCM, Apple APNs, Huawei HMS)로 전송하고, 푸시 서비스가 사용자의 장치(구독)로 전달합니다. 전달됨, 구독 취소, 실패 지표는 이러한 푸시 서비스에서 제공됩니다. 확인된 전달 및 클릭 지표는 장치의 OneSignal SDK에서 제공됩니다.| 지표 | 정의 |
|---|---|
| 전송됨 | OneSignal에서 제공업체로 성공적으로 전송된 메시지 수입니다. |
| 총 시도 수 | OneSignal이 전송을 시도한 메시지 수입니다. 전송됨 + 빈도 제한의 합계로 산출되는 파생 지표입니다. |
| 대상 | 대상 세그먼트의 구독 수입니다. |
| 전달됨 | 푸시 서비스가 사용자 장치로 전달을 보고한 푸시 구독 수입니다. |
| 구독 취소 | 앱을 제거했거나, 브라우저 데이터를 지웠거나, 푸시를 옵트아웃하고 이후 앱을 열지 않았기 때문에 메시지를 받지 못한 푸시 구독 수입니다. |
| 실패 | 오류로 인해 메시지를 받지 못한 푸시 구독 수입니다. 실패 메시지 문제 해결을 참조하세요. |
| 클릭 | 알림의 클릭 수입니다. |
| 빈도 제한 | 빈도 제한 설정으로 인해 알림이 전송되지 않은 푸시 구독 수입니다. |
| 확인된 전달 | 메시지 수신을 확인한 푸시 구독 수입니다. |
| 남음 | 전송을 위해 OneSignal 측에서 여전히 대기 중인 알림 수입니다. |
| 클릭률 | (클릭 / 전달됨) * 100%로 계산됩니다. |
| 확인된 CTR | (클릭 / 확인된 전달) * 100%로 계산됩니다. |
| 영향받은 열람 | 클릭하지 않고 알림을 받은 후 발생한 앱 열람 수입니다. Settings > Push & In-App > Influenced Opens에서 설정된 시간 창을 기반으로 합니다. |
모든 채널에 걸친 자세한 지표 정의는 지표 용어집을 참조하세요.
실패 메시지 문제 해결
다음 오류로 인해 OneSignal이 푸시 제공업체로 메시지를 전달할 수 없었습니다:| 오류 | 유형 | 문제 해결 단계 |
|---|---|---|
| 401 Unauthorized | Web | Web 푸시 서버에서 불명확한 401 오류가 발생했습니다. 신중하게 재시도하세요 — 중복 전송이 발생할 수 있습니다. |
| 404 Not Found | Web | 유효하지 않은 푸시 구독 엔드포인트(잘못된 토큰)입니다. |
| Authentication Error | FCM | FCM 자격 증명을 확인하고 서비스 계정 파일을 다시 업로드한 후 다시 시도하세요. |
| DeviceTokenNotForTopic | APNs | 토큰의 Bundle ID가 APNs 키 또는 인증서와 일치하지 않습니다. p8 토큰 또는 p12 설정에서 수정하세요. |
| Expired Certificate | APNs | p12 인증서가 만료되었습니다. 인증서 설정을 참조하세요. |
| FcmV1InvalidToken / Not Found | FCM | 유효하지 않은 푸시 토큰입니다. Firebase 자격 증명을 확인하세요. 장치가 앱을 다시 열어 토큰을 새로 고쳐야 합니다. |
| None / Missing | FCM | 프로젝트에서 Firebase Cloud Messaging API가 활성화되지 않았을 수 있습니다. Firebase Console에서 활성화하고 다시 시도하세요. |
| Permission Denied | FCM | 전체 오류 메시지를 확인하여 누락된 권한을 찾으세요. Service Account 파일의 권한을 업데이트하고 OneSignal에 다시 업로드하세요. |
| SenderIdMismatch | FCM | FCM v1 Sender ID 불일치입니다. Firebase 자격 증명을 확인하세요. 사용자가 업데이트된 토큰을 받으려면 앱을 다시 열어야 합니다. |
| TopicDisallowed | APNs | APNs 토큰 불일치입니다. p8 구성에서 Team ID, Key ID 및 Bundle ID를 확인하세요. |
전달 상태
| 상태 | 설명 |
|---|---|
| 전달됨 | 푸시 서비스가 수신자에게 메시지 전달을 보고했습니다. |
| 예약됨 | 메시지가 향후 전달로 예약되었습니다. |
| 전송 중 | 메시지가 현재 전송 중입니다. |
| 대기 중 | 메시지가 전송 대기 중입니다. |
| 취소됨 | 메시지가 수동으로 취소되었습니다. 푸시 알림 취소를 참조하세요. |
| 수신자 없음 | 전송 시점에 유효한 대상이 없습니다(예: 구독 취소 또는 세그먼트 외부). |
| 실패 | 오류로 인해 OneSignal이 메시지를 보낼 수 없었습니다. |
전환
메시지 통계
메시지 통계 그래프는 전송 후 30일 동안의 클릭, 세션, 사용자 지정 결과(레거시, 전환 지표로 교체 중)를 추적합니다. 참여가 전달 직후에 발생했는지 아니면 시간이 지나도 계속되었는지 확인하는 데 사용하세요.
대상 활동
대상 활동 리포트는 각 구독이 특정 메시지와 상호 작용한 방식을 보여줍니다. 결과가 카테고리별로 그룹화되어 전달 문제를 진단하고, 참여를 측정하고, 특정 메시지와 관련된 구독 취소를 식별하고, 리타겟팅이나 내보내기를 위해 대상을 세그먼트화할 수 있습니다.
- 카테고리
- 테이블 열
| 카테고리 | 설명 |
|---|---|
| 전송됨 | 메시지가 장치로 전송되었습니다. |
| 확인된 전달 | 장치에서 전달을 확인했습니다. |
| 전달 미확인 | 전달 확인을 받지 못했습니다. |
| 클릭됨 | 사용자가 알림을 클릭했습니다. |
| 클릭하지 않음 | 사용자가 알림을 클릭하지 않았습니다. |
| 실패 | 전달이 실패했습니다. |
| 구독 취소 | 메시지를 받은 후 구독이 구독 취소되었습니다. |
대상 리타겟팅
대상 활동 보기에서 모든 카테고리(예: 클릭하지 않은 모든 사용자)에 직접 리타겟팅된 메시지를 보낼 수 있습니다. 이를 통해 참여하지 않은 사용자를 후속 조치하거나, 이탈한 사용자를 다시 참여시키거나, 전달을 확인한 사용자의 성공을 강화할 수 있습니다.결과 내보내기
내보내기 메뉴를 사용하여 대상 데이터를 다운로드할 수 있습니다:- 선택한 활동 – 현재 보고 있는 탭만 내보냅니다(예: 전달에 실패한 모든 사용자).
- 모든 활동 – 모든 카테고리에 걸쳐 전체 리포트를 내보냅니다.
데이터 내보내기
오프라인 분석을 위해 메시지 및 사용자 데이터를 CSV로 내보냅니다.
메시지 설정
메시지 설정 패널에는 전송에 사용된 구성이 표시됩니다.- 대상 - 대상의 세부 정보:
- 총 수신자 수 - 메시지가 전송된 구독 수
- 메시지 전송 방법: 사용된 타겟팅 필터 또는 세그먼트
- 일정 - 메시지 전송이 시작된 시점 및 선택한 사용자별 전달 옵션(있는 경우)입니다.
- 제한 - 모든 제한, 빈도 제한 또는 채널 재정의입니다.
- 메시지 - 메시지 콘텐츠입니다.
- 타겟팅된 플랫폼(Android, iOS, 특정 브라우저)
- 고급 설정 - Priority, Time to live 및 Collapse ID와 같은 설정입니다.
- 추가 데이터 - 메시지에 추가된 사용자 지정 데이터입니다.
자주 묻는 질문
푸시 구독 상태는 언제 업데이트됩니까?
푸시 구독 상태는 두 가지 메커니즘을 통해 업데이트됩니다: 1. 사용자가 앱이나 사이트를 열었을 때 OneSignal SDK는 푸시 토큰이 유효한지, 알림 권한이 여전히 부여되어 있는지 확인한 후 즉시 구독 상태를 업데이트합니다. 예를 들어, 사용자가 장치 설정에서 푸시 알림을 비활성화한 후 앱을 다시 열면 SDK가 변경 사항을 감지하고 구독을 즉시 구독 취소로 표시합니다. SDK의 구독 관찰자(모바일 | 웹)를 사용하여 이러한 변경 사항을 자체 데이터베이스에 동기화할 수 있습니다. 2. 푸시 알림을 보낼 때 사용자가 앱을 제거하거나, 브라우저 데이터를 지우거나, 푸시를 비활성화하고 다시 돌아오지 않으면 OneSignal은 알림을 보낼 때까지 변경 사항을 감지할 수 없습니다. 푸시 서비스(FCM, APNs, HMS)가 토큰을 유효하지 않다고 보고하면 OneSignal은 구독을 구독 취소로 표시합니다. 이 감지는 일반적으로 2개 이상의 메시지가 필요합니다:| 전송 | 발생하는 일 |
|---|---|
| 메시지 1 | 장치에 전달됨. 사용자가 장치 설정에서 구독을 취소하거나 앱을 제거합니다. |
| 메시지 2 | 푸시 서비스가 메시지를 수락하지만 장치가 수신하지 못합니다. 푸시 서비스가 아직 토큰을 거부하지 않았기 때문에 OneSignal은 “전달됨”으로 보고합니다. |
| 메시지 3 | 푸시 서비스가 토큰을 거부합니다. OneSignal이 구독을 구독 취소로 표시합니다. |
| 메시지 4+ | OneSignal이 이 구독으로의 전달을 시도하지 않습니다. |
전달됨 수치가 확인된 전달 수치와 일치하지 않는 이유는 무엇입니까?
전달됨은 푸시 서비스(FCM, APNs)가 보고한 것입니다 — 전달을 위해 메시지를 수락했다는 의미입니다. 확인된 전달은 장치의 OneSignal SDK가 보고해야 하며, 장치가 온라인이고 앱이 알림을 처리한 경우에만 발생합니다. 오프라인 장치, 앱이 강제 종료된 장치 또는 SDK가 없는 장치는 전달됨으로 표시되지만 확인됨으로는 표시되지 않습니다.대상 활동 데이터는 얼마나 오래 사용할 수 있습니까?
대상 활동 데이터는 메시지가 전송된 시점부터 30일 동안 보관됩니다. 더 오래 보관해야 하는 경우 이 기간이 끝나기 전에 결과를 내보내세요.관련 페이지
확인된 전달
장치 수준 전달 확인의 작동 방식과 확인률에 영향을 미치는 요소.
지표 용어집
채널 전반의 모든 전달, 참여, 전환 지표의 정의.
Template Analytics
템플릿을 사용하여 전송 전반에 걸친 푸시 알림 성능 추적.
푸시 제한
대량 전송 중 서버 부하를 관리하기 위한 전달 속도 제어.