**지원 종료 공지:** 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는 Amazon Personalize 캠페인으로 배포하고 Amazon Pinpoint가 사용하도록 구성한 추천 모델에서 이러한 추천을 검색합니다.
템플릿에 메시지 변수가 포함된 경우 Amazon Pinpoint가 각 변수를 각 수신자에 대한 현재 해당 속성 값으로 대체합니다. 추천의 경우 이 프로세스에는 Amazon Personalize 캠페인에서 각 수신자를 위한 최신 추천을 검색하는 작업이 포함됩니다. Amazon Pinpoint는 템플릿을 사용하는 메시지를 보낼 때마다 이 작업을 수행합니다. 즉, 메시지에 수신자에 대한 최신 추천이 포함되어 있음을 확신할 수 있습니다.
예를 들어 프로젝트가 사용자에게 영화 및 TV 쇼를 추천하는 애플리케이션인 경우, 각 사용자에 대해 다음과 같은 속성이 있을 수 있습니다.
+ 사용자의 이름입니다.
+ 사용자가 가장 최근에 제출한 평가
+ 사용자가 가장 최근에 평가한 영화 또는 쇼의 제목
+ 모델이 사용자에게 추천하는 상위 3개 영화 및 쇼의 제목
이 프로젝트의 경우 템플릿에서 다음 텍스트 및 메시지 변수를 사용할 수 있습니다.
`Hi {{User.UserAttributes.FirstName}}, based on your recent {{User.UserAttributes.LatestRating}}-star rating for {{User.UserAttributes.LatestRatedTitle}}, we think you might also enjoy: {{RecommendationItems.[0]}}, {{RecommendationItems.[1]}}, and {{RecommendationItems.[2]}}.`
템플릿을 사용하는 메시지를 보내면 Amazon Pinpoint가 변수를 각 수신자에 대한 각 속성의 현재 값으로 바꿉니다. 다음 예제에서 보여주는 것은 다음과 같습니다.
**예시 1**.
`Hi Sofia, based on your recent 5-star rating for The Marvelous Mrs. Maisel – Season 3, we think you might also enjoy: Fleabag, Late Night, and Catastrophe.`
**예시 2**.
`Hi Alejandro, based on your recent 4-star rating for Tom Clancy's Jack Ryan – Season 2, we think you might also enjoy: Hanna, Hunters, and Agatha Christie's The ABC Murders.`
AWS Lambda 함수를 사용하여 추천을 개선하도록 추천 모델을 구성한 경우, 템플릿과 결과 메시지에 추가 변수와 추천 속성을 사용할 수 있습니다. 예를 들어 각 추천 영화 또는 쇼에 대한 이미지와 URL을 제공하는 변수를 속성에 사용할 수도 있습니다.
템플릿에서 메시지 변수 사용에 대한 자세한 내용은 [메시지 템플릿에 맞춤형 콘텐츠 추가](message-templates-personalizing.md) 단원을 참조하십시오.
## 메시지에 추천 추가
메시지에 맞춤형 추천을 추가하려면 사용할 추천에 대한 메시지 변수를 포함하는 메시지 템플릿을 만들고 사용합니다. 이러한 변수를 다음 유형의 메시지 템플릿에 추가할 수 있습니다.
+ 이메일 템플릿 - 캠페인 또는 여정에서 보내는 이메일 메시지용입니다.
+ 푸시 알림 템플릿 - 캠페인에서 보내는 푸시 알림용입니다.
+ SMS 템플릿 - 캠페인에서 보내는 SMS 문자 메시지용입니다.
각 템플릿은 한 번에 한 추천 모델의 변수 및 추천 속성을 사용할 수 있습니다.
새 템플릿(템플릿을 생성하는 경우)이나 기존 템플릿에 변수를 추가할 수 있습니다. 기존 템플릿에 변수를 추가하는 경우 Amazon Pinpoint에서 템플릿을 사용하고 아직 전송되지 않은 메시지(예: 나중에 보내도록 예약된 캠페인 메시지)에 변경 사항을 반드시 적용하는 것은 아닙니다. 이는 변수를 추가하는 템플릿의 버전과 템플릿을 사용하는 메시지를 구성한 방법에 따라 달라집니다. 자세한 내용은 [메시지 템플릿 버전 관리](message-templates-versioning.md) 섹션을 참조하세요.
**메시지 템플릿에 추천을 추가하려면**
1. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)에서 Amazon Pinpoint 콘솔을 엽니다.
1. 탐색 창에서 **메시지 템플릿**을 선택합니다.
1. **메시지 템플릿** 페이지에서 다음 중 하나를 수행합니다.
+ 새 템플릿을 만들고 추천을 추가하려면 **템플릿 생성**을 선택합니다. 그런 다음 템플릿 페이지에서 템플릿 이름을 입력하고 선택적으로 템플릿에 대한 설명을 입력합니다.
+ 기존 템플릿에 추천을 추가하려면 원하는 템플릿을 선택합니다. 그런 다음 템플릿 페이지에서 **편집**을 선택합니다. **템플릿 세부 정보**에서 버전 선택기를 사용하여 시작점으로 사용할 템플릿 버전을 선택합니다. 최신 버전을 선택하면 변경 사항을 해당 템플릿 버전에 직접 저장할 수 있습니다. 아니면 변경 사항을 새 템플릿 버전으로 저장할 수 있습니다.
1. **속성 찾기**에서 **추천 속성** 섹션을 확장합니다.
템플릿에 대한 추천 모델을 아직 선택하지 않은 경우 **모델 연결**을 선택합니다. 다음으로 템플릿을 사용하는 메시지를 보낼 때 추천을 검색할 모델을 선택합니다. 그런 다음 **모델 연결**을 선택합니다.
1. **추천 속성**에서 메시지 변수를 추가하려는 속성을 선택합니다. Amazon Pinpoint는 속성에 대한 변수를 생성하여 클립보드에 복사합니다. 그런 다음 메시지 편집기에서 메시지에 추천을 표시할 위치에 변수를 붙여넣습니다.
변수를 붙여넣으면 Amazon Pinpoint는 해당 변수를 두 개의 중괄호로 묶어 연결된 속성의 이름으로 표시합니다 (예: `{{RecommendationItems}}`).
1. 추천 모델이 둘 이상의 추천 속성을 제공하는 경우, 변수를 추가하려는 각 추가 속성에 대해 이전 단계를 반복합니다.
다른 속성 유형에 대한 변수를 추가할 수도 있습니다. 이렇게 하려면 **속성 찾기**에서 다른 섹션을 확장하고, 원하는 각 추가 속성을 선택한 후, 원하는 위치에 변수를 붙여넣습니다. 다른 속성 유형의 변수 사용에 대한 자세한 내용은 [메시지 템플릿에 맞춤형 콘텐츠 추가](message-templates-personalizing.md) 단원을 참조하십시오.
1. 메시지 변수의 기본값을 지정하려면 **기본 속성 값** 섹션을 확장합니다. 그런 다음 변수 목록에서 변수에 사용할 기본값을 입력합니다. 템플릿의 각 변수에 대해 이 작업을 수행하는 것이 좋습니다.
1. 완료한 후 다음 중 하나를 수행합니다.
+ 새 템플릿에 메시지 변수를 추가한 경우 **생성**을 선택합니다.
+ 기존 템플릿에 메시지 변수를 추가한 경우 변경 사항을 새 버전의 템플릿으로 저장하려면 **새 버전으로 저장**을 선택하십시오.
+ 기존 템플릿에 메시지 변수를 추가한 경우 변경 사항을 최신 버전 템플릿에 대한 업데이트로 저장하려면 **버전 업데이트**을 선택하십시오. 이 옵션은 3단계에서 최신 버전 템플릿을 연 경우에만 사용할 수 있습니다.
이제 템플릿을 사용하여 캠페인 및 여정에서 보내는 메시지에 맞춤형 추천을 포함시킬 수 있습니다.
제한된 대상에게 직접 메시지 또는 테스트 메시지로 보내는 메시지에는 추천을 포함시킬 수 없습니다. 이러한 메시지에서 템플릿을 보다 일반적으로 사용할 수 있지만 Amazon Pinpoint에서는 모델의 추천을 직접 메시지 또는 테스트 메시지의 수신자와 상호 연관시킬 수 없습니다. 추천을 사용하는 템플릿의 모양과 형식을 테스트하려면 추천 속성을 참조하는 각 메시지 변수에 대해 기본값을 지정한 후, 해당 템플릿을 사용하는 테스트 메시지를 보냅니다.
## 메시지에서 추천 제거
메시지에서 맞춤형 추천을 제거하려면 메시지가 사용하는 메시지 템플릿을 업데이트합니다. 템플릿을 업데이트할 때 추천에 대한 모든 메시지 변수 또는 일부 메시지 변수만 제거하십시오.
템플릿에서 추천을 제거하는 경우 Amazon Pinpoint에서 템플릿을 사용하고 아직 전송되지 않은 메시지(예: 나중에 보내도록 예약된 캠페인 메시지)에 변경 사항을 반드시 적용하는 것은 아닙니다. 이는 추천을 제거하는 템플릿의 버전과 템플릿을 사용하는 메시지를 구성한 방법에 따라 달라집니다. 자세한 내용은 [메시지 템플릿 버전 관리](message-templates-versioning.md) 섹션을 참조하세요.
**메시지 템플릿에서 추천을 제거하려면**
1. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)에서 Amazon Pinpoint 콘솔을 엽니다.
1. 탐색 창에서 **메시지 템플릿**을 선택합니다.
1. **메시지 템플릿** 페이지에서 추천을 제거하려는 템플릿을 선택합니다. 그런 다음 템플릿 페이지에서 **편집**을 선택합니다.
1. **템플릿 세부 정보**에서 버전 선택기를 사용하여 시작점으로 사용할 템플릿 버전을 선택합니다. 최신 버전을 선택하면 변경 사항을 해당 템플릿 버전에 직접 저장할 수 있습니다. 아니면 변경 사항을 새 템플릿 버전으로 저장할 수 있습니다.
1. 메시지 편집기에서 제거할 각 추천 속성에 대한 메시지 변수의 텍스트를 모두 삭제합니다. 각 메시지 변수는 두 개의 중괄호와 연결된 속성 이름으로 구성됩니다(예: `{{RecommendationItems}}`).
템플릿에서 추천 모델을 완전히 제거하려면 모델에서 제공하는 추천 속성에 대한 모든 변수를 삭제합니다. 그런 다음 **속성 찾기**에서 **추천 속성** 섹션을 확장하고, 모델 이름 옆의 **X**를 선택합니다.
1. 완료한 후 다음 중 하나를 수행합니다.
+ 변경 사항을 새 템플릿 버전으로 저장하려면 **새 버전으로 저장**을 선택하십시오.
+ 변경 사항을 최신 버전 템플릿에 대한 업데이트로 저장하려면 **버전 업데이트**를 선택하십시오. 이 옵션은 4단계에서 최신 버전 템플릿을 선택한 경우에만 사용할 수 있습니다.