**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 푸시 알림 템플릿 생성
*푸시 알림 템플릿*은 Amazon Pinpoint 프로젝트에서 사용할 수 있는 콘텐츠 및 설정이 포함된 메시지 템플릿입니다. 템플릿을 사용하여 푸시 알림을 보내면 Amazon Pinpoint는 템플릿에서 정의한 내용과 설정으로 알림을 채웁니다.
푸시 알림 템플릿을 만들 때 템플릿을 기반으로 하는 푸시 알림의 다양한 구성 요소에서 재사용할 콘텐츠와 설정을 지정합니다. *템플릿 부분*이라고 하는 이러한 구성 요소는 알림의 제목이나 본문과 같은 텍스트나 수신자가 알림을 받을 때 재생할 사용자 지정 사운드와 같은 설정을 포함할 수 있습니다.
특정 푸시 알림 채널에 대한 템플릿을 사용자 정의하려면 각 템플릿에 여러 세트의 템플릿 부분(기본 세트)와 하나 이상의 서비스별 세트를 작성할 수 있습니다. 기본 세트에는 푸시 알림 채널에 기본적으로 사용할 내용과 설정이 포함되어 있습니다. 서비스별 세트에는 Apple Push Notification service 또는 Firebase Cloud Messaging과 같은 특정 알림 서비스에 사용하려는 모든 콘텐츠 및 설정이 포함됩니다. 템플릿에 서비스별 설정을 추가하여 수신자 디바이스 유형에 고유한 콘텐츠를 표시하도록 알림을 조정할 수 있습니다.
[원시 메시지 데이터가 포함된 템플릿을 생성](#message-templates-creating-push-raw)할 수도 있습니다. 이 옵션은 고급 옵션이지만 표준 Amazon Pinpoint 푸시 알림 템플릿에 없는 특정 채널의 설정을 지정하려는 경우에 유용합니다.
## 표준 푸시 알림 템플릿 생성
제목, 메시지 본문, 이미지, 작업 등의 기본 메시지 콘텐츠를 지정하려면 이 절차를 완료합니다. 원시 메시지 내용을 지정하려면 대신 [원시 메시지 데이터를 사용하여 푸시 알림 템플릿 생성](#message-templates-creating-push-raw)의 절차를 완료합니다.
**푸시 알림 템플릿을 만들려면 다음을 수행합니다.**
1. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)에서 Amazon Pinpoint 콘솔을 엽니다.
1. 탐색 창에서 **메시지 템플릿**을 선택합니다.
1. **템플릿 생성**을 선택합니다.
1. **채널**에서 **푸시 알림**을 선택합니다.
1. **템플릿 세부 정보**에서 **템플릿 이름**에 템플릿의 이름을 입력합니다. 이름은 문자 또는 숫자로 시작해야 합니다. 최대 128자까지 입력할 수 있습니다. 문자는 문자, 숫자, 밑줄(\$1) 또는 하이픈(-)일 수 있습니다.
1. (선택 사항) **버전 설명**에 템플릿에 대한 간단한 설명을 입력합니다. 설명은 최대 500자까지 입력할 수 있습니다.
1. **푸시 알림 세부 정보**에서 다음을 수행합니다.
+ **알림 유형**에서 **표준 메시지**를 선택합니다.
+ **제목**에 메시지 본문 위에 표시할 제목을 입력합니다.
+ **본문**에 알림 메시지 본문에 표시할 텍스트를 입력합니다.
**작은 정보**
템플릿 제목과 본문에 맞춤형 콘텐츠를 포함할 수 있습니다. 이렇게 하려면 사용자의 이름을 저장하는 속성 등 특정 속성을 참조하는 메시지 변수를 추가하세요. 메시지 변수를 사용하면 템플릿을 사용하는 푸시 알림 수신자마다 다른 콘텐츠를 표시할 수 있습니다.
메시지 변수를 사용하려면 **속성 파인더**에서 기존 속성의 이름을 선택합니다. Amazon Pinpoint는 속성에 대한 메시지 변수를 생성하여 클립보드에 복사합니다. 원하는 위치에 변수를 붙여넣습니다. 자세한 내용은 [메시지 템플릿에 맞춤형 콘텐츠 추가](message-templates-personalizing.md) 단원을 참조하십시오.
+ **사용자 지정 경고 사운드**의 경우 수신자가 푸시 알림을 받을 때 재생할 사용자 지정 사운드가 포함된 오디오 파일의 이름을 입력합니다. 이 이름은 받는 사람의 장치에 있는 오디오 파일의 이름과 일치해야 합니다.
+ **작업**에서 수신자가 푸시 알림을 탭할 경우 수신자의 장치에서 수행할 작업을 선택합니다.
+ **앱 열기** - 앱을 열거나 백그라운드로 전송된 경우 포그라운드로 가져옵니다.
+ **URL로 이동** - 수신자의 디바이스에서 기본 브라우저를 열고 특정 웹 페이지를 로드합니다. 이 옵션을 선택한 경우 **대상 URL** 상자에 웹 페이지의 URL을 입력합니다.
+ **딥 링크 열기** - 앱을 열고 앱에 특정 사용자 인터페이스를 표시합니다. 이 옵션을 선택한 경우 **대상 URL** 상자에 인터페이스의 URL을 입력합니다.
1. (선택 사항) 특정 푸시 알림 서비스에 맞게 템플릿을 사용자 지정하려면 **개별 푸시 서비스에 대한 콘텐츠 사용자 지정**에서 해당 서비스 탭을 선택합니다. 그런 다음 해당 서비스에 대해 원하는 옵션을 선택합니다.
서비스 탭에서 **기본 푸시 콘텐츠 재정의** 확인란을 선택하면 Amazon Pinpoint는 이전 단계에서 선택한 기본 콘텐츠 및 설정을 탭에서 선택한 옵션으로 자동으로 바꿉니다. 기본 콘텐츠 및 설정을 유지하고 추가 채널별 설정을 사용하도록 템플릿을 사용자 지정하려면 이 확인란을 선택하지 마십시오.
**Apple**
이러한 옵션을 사용하여 iOS 디바이스에서 실행되는 앱에 Apple Push Notification service(APNs) 채널을 통해 전송하는 푸시 알림에 대한 사용자 지정 콘텐츠 및 설정을 지정할 수 있습니다.
표준 콘텐츠 및 설정 외에도 템플릿을 사용하는 푸시 알림에 사용자 정의 이미지 또는 비디오를 포함할 수 있습니다. 이렇게 하려면 **iOS 미디어** 상자에 이미지 또는 비디오 파일의 URL을 입력합니다. URL은 공개적으로 액세스할 수 있어야 합니다. 그렇지 않으면 수신자의 장치에서 이미지 또는 비디오를 표시할 수 없습니다.
**Google**
이 옵션을 사용하여 Google Firebase Cloud Messaging(FCM) 채널을 통해 Android 디바이스에서 실행되는 앱으로 전송하는 푸시 알림에 대한 사용자 지정 콘텐츠 및 설정을 지정합니다.
표준 콘텐츠 및 설정 외에도 다음 옵션을 선택하여 템플릿을 사용하는 푸시 알림에 사용자 정의 이미지를 표시할 수 있습니다.
+ **Android 이미지** - 푸시 알림 본문에 표시할 이미지의 URL을 입력합니다.
+ **Android 아이콘** - 푸시 알림의 콘텐츠 보기에 표시할 큰 아이콘 이미지의 URL을 입력합니다.
+ **Android 작은 아이콘** - 상태 표시줄과 푸시 알림의 콘텐츠 보기에 표시할 작은 아이콘 이미지의 URL을 입력합니다.
**Amazon**
이러한 옵션을 사용하여 Amazon Device Messaging(ADM) 채널을 통해 Kindle Fire 태블릿 등 Amazon 장치에서 실행되는 앱으로 전송하는 푸시 알림에 대한 사용자 지정 콘텐츠 및 설정을 지정할 수 있습니다.
표준 콘텐츠 및 설정 외에도 다음 옵션을 선택하여 템플릿을 사용하는 푸시 알림에 사용자 정의 이미지를 표시할 수 있습니다.
+ **Android 이미지** - 푸시 알림 본문에 표시할 이미지의 URL을 입력합니다.
+ **Android 아이콘** - 푸시 알림의 콘텐츠 보기에 표시할 큰 아이콘 이미지의 URL을 입력합니다.
+ **Android 작은 아이콘** - 상태 표시줄과 푸시 알림의 콘텐츠 보기에 표시할 작은 아이콘 이미지의 URL을 입력합니다.
**Baidu**
이러한 옵션을 사용하여 Baidu 채널을 통해 Baidu Cloud 푸시 플랫폼을 사용하는 앱으로 전송하는 푸시 알림에 대한 사용자 지정 콘텐츠 및 설정을 지정할 수 있습니다.
표준 콘텐츠 및 설정 외에도 다음 옵션을 선택하여 템플릿을 사용하는 푸시 알림에 사용자 정의 이미지를 표시할 수 있습니다.
+ **Android 이미지** - 푸시 알림 본문에 표시할 이미지의 URL을 입력합니다.
+ **Android 아이콘** - 푸시 알림의 콘텐츠 보기에 표시할 큰 아이콘 이미지의 URL을 입력합니다.
+ **Android 작은 아이콘** - 상태 표시줄과 푸시 알림의 콘텐츠 보기에 표시할 작은 아이콘 이미지의 URL을 입력합니다.
1. 메시지 변수를 사용하여 개인화된 콘텐츠를 템플릿에 추가한 경우 각 변수의 기본값을 지정합니다. 이렇게 하면 수신자에 해당하는 값이 없는 경우 Amazon Pinpoint가 변수를 지정한 값으로 바꿉니다. 템플릿의 각 변수에 대해 이 작업을 수행하는 것이 좋습니다.
변수의 기본값을 지정하려면 **기본 속성 값** 섹션을 확장합니다. 그런 다음 각 변수에 사용할 기본값을 입력합니다. 기본값을 지정하지 않고 수신자에 대한 값이 없는 경우 Amazon Pinpoint는 메시지를 보내지 않습니다.
1. 템플릿의 내용 및 설정 입력을 마치면 **만들기**를 선택합니다.
## 원시 메시지 데이터를 사용하여 푸시 알림 템플릿 생성
원시 메시지 페이로드를 수동으로 지정하려면 이 절차를 완료하세요. Amazon Pinpoint에서 구성할 수 없는 특정 푸시 알림 서비스의 기능을 사용하려는 경우에만 원시 메시지 페이로드를 지정해야 합니다. 원시 메시지 콘텐츠를 지정해야 하는 경우 [표준 푸시 알림 템플릿 생성](#message-templates-creating-push-standard)의 절차를 대신 완료해야 합니다.
원시 메시지 템플릿을 사용해야 하는 사용 사례의 예로는 데스크톱 Safari 웹 브라우저 사용자에게 메시지를 보내려는 경우를 들 수 있습니다. 이 경우 원시 메시지 페이로드에 특정 속성을 포함해야 합니다. 자세한 내용은 *AWS End User Messaging Push 사용 설명서*의 [메시지 전송](https://docs.aws.amazon.com/push-notifications/latest/userguide/reference-send-message.html)을 참조하세요.
**푸시 알림 템플릿을 만들려면 다음을 수행합니다.**
1. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)에서 Amazon Pinpoint 콘솔을 엽니다.
1. 탐색 창에서 **메시지 템플릿**을 선택합니다.
1. **템플릿 생성**을 선택합니다.
1. **채널**에서 **푸시 알림**을 선택합니다.
1. **템플릿 세부 정보**에서 **템플릿 이름**에 템플릿의 이름을 입력합니다. 이름은 문자 또는 숫자로 시작해야 합니다. 최대 128자까지 입력할 수 있습니다. 문자는 문자, 숫자, 밑줄(\$1) 또는 하이픈(-)일 수 있습니다.
1. (선택 사항) **버전 설명**에 템플릿에 대한 간단한 설명을 입력합니다. 설명은 최대 500자까지 입력할 수 있습니다.
1. **푸시 알림 세부 정보**의 **알림 유형**에서 **원시 메시지**를 선택합니다. 메시지 편집기에 템플릿에 사용할 코드의 개요가 표시됩니다. 메시지 편집기에서 템플릿에 지정할 이미지, 사운드, 작업과 같은 선택적 설정을 비롯해 각 푸시 알림 서비스에 사용할 설정을 입력합니다. 자세한 내용은 사용 중인 푸시 알림 서비스의 설명서를 참조하세요.
1. 원시 메시지 콘텐츠 입력을 마치면 **생성**을 선택합니다.
사용자에게 보내는 푸시 알림에서 템플릿을 사용하기 전에, 템플릿을 테스트하려면 해당 템플릿을 사용하는 [테스트 알림을 전송](messages-mobile.md)하면 됩니다. 이렇게 하려면 먼저 10단계를 완료하여 템플릿의 모든 변수에 기본값을 지정해야 합니다. 그러지 않으면 푸시 알림이 전송되지 않거나 올바르게 렌더링되지 않을 수 있습니다.