메시지 템플릿에 맞춤형 콘텐츠 추가 - Amazon Pinpoint
메시지 변수 추가지원되는 속성

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

메시지 템플릿에 맞춤형 콘텐츠 추가

템플릿을 사용하는 메시지에 동적인 맞춤형 콘텐츠를 전달하려면 메시지 템플릿에 메시지 변수를 추가합니다. 메시지 변수는 사용자에 대한 정보를 저장하기 위해 사용자 또는 Amazon Pinpoint가 생성한 특정 속성을 참조하는 자리 표시자입니다. 각 속성은 일반적으로 사용자의 이름이나 거주하는 도시 같은 사용자의 특성에 해당합니다. 템플릿에 메시지 변수를 추가하면 이러한 속성을 사용하여 템플릿을 사용하는 메시지의 각 수신자에게 사용자 지정 콘텐츠를 전달할 수 있습니다.

템플릿에 메시지 변수가 포함된 경우 Amazon Pinpoint가 각 변수를 각 수신자에 대한 현재 해당 속성 값으로 대체합니다. 템플릿을 사용하는 메시지를 보낼 때마다 이 작업을 수행합니다. 즉, 메시지나 메시지 템플릿의 사용자 지정 버전을 여러 개 만들지 않고도 각 수신자에게 맞춤형 콘텐츠를 보낼 수 있습니다. 또한 수신자에 대한 최신 정보가 메시지에 포함되어 있음을 확신할 수 있습니다.

예를 들어 프로젝트가 달리기 선수용 피트니스 애플리케이션이고 각 사용자의 이름, 선호 활동, 개인 기록에 대한 속성이 포함된 경우 템플릿에 다음 텍스트 및 메시지 변수를 사용할 수 있습니다.

Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!

템플릿을 사용하는 메시지를 보내면 Amazon Pinpoint가 변수를 각 수신자에 대한 각 속성의 현재 값으로 바꿉니다. 다음 예제에서 보여주는 것은 다음과 같습니다.

예 1

Hi Sofia, congratulations on your new half marathon record of 1:42:17!

예제 2

Hi Alejandro, congratulations on your new 5K record of 20:52!

수신자에 대한 속성 값이 없는 경우 Amazon Pinpoint는 변수에 지정한 기본값으로 변수를 바꿀 수 있습니다. 예를 들어 피트니스 애플리케이션의 사용자가 선호하는 활동을 선택하지 않은 경우 running을 {{User.UserAttributes.Activity}} 변수의 기본값으로 사용할 수 있습니다. 이 경우 다음 예와 같이 Amazon Pinpoint가 변수를 대체합니다.

예 1

Hi Jane, congratulations on your new running record of 1:42:17!

예제 2

Hi John, congratulations on your new running record of 20:52!

기본값을 지정하지 않고 수신자에 대한 값이 존재하지 않으면 해당 수신자에게 메시지를 보낼 때 Amazon Pinpoint가 변수의 모든 텍스트를 생략합니다. 예:

Hi Mary, congratulations on your new record of 20:52!

템플릿에 포함하는 각 변수에 대해 기본값을 지정하는 것이 좋습니다.

메시지 변수 추가

생성하는 새 템플릿이나 기존 템플릿에 메시지 속성을 추가할 수 있습니다. 기존 템플릿에 변수를 추가하는 경우 Amazon Pinpoint에서 템플릿을 사용하고 아직 전송되지 않은 메시지(예: 나중에 보내도록 예약된 캠페인 메시지)에 변경 사항을 반드시 적용하는 것은 아닙니다. 이는 변수를 추가하는 템플릿의 버전과 템플릿을 사용하는 메시지를 구성한 방법에 따라 달라집니다. 자세한 정보는 메시지 템플릿 버전 관리을 참조하세요.

참고

인앱 메시징 템플릿은 메시지 변수 사용을 지원하지 않습니다.

메시지 템플릿에 메시지 변수를 추가하려면

  1. https://console.aws.amazon.com/pinpoint/에서 Amazon Pinpoint 콘솔을 엽니다.

  2. 탐색 창에서 메시지 템플릿을 선택합니다.

  3. 메시지 템플릿 페이지에서 다음 중 하나를 수행합니다.

    • 새 템플릿을 생성하고 이 템플릿에 메시지 변수를 추가하려면 템플릿 생성을 선택합니다. 그런 다음 템플릿 페이지에서 템플릿 이름을 입력하고 선택적으로 템플릿에 대한 설명을 입력합니다.

    • 기존 템플릿에 메시지 변수를 추가하려면 변수를 추가할 템플릿을 선택합니다. 그런 다음 템플릿 페이지에서 편집을 선택합니다. 템플릿 세부 정보에서 버전 선택기를 사용하여 시작점으로 사용할 템플릿 버전을 선택합니다. 최신 버전을 선택하면 변경 사항을 해당 템플릿 버전에 직접 저장할 수 있습니다. 아니면 변경 사항을 새 템플릿 버전으로 저장할 수 있습니다.

  4. 메시지 세부 정보 섹션에서 메시지 변수를 추가할 위치를 결정합니다. 모든 유형의 템플릿의 본문에 변수를 추가할 수 있습니다. 이메일 및 푸시 알림 템플릿의 경우 메시지 제목이나 제목에 변수를 추가할 수도 있습니다.

  5. 속성 찾기에서 메시지 변수를 추가할 속성 유형의 섹션을 확장합니다. 다음 속성 유형 중에서 선택할 수 있습니다.

    표준 속성

    이러한 속성은 Amazon Pinpoint가 모든 프로젝트에 대해 자동으로 만드는 속성입니다. 즉, 모든 프로젝트에 대해 보내는 메시지에서 사용할 수 있습니다. 이러한 각 속성에 대한 자세한 내용은 지원되는 속성 단원을 참조하십시오.

    표준 속성에 대한 변수를 추가하려면 목록에서 해당 속성을 선택합니다.

    사용자 지정 속성

    이러한 속성은 개별 프로젝트에 대해 선택적으로 만드는 속성입니다. 일부 프로젝트에서 이러한 속성을 사용하지 못할 수 있으므로 Amazon Pinpoint는 해당 템플릿을 사용하는 메시지의 모든 수신자에 대한 값으로 변수를 바꾸지 못할 수 있습니다. Amazon Pinpoint는 이 문제를 방지할 수 있도록 특정 프로젝트 또는 모든 프로젝트에 있는 속성을 선택할 수 있는 옵션을 제공합니다.

    사용자 지정 속성을 추가하려면

    1. 사용자 지정 속성을 선택한 다음 사용자 지정 속성 로드를 선택합니다. 나타나는 창에서 Amazon Pinpoint는 사용자가 생성한 모든 프로젝트를 나열합니다. 각 프로젝트를 선택하면 선택한 프로젝트에 공통적인 속성이 오른쪽 탐색 창에 표시됩니다. 속성이 표시되지 않으면 해당 프로젝트 간에 공통된 속성이 없는 것입니다.

    2. 다음 중 하나를 수행하십시오.

      • 선택한 프로젝트에 공통적인 속성을 모두 사용하려면 사용자 지정 속성 로드를 선택합니다.

      • 목록에 있는 특정 속성을 사용하려면 검색 필드에 속성 이름의 일부를 입력합니다. 입력한 텍스트와 일치하는 속성이 표시됩니다. 사용하려는 속성이 표시되면 사용자 지정 속성 로드를 선택합니다. 속성 파인더는 새로 추가된 사용자 지정 속성을 표시합니다.

        참고

        서로 다른 프로젝트 세트의 공통 속성을 추가하거나 속성 파인더의 사용자 지정 속성 섹션을 수정할 수 없습니다. 사용자 지정 속성을 변경해야 하는 경우 X를 선택하여 속성 파인더를 지운 다음 다시 시작하세요.

    3. 속성 찾기에서 변수를 추가할 속성을 선택합니다.

    추천 속성

    이러한 속성은 추천 모델에서 맞춤형 추천을 검색하도록 Amazon Pinpoint를 구성할 때 계정에 대해 선택적으로 만드는 속성입니다. 추천 모델 사용에 대한 자세한 내용은 기계 학습 모델 단원을 참조하십시오. 이 속성 유형에 대한 변수를 이메일 템플릿, 푸시 알림 템플릿 및 SMS 템플릿에 추가할 수 있습니다. 음성 템플릿에는 추가할 수 없습니다.

    추천 속성에 대한 변수를 추가하려면 목록에서 해당 속성을 선택합니다. 속성 찾기에 추천 속성이 나열되지 않으면 먼저 템플릿을 추천 모델에 연결해야 합니다.

    추천 속성을 추가하려면

    1. 모델 연결을 선택합니다.

    2. 템플릿을 사용하는 메시지를 보낼 때 추천을 검색할 모델을 선택합니다.

    3. 모델 연결을 선택합니다.

  6. 속성 파인더에서 속성을 선택하면 Amazon Pinpoint가 해당 속성에 대한 메시지 변수를 만들어 클립보드에 복사합니다. 원하는 위치에 변수를 붙여넣습니다. 속성 목록이 긴 경우 검색 텍스트를 입력하여 목록 범위를 좁힙니다. 검색 필드를 지우려면 X를 선택합니다.

    변수를 붙여넣으면 Amazon Pinpoint는 해당 변수를 두 개의 중괄호로 묶어 연결된 속성의 이름으로 표시합니다 (예: {{User.UserAttributes.FirstName}}).

  7. 추가할 각 메시지 변수에 대해 4~6단계를 반복합니다.

  8. 메시지 변수의 기본값을 지정하려면 기본 속성 값 섹션을 확장합니다. 그런 다음 변수 목록에서 변수에 사용할 기본값을 입력합니다.

    참고

    템플릿의 각 변수에 대해 이 작업을 수행하는 것이 좋습니다. 그렇지 않으면 Amazon Pinpoint에서 템플릿을 사용하는 메시지를 보내지 못하거나 예기치 않거나 원하지 않은 방식으로 메시지가 표시될 수 있습니다.

  9. 완료한 후 다음 중 하나를 수행합니다.

    • 새 템플릿에 메시지 변수를 추가한 경우 생성을 선택합니다.

    • 기존 템플릿에 메시지 변수를 추가한 경우 변경 사항을 새 버전의 템플릿으로 저장하려면 새 버전으로 저장을 선택하십시오.

    • 기존 템플릿에 메시지 변수를 추가한 경우 변경 사항을 최신 버전 템플릿에 대한 업데이트로 저장하려면 버전 업데이트을 선택하십시오. 이 옵션은 3단계에서 최신 버전 템플릿을 연 경우에만 사용할 수 있습니다.

지원되는 속성

각 프로젝트에는 표준 속성과 사용자 지정 속성이 있을 수 있습니다. 표준 속성은 Amazon Pinpoint가 모든 프로젝트에 대해 자동으로 만드는 속성입니다. 사용자 지정 속성은 사용자가 프로젝트에 대해 선택적으로 만드는 속성입니다. 사용자 지정 속성에는 세 가지 유형이 있습니다.

  • 사용자 속성 - 이러한 속성은 사용자의 이름, 성, 생년월일 등으로 사용자를 설명합니다. 사용자는 프로젝트에서 고유한 사용자 ID를 가진 개인입니다.

  • 엔드포인트 속성 - 이러한 속성은 사용자의 특정 엔드포인트를 설명합니다. 엔드포인트는 메시지를 전송할 수 있는 대상입니다(예: 이메일 주소, 전화번호 또는 모바일 디바이스). 각 사용자는 하나 이상의 엔드포인트와 연결할 수 있습니다. 예를 들어 이메일, SMS 및 전화로 사용자와 소통하는 경우, 사용자는 사용자의 이메일 주소, 사용자의 휴대 전화번호, 사용자의 집(유선) 전화번호에 각각 하나씩, 총 세 개의 엔드포인트에 연결할 수 있습니다.

  • 지표 속성 - 이러한 속성은 모바일 앱의 세션 수 또는 장바구니에 남아 있는 항목 수처럼 애플리케이션이 개별 엔드포인트와 관련해 Amazon Pinpoint에 보고하는 숫자 지표입니다.

  • Pinpoint 속성 — 이러한 속성은 애플리케이션, 캠페인 또는 여정을 위한 고유한 식별자입니다.

사용자 또는 Amazon Pinpoint가 프로젝트를 위해 만드는 사용자 지정 속성과 표준 속성 외에도, Amazon Pinpoint는 추천 속성을 지원합니다. 추천 속성은 사용자 또는 엔드포인트를 위한 맞춤화된 추천을 임시로 저장하는 속성입니다. Amazon Pinpoint는 사용하도록 구성한 추천 모델에서 이러한 추천을 검색합니다. 추천 속성은 특정 프로젝트와 연결되지 않습니다. 대신 Amazon Pinpoint 계정과 연결됩니다. 추천 모델 사용에 대한 자세한 내용은 기계 학습 모델 단원을 참조하십시오.

메시지 변수에서 표준, 사용자 지정 또는 추천 속성을 사용할 수 있습니다. 다음 표는 지원되는 각 속성의 메시지 변수에 표시되는 텍스트를 나타내고, 각 속성에 대해 설명합니다. 표에서 custom_attribute는 사용자 지정 속성에 대한 변수에 표시되는 텍스트를 나타냅니다. 이 경우 custom_attribute를 사용자 지정 속성의 이름으로 바꿉니다. 예를 들어 프로젝트에서 FirstName이라는 사용자 지정 사용자 속성에 사용자의 이름을 저장하고 해당 속성에 대한 변수를 추가하는 경우, 변수의 텍스트는 {{User.UserAttributes.FirstName}}입니다.

속성 설명
Address 엔드포인트로 보내는 메시지 또는 푸시 알림의 대상 주소(예: 이메일 주소, 전화 번호 또는 디바이스 토큰)입니다.
Pinpoint.ApplicationId 애플리케이션의 고유 식별자입니다.
Attributes.custom_attribute 엔드포인트를 설명하는 사용자 지정 엔드포인트 속성입니다.
Pinpoint.CampaignId 캠페인의 고유 식별자입니다.
ChannelType 엔드포인트에 메시지 또는 푸시 알림을 보낼 때 사용할 채널입니다. 예:

  • APNS - iOS 디바이스에서 실행 중인 앱으로 Apple Push Notification service(APNs) 채널을 통해 전송하는 푸시 알림을 받을 수 있는 엔드포인트에 사용합니다.

  • EMAIL - 음성 메시지를 받을 수 있는 엔드포인트에 사용합니다.

  • GCM - Android 디바이스에서 실행 중인 앱으로 Firebase Cloud Messaging(FCM) 채널을 통해 전송하는 푸시 알림을 받을 수 있는 엔드포인트에 사용합니다.

  • SMS - SMS 문자 메시지를 받을 수 있는 엔드포인트에 사용합니다.

  • VOICE - 음성 메시지를 받을 수 있는 엔드포인트에 사용합니다.
CreationDate 프로젝트에 엔드포인트가 추가된 날짜와 시간입니다(ISO 8601 형식). 예를 들어 2019년 6월 30일 오전 11시 45분(UTC)인 경우 2019-06-30T11:45:25.220Z입니다.
Demographic.AppVersion 엔드포인트와 연결된 애플리케이션의 버전 번호입니다.
Demographic.Locale ISO 639-1 alpha-2 코드, 밑줄(_), ISO 3166-1 alpha-2 값 순의 형식으로 표시되는 엔드포인트의 로캘입니다. 예를 들어, en_US는 미국의 영어 로캘입니다.
Demographic.Make 엔드포인트 디바이스 제조업체(예: apple 또는 samsung)입니다.
Demographic.Model 엔드포인트 디바이스의 모델 이름 또는 번호(예: iPhone 또는 SM-G900F)입니다.
Demographic.ModelVersion 엔드포인트 디바이스의 모델 버전입니다.
Demographic.Platform 엔드포인트 디바이스의 운영 체제(예: ios 또는 android)입니다.
Demographic.PlatformVersion 엔드포인트 디바이스의 운영 체제 버전입니다.
Demographic.Timezone 엔드포인트의 시간대(tz 데이터베이스 값)입니다. 예: 태평양 표준시(북미)의 경우 America/Los_Angeles.
EffectiveDate 엔드포인트가 마지막으로 업데이트된 날짜와 시간입니다(ISO 8601 형식). 예를 들어 2019년 8월 23일 오전 10시 54분(UTC)인 경우 2019-08-23T10:54:35.220Z입니다.
EndpointId 엔드포인트의 고유 식별자입니다.
EndpointStatus 엔드포인트에 메시지 또는 푸시 알림을 보낼 것인지 여부: 엔드포인트로 메시지를 전송하는 경우 ACTIVE, 엔드포인트로 메시지를 전송하지 않는 경우 INACTIVE.
Id 엔드포인트의 고유 식별자입니다.
Pinpoint.JourneyId 여정의 고유 식별자.
Location.City 엔드포인트가 위치한 도시입니다.
Location.Country 엔드포인트가 위치한 국가 또는 리전의 2자 코드입니다(ISO 3166-1 alpha-2 형식). 예를 들어, 미국의 경우 US입니다.
Location.Latitude 소수점 한 자리로 반올림된 엔드포인트 위치의 위도 좌표입니다.
Location.Longitude 소수점 한 자리로 반올림된 엔드포인트 위치의 경도 좌표입니다.
Location.PostalCode 엔드포인트가 위치한 지역의 우편 번호입니다.
Location.Region 엔드포인트가 있는 리전의 이름입니다(예: 시/도).
Metrics.custom_attribute 애플리케이션이 엔드포인트와 관련해 Amazon Pinpoint에 보고하는 사용자 지정 숫자 지표입니다.
OptOut 사용자가 메시지 및 푸시 알림 수신을 옵트아웃했는지 여부: 사용자가 옵트아웃했고 메시지 또는 푸시 알림 수신을 원하지 않는 경우 ALL. 사용자가 옵트아웃하지 않았고 모든 메시지와 푸시 알림을 받기를 원하는 경우 NONE.
RecommendationItems 엔드포인트 또는 사용자에 대한 추천 하나를 저장하는 표준 추천 속성입니다. 이 속성에는 추천 모델에서 직접 제공하는 텍스트가 포함됩니다.
RecommendationItems.[#]

엔드포인트 또는 사용자에 대해 2~5개의 정렬된 추천 목록을 저장하는 표준 추천 속성입니다. 이 속성에는 추천 모델에서 직접 제공하는 텍스트가 포함됩니다.

숫자 자리 표시자(.[#])는 속성에 여러 값이 포함되어 있음을 나타냅니다. 이 속성에 대한 메시지 변수는 목록의 특정 값을 참조할 수 있습니다.
Recommendations.custom_attribute 엔드포인트 또는 사용자에 대한 추천 하나를 저장하는 사용자 지정 추천 속성입니다. 이 속성에는 추천 모델에서 제공하고 AWS Lambda 함수를 통해 개선된 콘텐츠가 포함됩니다.
Recommendations.custom_attribute.[#]

엔드포인트 또는 사용자에 대한 여러 추천을 저장하는 사용자 지정 추천 속성입니다. 이 속성에는 추천 모델에서 제공하고 AWS Lambda 함수에 의해 개선된 콘텐츠가 포함됩니다.

숫자 자리 표시자(.[#])는 속성에 여러 값이 포함되어 있음을 나타냅니다. 이 속성에 대한 메시지 변수는 특히 이러한 값 중 하나를 참조할 수 있습니다.
RequestId 최근 엔드포인트 업데이트 요청의 고유 식별자입니다.
User.UserAttributes.custom_attribute 사용자를 설명하는 사용자 지정 사용자 속성입니다.
User.UserId 사용자의 고유 식별자입니다.