> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 지표 용어집

> OneSignal 생태계 전반에서 각 메시지 채널에 대한 지표 레이블 간의 미묘한 차이를 이해하여 메시징 성과를 정확하게 해석합니다.

## 개요

OneSignal은 메시지 여정의 각 단계에 대한 지표를 기록합니다. 이 여정은 OneSignal에서 시작하여 타사 제공업체로 이동하고 수신자 기기 또는 받은편지함으로의 전달로 끝납니다.

이 문서는 메시지 수명 주기에서 캡처하는 다양한 지표와 이러한 지표가 각 채널에 대한 OneSignal 생태계의 다양한 접점에서 어떻게 표시되는지를 명확히 하기 위한 것입니다. 소스 간 숫자를 조정하거나 내부 보고서를 작성할 때 이러한 정의를 사용하십시오.

이 용어집은 채널별로 분류됩니다. 각 섹션에는 다음이 포함됩니다:

1. **용어**: 여기서 지표 및 정의에 대한 공통 용어집을 설정합니다.
2. **전달 수명 주기**: 여기서 전달 여정의 각 단계에서 캡처된 지표를 시각적으로 나타냅니다.
3. **지표 매핑**: 여기서 모든 OneSignal 접점에 걸쳐 지표 이름을 연결합니다.

### 채널 지표 비교

다양한 채널에는 다양한 전달 상태 및 사용자 참여 지표가 포함됩니다. 아래 표는 각 채널에 대한 다양한 지표를 나열합니다.

| 채널     | 전송됨 | 전달됨 | 실패 | 거부됨 | 남은 수 | 클릭됨 | 열림 | 반송됨 | 읽음 | 구독 취소됨 | 스팸으로 보고됨 | 억제됨 | 빈도 제한 |
| ------ | --- | --- | -- | --- | ---- | --- | -- | --- | -- | ------ | -------- | --- | ----- |
| 푸시     | ✅   | ✅   | ✅  | ❌   | ✅    | ✅   | ❌  | ❌   | ❌  | ✅      | ❌        | ❌   | ✅     |
| 이메일    | ✅   | ✅   | ✅  | ❌   | ✅    | ✅   | ✅  | ✅   | ❌  | ✅      | ✅        | ✅   | ❌     |
| SMS    | ✅   | ✅   | ✅  | ✅   | ✅    | ✅   | ❌  | ❌   | ✅  | ❌      | ❌        | ✅   | ❌     |
| 인앱     | ✅   | ❌   | ✅  | ❌   | ✅    | ✅   | ❌  | ❌   | ❌  | ❌      | ❌        | ❌   | ❌     |
| 라이브 활동 | ❌   | ❌   | ✅  | ❌   | ❌    | ❌   | ❌  | ❌   | ❌  | ✅      | ❌        | ❌   | ❌     |

## 푸시 용어

1. **전송됨**: OneSignal에서 제공업체로 성공적으로 전송된 메시지 수입니다.
2. **총 시도 수**: 전송을 시도한 메시지 수입니다. 여기에는 푸시 제공업체로 성공적으로 전송된 메시지와 실패가 포함됩니다. 이는 **파생** 지표이며 제공업체로 전송을 시도하는 동안 성공, 실패 및 오류의 합계입니다.
3. **대상**: 타겟팅된 세그먼트의 구독 수입니다.
4. **전달됨**: 알림을 받은 것으로 확인된 푸시 구독 수입니다.
5. **구독 취소됨**: 앱을 제거하거나, 브라우저 데이터를 지우거나, 푸시를 거부하고 이후 앱을 열지 않아 메시지를 받지 못한 푸시 구독 수입니다. 향후 메시지에서 이러한 구독으로 전송을 시도하지 **않습니다**.
6. **실패**: 오류로 인해 알림을 받지 못한 푸시 구독 수입니다. 향후 메시지에서 이러한 구독으로 전송을 시도합니다.
7. **클릭됨**: 알림의 클릭 수입니다.
8. **빈도 제한**: 빈도 제한 설정으로 인해 알림이 전송되지 않은 푸시 구독 수입니다.

### 푸시 수명 주기

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant Provider
    participant Platform
    participant User

    %% -----------------------------
    %% Metrics when sending to provider
    %% -----------------------------
    Note over OneSignal,User: 제공업체로 전송 시 지표

    OneSignal--xProvider: 전달에서 제외됨 [빈도 제한]
    Note left of OneSignal: 전달 전 제외된 메시지

    OneSignal-->>Provider: 알림 전송
    Provider-->>OneSignal: 오류 응답 [실패 / 구독 취소됨]
    Note left of OneSignal: 제공업체로 전송 실패

    %% -----------------------------
    %% Metrics reported by push provider
    %% -----------------------------
    Note over OneSignal,User: 푸시 제공업체가 보고한 지표

    OneSignal->>Provider: 알림 전송
    Provider->>OneSignal: 제공업체가 수락함 [전송됨]
    Note left of OneSignal: 제공업체로 성공적으로 전달됨

    Provider->>Platform: 알림 전달
    Platform->>OneSignal: 전달 확인됨 [전달됨]
    Note left of OneSignal: 플랫폼으로 성공적으로 전달됨

    %% -----------------------------
    %% Metrics reported by platform
    %% -----------------------------
    Note over OneSignal,User: 플랫폼이 보고한 지표

    Platform->>User: 알림 표시됨
    User->>OneSignal: 참여 이벤트 [클릭됨]
    Note left of OneSignal: 사용자 참여
```

### 푸시 지표 매핑

| 용어     | 대시보드 - 전달 보고서 통계 카드 | 대시보드 - 전달 보고서 시계열 차트 | 대시보드 - Journey 노드 보고서 통계 카드 | 대시보드 - Journey 노드 보고서 시계열 차트 | 대시보드 - 대상 활동 | 대시보드 - 참여 트렌드 | 메시지 보기 API<sup>1</sup> | 알림 CSV            | Event Streams             |
| ------ | ------------------- | -------------------- | --------------------------- | ---------------------------- | ------------ | ------------- | ---------------------- | ----------------- | ------------------------- |
| 전송됨    | 전송됨, 전달됨            | ❌                    | 전달됨                         | 전달됨                          | 전송됨          | 전달됨           | successful             | successful        | message.push.sent         |
| 총 시도 수 | ❌                   | ❌                    | 총 전송 수                      | 전송됨                          | ❌            | ❌             | ❌                      | ❌                 | ❌                         |
| 대상     | 대상                  | ❌                    | ❌                           | ❌                            | ❌            | ❌             | ❌                      | ❌                 | ❌                         |
| 전달됨    | 확인됨                 | 확인된 전달               | 확인됨                         | 확인됨                          | 확인된 전달       | ❌             | received               | received          | message.push.received     |
| 구독 취소됨 | 구독 취소됨              | ❌                    | 구독 취소됨                      | 구독 취소됨                       | 구독 취소됨       | 구독 취소됨        | failed                 | failed            | message.push.unsubscribed |
| 실패     | 실패                  | ❌                    | 실패                          | 실패                           | 실패           | ❌             | errored                | errored           | message.push.failed       |
| 클릭됨    | 클릭됨                 | 클릭 수                 | ❌                           | 클릭됨                          | 클릭됨          | 클릭됨           | converted              | converted         | message.push.clicked      |
| 빈도 제한  | 제한됨                 | ❌                    | 제한됨                         | 제한됨                          | ❌            | ❌             | frequency\_capped      | frequency\_capped | ❌                         |

<sup>1</sup> '남은 수'를 제외한 모든 지표에 대해 API에 플랫폼별 지표도 포함합니다(예: ios\_converted, android\_converted).

## 이메일 용어

1. **전송됨**: 제공업체로 성공적으로 전송된 이메일 수입니다.
2. **대상**: 타겟팅된 세그먼트의 구독 수입니다.
3. **전달됨**: 구독자의 이메일 서버로 전달된 것으로 확인된 이메일 수입니다.
4. **실패**: 반송을 제외하고 받은편지함으로 전달할 수 없는 이메일 수입니다. 여기에는 ESP 또는 OneSignal 전달 실패로 보고된 실패가 포함될 수 있습니다.
5. **억제됨**: 발신자 평판을 보호하기 위해 이전 반송 또는 스팸 신고로 인해 차단된 이메일 수입니다. 이 지표는 OneSignal 이메일을 사용하도록 구성된 앱에 대해서만 기록됩니다.
6. **반송됨**: 잘못된 주소, 가득 찬 받은편지함, 발신자 평판 또는 DMARC 문제로 인해 거부된 이메일 수입니다. 이러한 주소는 OneSignal 또는 타사 ESP가 관리하는 [억제 목록](/docs/ko/suppressions)에 추가됩니다.
7. **스팸으로 보고됨**: 이메일을 스팸으로 표시한 수신자 수입니다. 이러한 주소는 OneSignal 또는 타사 ESP가 관리하는 [억제 목록](/docs/ko/suppressions)에 추가됩니다.
8. **구독 취소됨**: 이메일 수신을 거부한 수신자 수입니다.
9. **총 열림 수**: 반복을 포함하여 이메일이 열린 총 횟수입니다.
10. **총 클릭 수**: 반복을 포함하여 이메일의 링크가 클릭된 총 횟수입니다.
11. **고유 열림 수**: 이메일을 연 개별 수신자 수입니다. 이 지표는 확인된 전달과 함께 사용되어 열림률을 결정합니다.
12. **고유 클릭 수**: 이메일을 클릭한 개별 수신자 수입니다. 이 지표는 확인된 전달과 함께 사용되어 클릭률을 결정합니다.

**총 클릭 수 및 열림 수와 고유 클릭 수 및 열림 수를 구분하는 이유는 무엇입니까?**

고유 클릭 수 및 열림 수는 해당 구독자가 동일한 이메일을 열거나 클릭한 횟수에 관계없이 구독자당 한 번만 계산됩니다. 총 클릭 수 및 열림 수 추적은 구독자당 고유하지 않으며 이메일이 클릭되거나 열릴 때마다 계산합니다.

### 이메일 수명 주기

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant ESP
    participant Inbox
    participant User

    %% -----------------------------
    %% Metrics when sending to ESP
    %% -----------------------------
    Note over OneSignal,User: ESP로 전송 시 지표

    OneSignal--xESP: 전달에서 제외됨 [억제됨]
    Note left of OneSignal: 전달 전 제외된 메시지

    OneSignal-->>ESP: 이메일 전송
    ESP-->>OneSignal: 오류 응답 [실패]
    Note left of OneSignal: ESP로 전송 실패

    %% -----------------------------
    %% Metrics reported by ESP
    %% -----------------------------
    Note over OneSignal,User: ESP가 보고한 지표

    OneSignal->>ESP: 이메일 전송
    ESP->>OneSignal: ESP가 수락함 [전송됨]
    Note left of OneSignal: ESP로 성공적으로 전달됨

    ESP-->>Inbox: 받은편지함으로 전달 시도
    Inbox-->>OneSignal: 전달 실패 [실패 / 반송됨]
    Note left of OneSignal: 받은편지함으로 전달 실패

    ESP->>Inbox: 이메일 전달
    Inbox->>OneSignal: 받은편지함으로 전달 확인됨 [전달됨]
    Note left of OneSignal: 받은편지함으로 성공적으로 전달됨

    %% -----------------------------
    %% Metrics reported by User
    %% -----------------------------
    Note over OneSignal,User: 사용자가 보고한 지표
    %% Metrics reported to ESP then OS

    Inbox->>User: 이메일 표시됨
    User->>OneSignal: 참여 이벤트 [열림 / 클릭됨 / 구독 취소됨 / 스팸으로 보고됨]
    Note left of OneSignal: 사용자 참여
```

### 이메일 지표 매핑

| 용어       | 대시보드 - 전달 보고서 통계 카드 | 대시보드 - 전달 보고서 시계열 차트 | 대시보드 - Journey 노드 보고서 통계 카드 | 대시보드 - Journey 노드 보고서 시계열 차트 | 대시보드 - 대상 활동 | 대시보드 - 참여 트렌드 | 메시지 보기 API                                     | 알림 CSV                | Event Streams                    |
| -------- | ------------------- | -------------------- | --------------------------- | ---------------------------- | ------------ | ------------- | ---------------------------------------------- | --------------------- | -------------------------------- |
| 전송됨      | 전송됨                 | 전송됨                  | ❌                           | 전송됨                          | 전송됨          | ❌             | platform\_delivery\_stats.email.successful     | successful            | message.email.sent               |
| 대상       | 대상                  | ❌                    | ❌                           | ❌                            | ❌            | ❌             | ❌                                              | ❌                     | ❌                                |
| 전달됨      | 전달됨                 | 전달됨                  | 전달됨                         | 전달됨                          | 전달됨          | 전달됨           | platform\_delivery\_stats.email.received       | email\_delivered      | message.email.received           |
| 실패       | 실패                  | 실패                   | 실패                          | 실패                           | 실패           | ❌             | platform\_delivery\_stats.email.failed         | email\_failed         | message.email.failed             |
| 억제됨      | 억제됨                 | 억제됨                  | 억제됨                         | 억제됨                          | 억제됨          | ❌             | platform\_delivery\_stats.email.suppressed     | ❌                     | message.email.suppressed         |
| 반송됨      | 반송됨                 | 반송됨                  | 반송됨                         | 반송됨                          | 반송됨          | ❌             | platform\_delivery\_stats.email.bounced        | email\_bounced        | message.email.bounced            |
| 스팸으로 보고됨 | 스팸으로 보고됨            | 스팸                   | 스팸으로 보고됨                    | 스팸                           | 불만 접수됨       | ❌             | platform\_delivery\_stats.email.reported\_spam | email\_reported\_spam | message.email.reported\_as\_spam |
| 구독 취소됨   | 구독 취소됨              | 구독 취소됨               | 구독 취소됨                      | 구독 취소됨                       | 구독 취소됨       | 구독 취소됨        | platform\_delivery\_stats.email.unsubscribed   | email\_unsubscribed   | message.email.unsubscribed       |
| 총 열림 수   | 총 열림 수              | 총 열림 수               | 총 열림 수                      | 총 열림 수                       | ❌            | ❌             | platform\_delivery\_stats.email.opened         | email\_opened         | message.email.opened             |
| 총 클릭 수   | 총 클릭 수              | 총 클릭 수               | 총 클릭 수                      | 총 클릭 수                       | ❌            | ❌             | platform\_delivery\_stats.email.clicked        | email\_clicked        | message.email.clicked            |
| 고유 열림 수  | 고유 열림 수             | 고유 열림 수              | 고유 열림 수                     | 고유 열림 수                      | 열림           | 열림            | platform\_delivery\_stats.email.unique\_opens  | email\_unique\_opens  | ❌                                |
| 고유 클릭 수  | 고유 클릭 수             | 고유 클릭 수              | 고유 클릭 수                     | 고유 클릭 수                      | 클릭됨          | 클릭됨           | platform\_delivery\_stats.email.unique\_clicks | email\_unique\_clicks | ❌                                |

## SMS 용어

1. **전송됨**: Twilio로 성공적으로 전송된 메시지 수입니다.
2. **총 시도 수**: 전송을 시도한 전화번호 수입니다. 여기에는 Twilio로 성공적으로 전송된 메시지와 실패가 포함됩니다. 이는 **파생** 지표이며 제공업체로 전송을 시도하는 동안 성공, 실패 및 오류의 합계입니다. 이는 억제된 메시지를 포함하지 않으므로 대상의 **하위 집합**입니다.
3. **대상**: 타겟팅된 세그먼트의 구독 수입니다.
4. **전달됨**: Twilio가 보고한 성공적인 메시지 전달 수입니다. 확인된 전달 지표는 SMS/MMS와 RCS를 구분하기 위해 추가로 분류됩니다.
5. **실패**: Twilio로 전송하지 못한 메시지 수입니다.
6. **억제됨**: 수신자가 발신자로부터 메시지 수신을 거부했기 때문에 수신자에게 전송되지 않은 메시지 수입니다.
7. **거부됨**: 번호 차단, 속도 차단 또는 수신자가 차단 목록에 있어 통신사가 전달하지 않은 메시지 수입니다. 이는 **파생** 지표이며 제공업체 오류 및 제공업체 실패의 합계입니다.
8. **제공업체 오류 발생**: 이 숫자는 Twilio가 메시지 전송에 실패한 전화번호를 계산합니다.
9. **제공업체 미전달**: Twilio가 메시지를 보냈지만 전달하지 못한 전화번호를 계산합니다.
10. **읽음**: RCS 메시지를 읽은 수신자 수입니다.
11. **총 클릭 수**: 메시지의 링크가 클릭된 총 횟수입니다. 단일 링크가 여러 번 클릭된 경우를 포함합니다.
12. **고유 클릭 수**: 메시지의 모든 링크에 걸친 고유 링크 클릭 수입니다. 이는 구독자당 고유합니다.
13. **답변됨**: 동의 키워드를 제외하고 OneSignal이 수신한 키워드 수입니다.
14. **구독 취소됨**: OneSignal이 수신한 거부 키워드 수입니다.

### SMS 수명 주기

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant Twilio
    participant Device
    participant User

    %% -----------------------------
    %% Metrics before message goes to provider
    %% -----------------------------
    Note over OneSignal,User: 메시지가 제공업체로 이동하기 전 지표

    OneSignal--xTwilio: 전달에서 제외됨 [억제됨]
    Note left of OneSignal: 전달 전 제외된 메시지

    OneSignal-->>Twilio: SMS 전송
    Twilio-->>OneSignal: 오류 응답 [실패]
    Note left of OneSignal: 제공업체로 전송 실패

    %% -----------------------------
    %% Metrics reported by Twilio
    %% -----------------------------
    Note over OneSignal,User: Twilio가 보고한 지표

    OneSignal->>Twilio: SMS 전송
    Twilio->>OneSignal: Twilio가 수락함 [전송됨]
    Note left of OneSignal: 제공업체로 성공적으로 전달됨

    Twilio-->>Device: 기기로 전달 시도
    Device-->>OneSignal: 기기로 전달 실패 [거부됨]
    Note left of OneSignal: 기기로 전달 실패

    Twilio->>Device: SMS 전달
    Device->>OneSignal: 전달 확인됨 [전달됨]
    Note left of OneSignal: 기기로 성공적으로 전달됨

    %% -----------------------------
    %% Metrics reported by user
    %% -----------------------------
    Note over OneSignal,User: 사용자가 보고한 지표
    %% Metrics reported to Twilio then OS

    Device->>User: SMS 표시됨
    User->>OneSignal: 참여 이벤트 [읽음 / 클릭됨]
    Note left of OneSignal: 사용자 참여
```

### SMS 지표 매핑

| 용어         | 대시보드 - 전달 보고서 통계 카드 | 대시보드 - 전달 보고서 시계열 차트 | 대시보드 - Journey 노드 보고서 통계 카드 | 대시보드 - Journey 노드 보고서 시계열 차트 | 대시보드 - 대상 활동 | 대시보드 - 참여 트렌드 | 메시지 보기 API                                                                              | 알림 CSV                      | Event Streams           |
| ---------- | ------------------- | -------------------- | --------------------------- | ---------------------------- | ------------ | ------------- | --------------------------------------------------------------------------------------- | --------------------------- | ----------------------- |
| 전송됨        | ❌                   | 전송됨                  | ❌                           | 전송됨                          | 전송됨          | ❌             | platform\_delivery\_stats.sms.successful                                                | successful                  | message.sms.sent        |
| 총 시도 수     | 전송됨<sup>1</sup>     | ❌                    | 전송됨<sup>1</sup>             | ❌                            | ❌            | ❌             | ❌                                                                                       | ❌                           | ❌                       |
| 대상         | 대상                  | ❌                    | ❌                           | ❌                            | ❌            | ❌             | ❌                                                                                       | ❌                           | ❌                       |
| 전달됨        | 전달됨                 | 전달됨                  | 전달됨                         | 전달됨                          | 전달됨          | 전달됨           | platform\_delivery\_stats.sms.provider\_successful                                      | ❌                           | message.sms.delivered   |
| 실패         | 실패                  | ❌                    | 실패                          | ❌                            | 실패 및 거부됨     | ❌             | platform\_delivery\_stats.sms.failed, platform\_delivery\_stats.sms.errored<sup>2</sup> | failed, errored<sup>2</sup> | message.sms.failed      |
| 억제됨        | 억제됨                 | ❌                    | 억제됨                         | ❌                            | 억제됨          | ❌             | platform\_delivery\_stats.sms.suppressed                                                | ❌                           | ❌                       |
| 거부됨        | 거부됨                 | ❌                    | 거부됨                         | ❌                            | 실패 및 거부됨     | ❌             | ❌                                                                                       | ❌                           | ❌                       |
| 제공업체 오류 발생 | ❌                   | 실패 (오류 발생)           | ❌                           | 실패 (오류 발생)                   | ❌            | ❌             | platform\_delivery\_stats.sms.provider\_errored                                         | ❌                           | ❌                       |
| 제공업체 미전달   | ❌                   | 실패 (미전달)             | ❌                           | 실패 (미전달)                     | ❌            | ❌             | platform\_delivery\_stats.sms.provider\_failed                                          | ❌                           | message.sms.undelivered |
| 읽음         | 읽음                  | 읽음                   | 읽음                          | 읽음                           | 읽음           | 읽음            | ❌                                                                                       | ❌                           | ❌                       |
| 총 클릭 수     | 총 클릭 수              | ❌                    | 총 클릭 수                      | ❌                            | ❌            | ❌             | ❌                                                                                       | ❌                           | ❌                       |
| 고유 클릭 수    | 고유 클릭 수             | ❌                    | 고유 클릭 수                     | ❌                            | ❌            | ❌             | ❌                                                                                       | ❌                           | ❌                       |
| 답변됨        | ❌                   | ❌                    | ❌                           | ❌                            | ❌            | 답변됨 (키워드)     | ❌                                                                                       | ❌                           | ❌                       |
| 구독 취소됨     | ❌                   | ❌                    | ❌                           | ❌                            | ❌            | 구독 취소됨        | ❌                                                                                       | ❌                           | ❌                       |

<sup>1</sup> OneSignal 대시보드는 이를 총 시도 수로 해석하고 OneSignal에서 전송된 알림 수와 OneSignal 내부 시스템에서 실패하거나 오류가 발생한 알림 수를 합산합니다.

<sup>2</sup> **실패** 및 **오류 발생**의 합계로, 둘 다 Twilio로 전송을 시도할 때 OneSignal의 내부 시스템에 기록되며 결과는 **실패**입니다.

## 인앱 용어

1. **노출 수**: 메시지가 기기에 성공적으로 표시된 횟수입니다.
2. **카드 노출 수**: 캐러셀이 기기에 표시된 횟수입니다. 캐러셀에만 적용됩니다.
3. **총 클릭 수**: 버튼 블록, 이미지 블록 또는 배경이 클릭된 횟수입니다.
4. **고유 클릭 수**: 버튼 블록, 이미지 블록 또는 배경이 처음 클릭된 횟수입니다. "닫기 버튼" 클릭은 포함되지 않습니다.

### 인앱 수명 주기

고려해야 할 전달 수명 주기가 없습니다. 인앱 메시지에 대해 캡처된 모든 지표는 OneSignal SDK를 통해 기기에서 가져옵니다.

### 인앱 지표 매핑

| 용어      | 대시보드 - 전달 보고서 통계 카드 | 대시보드 - Journey 노드 보고서 통계 카드 | 대시보드 - Journey 노드 보고서 시계열 차트 | 대시보드 - 대상 활동 | 대시보드 - 참여 트렌드 | Event Streams               |
| ------- | ------------------- | --------------------------- | ---------------------------- | ------------ | ------------- | --------------------------- |
| 노출 수    | 노출 수                | 노출 수                        | 노출 수                         | 노출           | 노출 수          | message.iam.impression      |
| 카드 노출 수 | 카드 노출 수             | 카드 노출 수                     | ❌                            | ❌            | ❌             | message.iam.page\_displayed |
| 총 클릭 수  | 총 클릭 수<sup>1</sup>  | 총 클릭 수<sup>1</sup>          | ❌                            | ❌            | ❌             | message.iam.clicked         |
| 고유 클릭 수 | ❌<sup>2</sup>       | ❌<sup>2</sup>               | ❌                            | 클릭됨          | 클릭됨           | ❌                           |

<sup>1</sup> IAM 전달 보고서 통계 카드의 총 클릭 수에서 "닫기 버튼" 클릭을 필터링합니다.

<sup>2</sup> 대시보드에 고유 클릭 수에 대한 레이블이 없지만 CTR과 함께 고유 클릭 수를 표시합니다.

## 라이브 활동 용어

1. **전송됨**: OneSignal에서 제공업체로 성공적으로 전송된 메시지 수입니다.
2. **총 시도 수**: 전송을 시도한 메시지 수입니다. 여기에는 푸시 제공업체로 성공적으로 전송된 메시지와 실패가 포함됩니다. 이는 **파생** 지표이며 제공업체로 전송을 시도하는 동안 성공, 실패 및 오류의 합계입니다.
3. **전달됨**: 알림을 받은 것으로 확인된 푸시 구독 수입니다.
4. **구독 취소됨**: 앱을 제거하거나, 브라우저 데이터를 지우거나, 푸시를 거부하고 이후 앱을 열지 않아 메시지를 받지 못한 푸시 구독 수입니다. 향후 메시지에서 이러한 구독으로 전송을 시도하지 **않습니다**.
5. **실패**: 오류로 인해 알림을 받지 못한 푸시 구독 수입니다. 향후 메시지에서 이러한 구독으로 전송을 시도합니다.

### 라이브 활동 수명 주기

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant Provider
    participant Device

    %% -----------------------------
    %% Metrics before message goes to provider
    %% -----------------------------
    Note over OneSignal,Device: 메시지가 제공업체로 이동하기 전 지표

    Note left of OneSignal: 제공업체로 전송 실패
    OneSignal-->>Provider: 라이브 활동 업데이트 전송
    Provider-->>OneSignal: 오류 응답 [실패 / 구독 취소됨]

    %% -----------------------------
    %% Metrics reported by push provider
    %% -----------------------------
    Note over OneSignal,Device: 푸시 제공업체가 보고한 지표

    Note left of OneSignal: 제공업체로 성공적으로 전달됨
    OneSignal->>Provider: 라이브 활동 업데이트 전송
    Provider->>OneSignal: 제공업체가 수락함 [전송됨]

    Note left of OneSignal: 기기로 성공적으로 전달됨
    Provider->>Device: 라이브 활동 업데이트 전달
```

### 라이브 활동 지표 매핑

| 용어     | 대시보드 - 전달 보고서 통계 카드 | 대시보드 - 대상 활동 | 대시보드 - 참여 트렌드 | 메시지 보기 API | 알림 CSV     | Event Streams                       |
| ------ | ------------------- | ------------ | ------------- | ---------- | ---------- | ----------------------------------- |
| 총 시도 수 | 전송됨                 | ❌            | ❌             | ❌          | ❌          | ❌                                   |
| 전송됨    | 전달됨                 | 전달됨          | 전달됨           | successful | successful | message.live\_activity.sent         |
| 전달됨    | ❌                   | ❌            | 확인됨           | ❌          | ❌          | message.live\_activity.delivered    |
| 실패     | 실패                  | 실패           | 실패            | errored    | errored    | message.live\_activity.failed       |
| 구독 취소됨 | 구독 취소됨              | 구독 취소됨       | 구독 취소됨        | failed     | failed     | message.live\_activity.unsubscribed |
| 클릭됨    | ❌                   | ❌            | ❌             | ❌          | ❌          | message.live\_activity.clicked      |

***
