지역화된 이메일 템플릿
PlayFab은 게임 개발자를 대신하여 지역화된 문자열을 저장하기 위한 지원을 도입합니다. 또한 선호하는 언어에 대한 올바른 문자열을 플레이어에게 제공하기 위한 필요한 논리를 추가하고 있습니다.
이 자습서에서는 지역화된 전자 메일 템플릿을 사용하는 방법을 안내합니다. 지역화된 전자 메일 템플릿을 사용하여 전자 메일의 번역된 여러 버전을 만들고 모든 버전을 하나의 템플릿 ID로 연결할 수 있습니다.
참고 항목
이 기능이 출시되기 전에 도입된 템플릿은 해당 동작이 유지됩니다. 그러나 동작을 손쉽게 업데이트하여 새 전자 메일 템플릿에서 사용되는 새로운 지역화된 포맷을 사용할 수 있습니다.
요구 사항
이 자습서는 고급 자습서입니다. 모든 요구 사항을 충족했는지 확인하십시오. 충족하지 않으면 이 자습서를 완료할 수 없습니다.
- 전자 메일 템플릿에 대한 소개는 전자 메일 템플릿을 사용하여 계정 복구 전자 메일 보내기 자습서를 참조하십시오.
- 타이틀에서 기본 언어로 작업하는 방법 및 기본 언어 설정 자습서에서 플레이어의 기본 언어에 관한 정보를 확인하십시오. 지역화된 전자 메일 템플릿으로 계속 진행하려면 타이틀 기본 언어 집합이 있어야 합니다.
기존 전자 메일 템플릿 업데이트
가장 먼저 수행할 작업은 위에서 언급된 전자 메일 템플릿을 사용하여 계정 복구 전자 메일 보내기 자습서에서 만든 기존 계정 복구 전자 메일 템플릿을 업데이트하는 것입니다.
- 왼쪽 메뉴에서 내용을 선택합니다.
- 전자 메일 템플릿 탭으로 이동합니다.
- 템플릿 이름 필드로 이동하고 암호 복구 템플릿을 선택합니다.
이 자습서의 목적상 타이틀 기본 언어는 영어로 가정합니다. 기존 템플릿 버전이 기본 언어 버전으로 나타나는 것을 확인할 수 있습니다.
더 많은 언어를 추가하는 것은 제공된 + 언어 추가 링크를 선택하는 것만큼이나 간단합니다. 템플릿에 추가하려는 언어를 선택하고 지역화된 문자열을 입력합니다.
이 예제에서는 다음 프랑스어 문자열을 기존 템플릿에 추가해 보겠습니다.
프랑스어 전자 메일 제목:
Réinitialisation du mot de passe demandée
프랑스어 전자 메일 본문:
<head></head>
<body><p>Vous avez récemment demandé un mot de passe avec nous. </p>
<p>Cliquez <a href="$ConfirmationUrl$">ici</a> s'il vous plaît pour être dirigé vers une page pour réinitialiser votre mot de passe.
다음과 같이 표시되어야 합니다.
전자 메일 템플릿 저장 버튼을 선택하는 경우 전자 메일 템플릿 목록이 있는 페이지로 다시 리디렉션됩니다.
여기서 알 수 있듯이 모든 언어 버전이 동일한 템플릿 ID 아래에 저장되어 있으므로 새 언어 버전이 추가되었지만 새 템플릿은 추가되지 않았습니다.
지역화된 전자 메일 보내기
다음으로 전자 메일의 지역화된 새 버전을 보냅니다. 기본 언어 설정 자습서에 언급된 대로 PlayFab에서는 타이틀의 지원되는 언어를 플레이어의 기본 언어와 일치시키기 위해 어려운 작업을 수행합니다. 전자 메일을 보내달라고 하기만 하면 됩니다.
이 동작을 확인하려면 두 명의 테스트 플레이어를 만듭니다.
새 플레이어 중 한 명은 기본 언어가 없는 채로 둡니다. 이는 지정한 언어가 없거나 타이틀의 언어 및 플레이어의 언어 간에 일치 사항이 없는 경우 PlayFab이 타이틀의 기본값으로 대체되는 방법을 설명합니다.
게임 관리자를 사용하거나 SetProfileLanguage API를 사용하여 다른 새 플레이어의 언어를 설정합니다. 이 예제에서는 프랑스어를 사용했습니다.
참고 항목
SetProfileLanguage API를 사용할 때, 언어 문자열은 ISO 639-1 형식(예: "en", "es" 또는 "ja")으로 지정해야 합니다. 현재 코드 "zh"는 지원되지 않습니다.
다음 단계를 계속 진행하기 전에 전자 메일 템플릿을 이용하여 계정 복구 전자 메일 보내기의 2단계자습서에 설명된 두 플레이어의 연락처 전자 메일을 설정했는지 확인합니다.
플레이어당 SendCustomAccountRecoveryEmail API를 사용하여 다음 템플릿을 보냅니다.
- 기본 언어가 프랑스어인 플레이어에게 프랑스어로 합니다.
- 기본 언어가 설정되지 않는 플레이어에게 기본 언어로 합니다.
기본 언어가 설정되어 있지 않은 플레이어에게 샘플 전자 메일이 아래와 같이 표시됩니다.
기본 언어가 프랑스어인 플레이어에게 샘플 전자 메일이 아래와 같이 표시됩니다.
결론
여기서 알 수 있듯이 PlayFab에서 프랑스어에 대한 템플릿 지원과 플레이어의 기본 설정 간에 일치 사항이 있음을 발견했습니다.
일치 사항이 없거나 기본 설정이 없는 경우 플레이어가 타이틀의 기본 언어 문자열을 수신했습니다.
이 자습서에 대한 의문 사항이나 피드백이 있는 경우 포럼 또는 채널을 통해 문의하십시오.