푸시 메시지 리포트 고수준 통계입니다.
전달 통계 및 결과 정의
중요한 개념:- 푸시 Subscription은 메시지에 사용된 대상 및 설정에 따라 모바일 및 웹 푸시 구독을 나타낼 수 있습니다.
- OneSignal은(모든 푸시 제공업체와 마찬가지로) 푸시 서비스(Google(FCM), Apple(APNs), Huawei(HMS) 등)로 푸시 알림을 보내고 이어서 푸시 서비스가 사용자에게 보냅니다.
- Delivered, Unsubscribed 및 Failed 응답은 푸시 서비스에서 제공됩니다.
- Confirmed Delivery 및 Clicked 응답은 OneSignal SDK에서 제공됩니다.
| 메트릭 | 정의 |
|---|---|
| Audience | 포함된 세그먼트의 푸시 Subscription 수이며 중복을 제외하고 제외된 세그먼트의 Subscription도 제외됩니다. |
| Sent | 대상의 푸시 Subscription 중 메시지가 전송된 수입니다. 구독 취소, 실패, 남아있거나 제한된 Subscription은 제외됩니다. |
| Delivered | 푸시 서비스에서 성공적으로 수신한 푸시 알림의 수입니다. |
| Confirmed Delivery | 메시지 수신을 확인한 푸시 Subscription의 수입니다. |
| Unsubscribed | 앱을 제거했거나, 브라우저 데이터를 지웠거나, 푸시를 옵트아웃하고 이후 앱을 열지 않았기 때문에 메시지를 받지 못한 푸시 Subscription의 수입니다. |
| Failed | 오류로 인해 메시지를 받지 못한 푸시 Subscription의 수입니다. 실패 메시지 문제 해결을 참조하세요. |
| Remaining | 전송을 위해 OneSignal 측에서 여전히 대기 중인 알림의 수입니다. |
| Capped | 빈도 제한 설정으로 인해 전송되지 않은 알림의 수입니다. |
| Clicks | 메시지에 대한 클릭 수입니다. |
| Click-Through Rate | (Clicks / Delivered) * 100%로 계산됩니다. |
| Confirmed CTR | (Clicks / Confirmed Delivered) * 100%로 계산됩니다. |
| Influenced Opens | 클릭하지 않고 알림을 받은 후 발생한 앱 열람 수입니다. 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를 확인하세요. |
전달 상태
| 상태 | 설명 |
|---|---|
| Delivered | 메시지가 푸시 서비스로 전송 완료되었습니다. |
| Scheduled | 메시지가 향후 전달로 예약되었습니다. |
| Sending | 메시지가 현재 전송 중입니다. |
| Queued | 메시지가 전송 대기 중입니다. |
| Canceled | 메시지가 수동으로 취소되었습니다. 푸시 알림 취소를 참조하세요. |
| No Recipients | 전송 시점에 유효한 대상이 없습니다(예: 구독 취소 또는 세그먼트 외부). |
| Failed | 오류로 인해 OneSignal이 메시지를 보낼 수 없었습니다. |
메시지 통계
지난 30일 동안의 클릭, 세션 및 사용자 지정 Outcome의 그래프를 보여줍니다.
사용자 지정 Outcome과 함께 Outcome 그래프를 보여주는 이미지입니다
- OneSignal API를 통해 전송된 메시지는 30일 동안만 보관됩니다.
- 시간 경과에 따른 메시지 성능을 추적하려면 Template Analytics를 사용하세요.
- 대시보드 또는 API를 통해 메시지 데이터를 내보내세요.
대상 활동
대상 활동 리포트는 각 구독이 특정 메시지와 상호 작용한 방식을 보여줍니다. 결과가 카테고리별로 그룹화되어 수신자가 어떻게 참여했는지 빠르게 확인할 수 있습니다.
대상 활동 탭 및 테이블
- 카테고리
- 테이블 열
| 카테고리 | 설명 |
|---|---|
| Sent | 메시지가 장치로 전송되었습니다. |
| Confirmed Delivery | 장치에서 전달을 확인했습니다. |
| Did Not Confirm Delivery | 전달 확인을 받지 못했습니다. |
| Clicked | 사용자가 알림을 클릭했습니다. |
| Did Not Click | 사용자가 알림을 클릭하지 않았습니다. |
| Failed | 전달이 실패했습니다. |
| Unsubscribed | 메시지를 받은 후 구독이 구독 취소되었습니다. |
대상 활동 데이터는 메시지가 전송된 시점부터 30일 동안만 사용할 수 있습니다. 더 오래 보관해야 하는 경우 결과를 내보내세요.
대상 활동이 유용한 이유
대상 활동은 각 결과에 속하는 특정 사용자를 보여줌으로써 전달 수를 넘어서는 인사이트를 제공합니다. 다음에 사용하세요:- 실패하거나 확인되지 않은 전달을 검토하여 전달 문제를 진단합니다.
- 클릭과 비클릭을 비교하여 참여를 측정합니다.
- 메시지와 연결된 구독 취소를 식별하여 이탈을 추적합니다.
- 리타겟팅 또는 내보내기를 위해 대상을 세그먼트화합니다.
대상 리타겟팅
대상 활동 보기에서 모든 카테고리(예: 클릭하지 않은 모든 사용자)에 직접 리타겟팅된 메시지를 보낼 수 있습니다. 이를 통해 참여하지 않은 사용자를 후속 조치하거나, 이탈한 사용자를 다시 참여시키거나, 전달을 확인한 사용자의 성공을 강화할 수 있습니다.결과 내보내기
내보내기 메뉴를 사용하여 대상 데이터를 다운로드할 수 있습니다:- 선택한 활동 – 현재 보고 있는 탭만 내보냅니다(예: 전달에 실패한 모든 사용자).
- 모든 활동 – 모든 카테고리에 걸쳐 전체 리포트를 내보냅니다.
메시지 설정
이 섹션에는 전달 전 메시지가 구성된 방법에 대한 메시지 세부 정보 및 시각적 요약이 표시됩니다.- Audience - 대상의 세부 정보:
- 총 수신자 수 - 메시지가 전송된 Subscription 수
- 메시지 전송 방법: 사용된 타겟팅 필터 또는 세그먼트
- Schedule - 메시지 전송이 시작된 시점 및 선택한 사용자별 전달 옵션(있는 경우)입니다.
- Throttling - 모든 제한, 빈도 제한 또는 채널 재정의입니다
- Message - 메시지 콘텐츠입니다.
- 타겟팅된 플랫폼(Android, iOS, 특정 브라우저)
- Advanced Settings - Priority, Time to live 및 Collapse ID와 같은 설정입니다.
- Additional Data - 메시지에 추가된 사용자 지정 데이터입니다.