> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 지역화된 이메일 템플릿

> 하나의 템플릿 ID 아래에 여러 번역된 버전이 포함된 PlayFab 이메일 템플릿을 만들어 플레이어가 선호하는 언어로 계정 이메일을 받을 수 있도록 합니다.

PlayFab은 게임 개발자를 대신하여 지역화된 문자열을 저장하는 지원을 제공합니다. 또한, 플레이어에게 그들이 선호하는 언어에 대한 올바른 문자열을 제공하는 데 필요한 로직을 추가하고 있습니다.

이 자습서에서는 지역화된 이메일 템플릿 사용 방법을 안내합니다. 지역화된 이메일 템플릿을 사용하면 이메일의 번역된 여러 버전을 만들 수 있으며, *모든* 버전을 하나의 템플릿 ID와 연결할 수 있습니다.

<Note>
  이 기능이 릴리스되기 전에 도입된 템플릿은 원래 동작을 유지합니다. 하지만 새 이메일 템플릿에서 사용되는 새로운 지역화 형식을 사용하도록 쉽게 업데이트할 수 있습니다.
</Note>

## 요구 사항

이는 *고급* 자습서입니다. 모든 요구 사항을 충족했는지 확인하세요. 그렇지 않으면 이 자습서를 완료할 *수 없습니다*.

* 이메일 템플릿에 대한 소개는 [이메일 템플릿을 사용하여 계정 복구 이메일 보내기](/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email) 자습서를 참조하세요.
* [기본 언어 설정](/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages) 자습서에서 타이틀의 기본 언어와 플레이어의 선호 언어를 다루는 방법에 대한 정보를 검토하세요. 지역화된 이메일 템플릿을 계속 사용하려면 타이틀 기본 언어가 설정되어 있어야 합니다.

## 기존 이메일 템플릿 업데이트

가장 먼저 할 일은 위에서 언급한 [이메일 템플릿을 사용하여 계정 복구 이메일 보내기](/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email) 자습서에서 만든 기존 계정 복구 이메일 템플릿을 업데이트하는 것입니다.

1. 왼쪽 메뉴에서 **Content**를 선택합니다.
2. **Email Templates** 탭으로 이동합니다.
3. **Template name** 필드로 이동하여 **Account Recovery** 템플릿을 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=3ceed3a457f45f85944bb701147296a8" alt="게임 관리자 - 콘텐츠 - 이메일 템플릿 - 이메일 템플릿 편집" width="1366" height="1256" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png" />

이 자습서의 목적상, 타이틀 기본 언어가 영어라고 가정합니다. 기존 버전의 템플릿이 기본 언어 버전으로 표시되는 것을 볼 수 있습니다.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-default-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=73a86502d9ea115d84cc067bc0de8eff" alt="이메일 템플릿 편집 - 제목 및 본문 - 기본 언어" width="989" height="1128" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-default-language.png" />

언어를 추가하는 것은 제공된 **+ ADD LANGUAGE** 링크를 선택하고, 템플릿에 추가하려는 언어를 선택한 다음, 지역화된 문자열을 입력하는 것만큼 간단합니다.

이 예제에서는 기존 템플릿에 다음 프랑스어 문자열을 추가할 것입니다.

프랑스어 이메일 제목:

```html theme={null}
Réinitialisation du mot de passe demandée
```

프랑스어 이메일 본문:

```html theme={null}
<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.
```

다음과 같이 표시되어야 합니다:

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-french-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=dfb61a203ed9ae23c1392bfb93c6247f" alt="이메일 템플릿 편집 - 제목 및 본문 - 프랑스어" width="981" height="1759" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-french-language.png" />

**SAVE EMAIL TEMPLATE** 버튼을 선택하면 이메일 템플릿 목록이 포함된 페이지로 다시 리디렉션됩니다.

보시다시피, 새 언어 버전이 추가되었지만 새 템플릿은 추가되지 *않았습니다*. 모든 언어 버전은 동일한 템플릿 ID 아래에 저장되기 때문입니다.

## 지역화된 이메일 전송

다음으로, 새로 지역화된 버전의 이메일을 보낼 것입니다. [기본 언어 설정](/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages) 자습서에서 언급했듯이, PlayFab은 타이틀에서 지원하는 언어를 플레이어가 선호하는 언어와 매칭하는 무거운 작업을 수행합니다. 사용자가 해야 할 일은 이메일을 보내라고 지시하는 것뿐입니다.

이 동작을 확인하려면 두 명의 테스트 플레이어를 만드세요.

새 플레이어 중 한 명은 선호 언어 없이 두세요. 이는 지정된 언어가 없거나 타이틀의 언어와 플레이어의 언어가 일치하지 않는 경우 PlayFab이 타이틀의 기본값으로 되돌아가는 방법을 보여 줄 것입니다.

*다른* 새 플레이어의 언어를 게임 관리자를 사용하거나 [SetProfileLanguage](xref:titleid.playfabapi.com.profiles.accountmanagement.setprofilelanguage) API를 사용하여 설정합니다. 이 예제에서는 프랑스어를 사용했습니다.

<Note>
  `SetProfileLanguage` API를 사용하는 경우, 언어 문자열은 ISO 639-1 형식(예: "en", "es" 또는 "ja")으로 지정해야 합니다. 현재 "zh" 코드는 지원되지 않습니다.
</Note>

다음 단계로 넘어가기 전에, [이메일 템플릿을 사용하여 계정 복구 이메일 보내기 - 2단계](/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email#step-2---add-username-password-login-email-and-contact-email-to-a-player) 자습서에서 설명한 대로 두 플레이어 모두에 대한 연락처 이메일을 설정했는지 확인하세요.

플레이어당 한 번씩 [SendCustomAccountRecoveryEmail](xref:titleid.playfabapi.com.server.accountmanagement.sendcustomaccountrecoveryemail) API를 사용하여 이 템플릿을 보냅니다:

* 선호 언어가 프랑스어인 플레이어에게 프랑스어로 한 번.
* 선호 언어가 설정되지 않은 플레이어에게 기본 언어로 한 번.

*선호 언어가 없는* 플레이어에게 보낸 샘플 이메일이 아래에 표시됩니다.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=bb1e0e6cf1614c5e1cf0255ef60fea0e" alt="이메일 - 암호 재설정 - 기본 언어" width="1180" height="388" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png" />

*선호 언어가 프랑스어인* 플레이어에게 보낸 샘플 이메일이 아래에 표시됩니다.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=ce1d58bc1351db185ae7aaae37deba3c" alt="이메일 - 암호 재설정 - 프랑스어" width="1185" height="390" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png" />

## 결론

보시다시피, PlayFab은 템플릿의 프랑스어 지원과 플레이어의 언어 기본 설정 간에 일치하는 항목이 있음을 감지했습니다.

일치하는 항목이 *없거나* 기본 설정이 *없는* 경우, 플레이어는 타이틀의 기본 언어 문자열을 받았습니다.

이 자습서에 대한 질문이나 피드백이 있는 경우, [포럼](https://community.playfab.com/questions/ask.html)이나 Slack 채널을 통해 문의하세요.


## Related topics

- [푸시 알림 템플릿](/ko/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notification-templates.md)
- [이메일](/ko/services/playfab/live-service-management/game-configuration/title-communications/emails/index.md)
- [이메일 메시지 빠른 시작](/ko/services/playfab/live-service-management/game-configuration/title-communications/emails/quickstart.md)
- [PFAccountManagementClientSendAccountRecoveryEmailAsync](/ko/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientsendaccountrecoveryemailasync.md)
- [기본 언어 설정](/ko/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages.md)
