> ## 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에서 푸시 알림, 이메일, SMS 템플릿의 전달 통계, 참여 지표, 청중 활동을 검토합니다.

템플릿 분석은 푸시 알림, 이메일, SMS 템플릿의 성능(전달률, 참여 지표, 수신자별 활동)을 파악하는 데 도움이 됩니다. 대시보드에서 템플릿을 클릭하면 템플릿 보고서가 열립니다. 템플릿을 수정하려면 **편집**을 클릭하세요.

<Note>
  데이터 보존은 2025년 4월 16일에 시작되었습니다. 보고서는 [가격 플랜](https://onesignal.com/pricing)에 따라 최대 2년 동안 템플릿 분석을 저장합니다.
</Note>

***

## 템플릿 분석 액세스 및 사용 방법

<Steps>
  <Step title="템플릿으로 이동">
    OneSignal 대시보드에서 **Messages > Templates**로 이동하세요.

    사용 중인 템플릿을 선택하거나 새 템플릿을 만들고 테스트 메시지를 보내세요.
  </Step>

  <Step title="분석 및 통계 검토">
    템플릿 보고서는 채널(푸시, 이메일 또는 SMS)별로 구성된 주요 성능 지표 및 전달 통계를 표시합니다.

    이러한 지표를 사용하여 참여를 모니터링하고 전달 문제를 해결하며 템플릿 효과를 평가하세요.
  </Step>

  <Step title="데이터 편집 또는 내보내기">
    템플릿을 수정하려면 보고서 상단의 **편집**을 클릭하세요.

    **내보내기** 버튼을 사용하여 자세한 활동 로그를 다운로드하세요.
  </Step>
</Steps>

***

## 채널별 템플릿 통계

각 메시징 채널은 전달 및 참여를 이해하는 데 도움이 되는 고유한 채널별 분석을 제공합니다. 다음은 각 채널에 사용 가능한 지표의 요약입니다. 모든 채널의 전체 지표 정의는 [지표 용어집](./analytics-metrics-glossary)을 참조하세요.

<Tabs>
  <Tab title="푸시">
    #### 통계 요약

    | 이름             | 설명                                                                                                |
    | -------------- | ------------------------------------------------------------------------------------------------- |
    | 전달됨            | 푸시 서버(FCM, APNs, HMS)에 성공적으로 전송된 메시지 수.                                                           |
    | 클릭률 (CTR)      | (총 클릭 수 / 전달됨) × 100%.                                                                            |
    | 확인된 클릭률 (CCTR) | (총 클릭 수 / 확인된 전달) × 100%.                                                                         |
    | 영향을 받은 열람      | 영향 시간 내에 알림을 직접 클릭하지 않고 앱을 열었던 사용자. **Settings > Push & In-app > Influenced Opens**에서 구성할 수 있습니다. |

    #### 전달 통계

    | 이름     | 설명                                                                                                                                                                                                       |
    | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | 전송됨    | OneSignal에서 전송된 총 메시지 수(실패 포함).                                                                                                                                                                          |
    | 전달됨    | 푸시 서버(FCM, APNs, HMS)에 성공적으로 전송된 메시지 수.                                                                                                                                                                  |
    | 확인됨    | 전달 확인을 반환한 기기 수. 여러 요인이 이 수에 영향을 줄 수 있습니다 — [확인된 전달](./confirmed-delivery)을 참조하세요.                                                                                                                       |
    | 구독 취소됨 | 도달할 수 없는 기기 수(일반적으로 푸시 권한이 취소되었기 때문). 감지된 기기는 구독 취소로 표시되어 향후 전송에서 제외됩니다. 오래된 토큰도 만료될 수 있습니다 — [FCM 만료 토큰](./fcm-expired-token-faq)과 [구독 취소 원인](./push-notification-message-reports#unsubscribed)을 참조하세요. |
    | 실패함    | 오류로 인해 메시지를 전송할 수 없었습니다. 일반적인 원인은 [푸시 오류 참조](./push-notification-message-reports#failed)를 참조하세요.                                                                                                         |
    | 남음     | 전송 대기 중인 알림 수.                                                                                                                                                                                           |
    | 제한됨    | [빈도 제한](./frequency-capping)으로 인해 전송되지 않은 알림 수.                                                                                                                                                          |

    #### 전환 통계

    <Info>
      **출시 예정** — [전환 지표](./conversion-metrics)가 템플릿 보고서에서 제공될 예정입니다. 출시되면 이 템플릿에서 전송된 모든 메시지에 걸쳐 집계된 귀속된 전환과 영향 받은 전환을 확인할 수 있습니다.
    </Info>

    #### 결과 통계 (레거시)

    <Warning>사용자 지정 Outcomes는 더 이상 사용되지 않으며 [전환 지표](./conversion-metrics)로 대체됩니다.</Warning>

    | 이름        | 설명                                                                                                                       |
    | --------- | ------------------------------------------------------------------------------------------------------------------------ |
    | 클릭        | 푸시 메시지에 대한 직접 클릭/열람 수. 항상 직접 귀속으로 측정됩니다.                                                                                 |
    | 확인된 전달    | 전달 확인을 반환한 기기 수. [확인된 전달](./confirmed-delivery)을 참조하세요. [유료 플랜 필요](https://onesignal.com/pricing).                       |
    | 세션        | 이 푸시에 귀속된 앱 세션의 횟수 또는 누적 시간(초). 앱이 30초 이상 포커스를 벗어난 후에만 새 세션이 시작됩니다. [Professional 플랜 필요](https://onesignal.com/pricing). |
    | 사용자 지정 결과 | 구매 금액이나 사용자 액션 등 앱 코드에서 구성된 사용자 지정 지표. [사용자 지정 결과](./custom-outcomes)를 참조하세요.                                            |
  </Tab>

  <Tab title="이메일">
    #### 통계 요약

    | 이름        | 설명                                                                                                           |
    | --------- | ------------------------------------------------------------------------------------------------------------ |
    | 열람률       | (고유 열람 수 / 전달됨) × 100%. 사용자 개인정보 설정이 열람 추적에 영향을 줄 수 있습니다 — [열람 이벤트가 낮은 이유는 무엇인가요?](#why-are-open-events-low) |
    | 클릭률 (CTR) | (고유 클릭 수 / 전달됨) × 100%. [클릭 추적이 활성화되어야 합니다](./unsubscribe-links-email-subscriptions).                        |
    | 구독 취소     | 이 이메일의 구독 취소 링크를 통해 수신을 거부한 수신자 수. 구독은 즉시 구독 취소로 표시됩니다.                                                      |

    #### 전달 통계

    | 이름     | 설명                                                                                                                                   |
    | ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
    | 청중     | 전송 시 청중에 포함된 이메일 주소 수.                                                                                                               |
    | 전송됨    | OneSignal에서 전송된 총 메시지 수.                                                                                                             |
    | 전달됨    | 수신자의 받은 편지함으로 성공적으로 전달된 것으로 확인된 메시지 수.                                                                                               |
    | 남음     | 전송 대기 중인 메시지 수.                                                                                                                      |
    | 총 클릭 수 | 동일 링크에 대한 반복 클릭을 포함한 총 링크 클릭 수. [URL, 링크 및 딥 링크](./links)를 참조하세요.                                                                    |
    | 총 열람 수 | 반복 열람을 포함한 이메일 총 열람 횟수. 개인정보 설정이 이에 영향을 줄 수 있습니다 — [열람 이벤트가 낮은 이유는 무엇인가요?](#why-are-open-events-low)                                 |
    | 구독 취소됨 | 구독 취소 링크를 통해 수신을 거부한 수신자 수. 구독은 즉시 구독 취소로 표시됩니다.                                                                                     |
    | 반송됨    | 이메일을 전달할 수 없었습니다 — 일반적인 원인으로 잘못된 주소, 받은 편지함 가득 참, 낮은 발신자 평판 또는 제한적인 DMARC 레코드가 있습니다. 반송된 주소는 [차단 목록](./email-deliverability)에 추가됩니다. |
    | 실패함    | OneSignal이 이메일을 전달할 수 없어 메시지를 삭제했습니다. [이메일이 실패로 표시되는 이유는 무엇인가요?](#why-are-my-emails-marked-as-failed)                                |
    | 차단됨    | 이전 스팸 신고 또는 반송으로 인해 발신자 평판을 보호하기 위해 전송되지 않은 이메일. [OneSignal 이메일](./email-setup) 전용.                                                  |
  </Tab>

  <Tab title="SMS">
    #### 요약 통계

    | 이름       | 설명                        |
    | -------- | ------------------------- |
    | 전달률      | (총 전달 수 ÷ 총 전송 수) × 100%. |
    | 실패 및 거부율 | (총 실패 수 ÷ 총 전송 수) × 100%. |

    #### 전달 통계

    | 이름  | 설명                                                                              |
    | --- | ------------------------------------------------------------------------------- |
    | 청중  | 전송 시 청중에 포함된 전화번호 수.                                                            |
    | 전송됨 | 메시지가 통신사에 성공적으로 전송되었습니다. *이것이 반드시 사용자가 이러한 메시지를 받았다는 것을 의미하지는 않습니다.*            |
    | 전달됨 | OneSignal이 통신사로부터 메시지 전달 확인을 받았습니다. *이것이 반드시 수신자가 이러한 메시지를 받았다는 것을 의미하지는 않습니다.* |
    | 실패함 | 메시지를 보내지 못했습니다.                                                                 |
    | 차단됨 | 수신자가 발신자로부터 메시지 수신을 거부했기 때문에 메시지가 수신자에게 전송되지 않았습니다.                             |
    | 거부됨 | 번호 차단, 속도 차단 또는 수신자가 차단 목록에 있어 통신사가 메시지를 전달하지 않았습니다.                            |
  </Tab>
</Tabs>

***

## 청중 활동

청중 활동 보고서는 각 수신자의 메시지 참여에 대한 자세한 분석을 제공합니다. 이를 통해 리타겟팅을 위해 사용자를 세분화하고 구독 상태를 이해할 수 있습니다.

<Tabs>
  <Tab title="푸시">
    * 각 기기 구독 및 전달 결과(전송됨, 확인됨, 클릭됨, 실패함, 구독 취소됨 등)를 나열합니다.
    * **내보내기**를 클릭하여 전체 구독 목록을 다운로드하세요.
    * 라인 항목 중 하나의 기기 열에 "()"가 있으면 이 구독이 삭제되었음을 의미합니다.
  </Tab>

  <Tab title="이메일">
    각 이메일 주소 구독의 상태(전달됨, 열림, 클릭됨, 구독 취소됨, 반송됨, 실패함, 불만 신고됨)를 표시합니다. 타임스탬프는 가장 최근 이벤트를 반영합니다.

    * 실패 메시지 이유를 포함한 모든 정보에 대한 활동 데이터를 **내보내기**합니다.
    * 활동 데이터를 기반으로 사용자를 **리타겟팅**하여 후속 조치를 취합니다. 자세한 내용은 [메시지 리타겟팅](./retargeting)을 참조하세요.
  </Tab>

  <Tab title="SMS">
    청중 활동은 SMS를 전송, 전달 또는 수신 실패한 구독 목록을 표시합니다. 자세한 내용은 [메시지 리타겟팅](./retargeting)을 참조하세요.
  </Tab>
</Tabs>

<Warning>
  모든 채널의 경우 청중 활동은 메시지가 표시된 시점부터 30일 동안 사용할 수 있습니다.
</Warning>

***

## FAQ

### 템플릿 데이터는 얼마나 오래 저장되나요?

템플릿 데이터는 표준 분석 데이터 보존 정책을 따릅니다(플랜에 따라 최대 2년). 플랜별 세부 정보는 [분석 데이터 보존](./billing-faq#analytics-data-retention)을 참조하세요.

### 열람 이벤트가 낮은 이유는 무엇인가요?

이메일 열람 추적은 수신자가 이메일을 열 때 로드되는 추적 픽셀에 의존합니다. 많은 이메일 클라이언트와 개인정보 보호 기능(Apple Mail 개인정보 보호, Gmail 이미지 프록시)이 이 픽셀을 차단하거나 미리 가져와 열람 수가 낮게 보고될 수 있습니다. 클릭 추적은 일반적으로 참여 신호로서 더 신뢰할 수 있습니다.

### 이메일이 실패로 표시되는 이유는 무엇인가요?

"실패" 이메일은 OneSignal이 메시지를 전달할 수 없어 삭제했음을 의미합니다. 일반적인 원인은 다음과 같습니다:

* 수신자의 이메일 주소가 유효하지 않거나 잘못 입력됨
* 수신자의 받은 편지함이 가득 참
* 수신 서버가 메시지를 거부함(예: 콘텐츠 필터링 또는 발신자 평판)
* 전송 도메인의 DNS 또는 인증 문제(SPF, DKIM, DMARC)

높은 실패율이 보이면 [이메일 전달성 설정](./email-deliverability)과 전송 도메인 구성을 확인하세요.

### "차단됨"은 무슨 의미인가요?

차단된 메시지는 수신자가 이전에 이메일을 스팸으로 신고했거나 주소가 하드 반송되었기 때문에 OneSignal이 의도적으로 보류한 것입니다. 이를 통해 발신자 평판이 보호됩니다. 자세한 내용은 [차단 목록](./suppressions)을 참조하세요.

### 청중 활동 데이터를 내보낼 수 있나요?

예. 청중 활동 섹션의 **내보내기** 버튼을 클릭하여 실패 이유와 타임스탬프를 포함한 수신자별 전달 결과가 담긴 CSV를 다운로드하세요.

## 관련 페이지

<Columns cols={2}>
  <Card title="지표 용어집" icon="book" href="./analytics-metrics-glossary">
    모든 채널의 분석 지표에 대한 전체 정의.
  </Card>

  <Card title="메시지 보고서" icon="chart-bar" href="./push-notification-message-reports">
    개별 푸시 메시지의 전달 및 참여 보고서.
  </Card>

  <Card title="이메일 전달성" icon="envelope-circle-check" href="./email-deliverability">
    전달률을 높이고 반송, 스팸 신고, 발신자 평판을 관리합니다.
  </Card>

  <Card title="템플릿" icon="copy" href="./templates">
    채널 전반에 걸쳐 재사용 가능한 메시지 템플릿을 만들고 관리합니다.
  </Card>

  <Card title="확인된 전달" icon="circle-check" href="./confirmed-delivery">
    확인된 전달 추적의 작동 방식과 횟수에 영향을 미치는 요인.
  </Card>

  <Card title="빈도 제한" icon="gauge-high" href="./frequency-capping">
    피로를 줄이기 위해 사용자가 메시지를 받는 빈도를 제한합니다.
  </Card>
</Columns>