> ## 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에서 Liquid 개인화 및 집계 성능 지표를 활용해 푸시 알림, 이메일, SMS용 재사용 가능한 템플릿을 만들고, 전송하고, 추적하세요.

템플릿은 푸시 알림, 이메일, SMS 메시지용 재사용 가능한 청사진입니다. 일관된 메시지를 보장하고 전송 전반의 성능 지표를 중앙화합니다. 템플릿은 **자주 전송**되는 **이벤트 기반** 또는 **트랜잭션** 메시지에 특히 유용합니다.

<Card title="템플릿 분석" icon="chart-bar" href="./template-analytics">
  각 템플릿의 전달 통계, 참여 지표, 수신자별 활동을 검토합니다.
</Card>

***

## 템플릿 생성

템플릿은 여러 가지 방법으로 생성할 수 있습니다:

<Columns cols={2}>
  <Card title="대시보드" icon="browser">
    **Messages > Templates**로 이동하여 **New Template**을 클릭하세요.
  </Card>

  <Card title="API" icon="code" href="/reference/create-template">
    Create Template API를 사용하여 프로그래밍 방식으로 템플릿을 생성합니다.
  </Card>

  <Card title="이메일 템플릿 전달" icon="envelope" href="./email-template-forwarding">
    다른 이메일 플랫폼에서 이메일 템플릿을 마이그레이션합니다.
  </Card>

  <Card title="앱 간 복사" icon="copy" href="/reference/copy-template-to-another-app">
    OneSignal 앱 간에 템플릿을 복사합니다(일회성 복사, 실시간 동기화 아님).
  </Card>
</Columns>

### 디자인 가이드라인

템플릿은 [고급 개인화](./message-personalization)를 위해 [Liquid 구문](./using-liquid-syntax)을 지원하여 동적이고 사용자별 콘텐츠를 삽입할 수 있습니다.

채널별 모범 사례는 다음을 참조하세요:

<Columns cols={2}>
  <Card title="푸시 알림 디자인" icon="bell" href="./push">
    푸시 알림 디자인, 기능, 플랫폼 옵션.
  </Card>

  <Card title="SMS 메시징" icon="comment-sms" href="./sms-messaging">
    SMS 디자인, 기능, 규정 준수 요건.
  </Card>

  <Card title="이메일 HTML 디자인" icon="code" href="./design-emails-with-html">
    완전한 HTML 및 CSS 제어로 이메일을 구축합니다.
  </Card>

  <Card title="이메일 드래그 앤 드롭 디자인" icon="pen-ruler" href="./design-emails-with-drag-and-drop">
    드래그 앤 드롭 편집기로 이메일을 시각적으로 구축합니다.
  </Card>
</Columns>

***

## 템플릿을 사용하여 메시지 전송

다음과 같은 여러 가지 방법으로 템플릿을 전송할 수 있습니다:

* **작성 화면에서:** 대시보드에서 새 메시지를 생성할 때 템플릿에서 시작하도록 선택합니다.
* **템플릿 페이지에서:** **Messages > Templates**로 이동하여 **Options(점 3개) > New Message**를 선택합니다.
* **API:** [전송 요청](/reference/create-message)에 `template_id`를 포함합니다.

<Note>
  SMS/RCS 템플릿의 경우 발신자를 선택하면 표시되는 편집기가 해당 발신자에 따라 달라집니다. 발신자에 RCS 리소스가 있으면 RCS 편집기가, 그렇지 않으면 SMS 편집기가 표시됩니다. 승인된 RCS 리소스가 있는 발신자를 선택하면 OneSignal은 해당 발신자를 사용하는 모든 기존 자동화에 대해 자동으로 RCS를 우선합니다. 기존 SMS 콘텐츠가 RCS로 어떻게 매핑되는지는 [기존 자동화를 RCS로 업그레이드](./sms-composing-messages#upgrading-existing-automations-to-rcs)를 참조하세요.
</Note>

### 템플릿 ID

Each template has a unique OneSignal-generated `template_id` (UUID v4). You can find it:

* Using the [View Templates API](/reference/view-templates)
* In the OneSignal Dashboard under **Messages > Templates > Options > Copy Template ID**

<Frame caption="Copy Template ID">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/templates/copy-template-id.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=b1b94df3f7ad6cdc5dc985e5c2f7ffeb" alt="Copy Template ID in OneSignal Dashboard" width="2208" height="1038" data-path="images/dashboard/templates/copy-template-id.png" />
</Frame>

***

## 성능 추적

**Templates** 페이지는 템플릿을 사용하는 모든 전송에 걸친 집계 생애주기 성능을 표시합니다.

| 열             | 설명                                                |
| ------------- | ------------------------------------------------- |
| **Name**      | 템플릿의 이름.                                          |
| **Labels**    | 템플릿을 그룹화하고 필터링하는 데 사용하는 [레이블](./labels).          |
| **Type**      | 푸시, 이메일 또는 SMS.                                   |
| **Last Sent** | 템플릿이 전송된 메시지에 마지막으로 사용된 날짜 및 시간.                  |
| **Delivered** | 총 성공 전달 수(채널에 따라 푸시 서버, 수신자 받은 편지함, 또는 SMS 통신사로). |
| **Opened**    | 이메일 총 열람 횟수(반복 열람 포함). 푸시 또는 SMS에는 적용되지 않습니다.     |
| **Clicked**   | 알림 또는 이메일/SMS 내 링크에 대한 총 클릭 수.                    |
| **CTR**       | (Clicked ÷ Delivered) × 100%.                     |

전송별 전달 통계, 참여 분석, 청중 활동은:

<Card title="템플릿 분석" icon="chart-bar" href="./template-analytics">
  채널별 지표와 내보내기 가능한 청중 데이터가 포함된 자세한 템플릿 보고서.
</Card>

***

## 템플릿 업데이트

다음을 통해 템플릿을 업데이트할 수 있습니다:

* **대시보드:** **Messages > Templates > Options > Edit**로 이동합니다.
* **API:** [Update Template API](/reference/update-template)를 사용합니다.

템플릿 업데이트는 성능 통계를 초기화하지 않습니다. 새 링크는 기존 데이터와 함께 추적되고 집계됩니다.

템플릿 필드는 메시지별로 재정의할 수 있습니다. 템플릿을 시작점으로 사용하고 전송 전에 콘텐츠를 업데이트할 수 있습니다.

예를 들어 푸시 템플릿에 설정된 메시지가 있고 새 `content`와 함께 [푸시 생성 API](/reference/push-notification)를 사용하면 해당 전송에 한해서만 템플릿 메시지를 재정의합니다.

***

## 템플릿 삭제

다음을 통해 템플릿을 삭제할 수 있습니다:

* **대시보드:** **Messages > Templates > Options > Delete**로 이동합니다.
* **API:** [Delete Template API](/reference/delete-template)를 사용합니다.

<Warning>
  템플릿이 삭제되면 연결된 모든 데이터가 삭제되며 복구할 수 없습니다.

  Journey 내에서 사용되는 템플릿은 삭제할 수 없습니다. Journey를 삭제하거나 Journey에서 템플릿을 제거하세요.
</Warning>

***

## FAQ

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

템플릿 콘텐츠는 삭제할 때까지 템플릿의 생애주기 동안 저장됩니다. **Templates** 페이지의 집계 분석도 생애주기 데이터입니다. 개별 전송 수준 분석은 플랜의 보존 정책을 따릅니다. 자세한 내용은 [템플릿 분석](./template-analytics)을 참조하세요.

### 앱 간에 템플릿을 복제할 수 있나요?

예. 모든 템플릿 유형에 대해 [앱 간 템플릿 복사 API](/reference/copy-template-to-another-app)를 사용합니다. 이메일의 경우 [이메일 템플릿 전달](./email-template-forwarding)도 사용할 수 있습니다.

### 템플릿을 업데이트하면 과거 메시지에 영향을 주나요?

아니요. 과거 메시지는 전송 당시의 콘텐츠를 유지합니다. 업데이트된 템플릿은 향후 전송에만 사용됩니다. 성능 통계는 초기화되지 않습니다.

### 여러 채널에 동일한 템플릿을 사용할 수 있나요?

아니요. 각 템플릿은 푸시, 이메일, 또는 SMS의 단일 채널에 연결됩니다. 각 채널에 대해 별도의 템플릿을 만드세요.

### API를 통해 전송할 때 템플릿 콘텐츠를 재정의할 수 있나요?

예. `template_id`와 함께 [메시지 생성](/reference/create-message) 요청에 `contents`, `headings`, 또는 `email_body` 같은 필드를 포함합니다. API 필드는 해당 전송에 한해서만 대응하는 템플릿 필드를 재정의합니다.

## 관련 페이지

<Columns cols={2}>
  <Card title="메시지 개인화" icon="user-pen" href="./message-personalization">
    태그, Liquid 구문, 커스텀 이벤트 속성으로 템플릿을 개인화합니다.
  </Card>

  <Card title="Liquid 구문" icon="code" href="./using-liquid-syntax">
    OneSignal 메시지에서 Liquid 템플릿에 대한 전체 참조.
  </Card>

  <Card title="Journey" icon="route" href="./journeys-overview">
    자동화된 멀티채널 메시지 플로우에서 템플릿을 사용합니다.
  </Card>

  <Card title="레이블" icon="tag" href="./labels">
    커스텀 레이블로 템플릿을 정리하고 필터링합니다.
  </Card>
</Columns>