Plantillas de correo electrónico localizadas - XBOX Game Development Documentation

PlayFab está introduciendo compatibilidad con el almacenamiento de cadenas localizadas en nombre de los desarrolladores de juegos. Además, estamos agregando la lógica necesaria para proporcionar a sus jugadores las cadenas correctas para el idioma que prefieren. Este tutorial le guía por el uso de plantillas de correo electrónico localizadas. Con las plantillas de correo electrónico localizadas, puede crear varias versiones traducidas de un correo electrónico y asociarlas todas a un único id. de plantilla.

Las plantillas introducidas antes del lanzamiento de esta característica conservarán su comportamiento. Sin embargo, puede actualizarlas fácilmente para que usen el nuevo formato localizado que usan las nuevas plantillas de correo electrónico.

Requisitos

Este es un tutorial avanzado. Asegúrese de que se cumplen todos los requisitos o no podrá completar este tutorial.

Para obtener una introducción a las plantillas de correo electrónico, consulte el tutorial Uso de plantillas de correo electrónico para enviar un correo electrónico de recuperación de cuenta.
Revise la información sobre cómo trabajar con los idiomas predeterminados de su título y los idiomas preferidos de sus jugadores en el tutorial Configuración de idiomas predeterminados. Debe tener establecido un idioma predeterminado del título para continuar con las plantillas de correo electrónico localizadas.

Actualización de una plantilla de correo electrónico existente

Lo primero que haremos será actualizar la plantilla de correo electrónico de recuperación de cuenta existente que creamos en el tutorial Uso de plantillas de correo electrónico para enviar un correo electrónico de recuperación de cuenta mencionado anteriormente.

Seleccione Content en el menú de la izquierda.
Vaya a la pestaña Email Templates.
Vaya al campo Template name y seleccione la plantilla Account Recovery.

A efectos de este tutorial, supondremos que el idioma predeterminado de su título es el inglés. Verá que su versión existente de la plantilla aparece como la versión del idioma predeterminado. Agregar más idiomas es tan sencillo como seleccionar el vínculo + ADD LANGUAGE que se proporciona, elegir el idioma que desea agregar a la plantilla y escribir las cadenas localizadas. En este ejemplo, vamos a agregar las siguientes cadenas en francés a nuestra plantilla existente. Asunto del correo electrónico en francés:

Réinitialisation du mot de passe demandée

Cuerpo del correo electrónico en francés:

<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.

Este es el aspecto que debería tener: Cuando seleccione el botón SAVE EMAIL TEMPLATE, se le redirigirá de nuevo a la página que contiene la lista de sus plantillas de correo electrónico. Como puede ver, se agregó una nueva versión de idioma, pero no se agregó una nueva plantilla, ya que todas las versiones de idioma se almacenan bajo el mismo id. de plantilla.

Envío de correos electrónicos localizados

A continuación, enviaremos nuestra nueva versión localizada del correo electrónico. Como se mencionó en el tutorial Configuración de idiomas predeterminados, PlayFab se encarga del trabajo pesado de hacer coincidir los idiomas admitidos por su título con el idioma preferido de sus jugadores. Todo lo que tiene que hacer es indicarnos que enviemos el correo electrónico. Para comprobar este comportamiento, cree dos jugadores de prueba. Deje a uno de los nuevos jugadores sin idioma preferido. Esto demostrará cómo PlayFab recurre al idioma predeterminado del título si no se especifica ningún idioma o si no hay coincidencia entre el idioma del título y el idioma del jugador. Establezca el idioma del otro jugador nuevo mediante Game Manager o mediante la API SetProfileLanguage. En este ejemplo hemos usado el francés.

Al usar la API SetProfileLanguage, la cadena de idioma debe especificarse en el formato ISO 639-1 (por ejemplo, “en”, “es” o “ja”). Actualmente, el código “zh” no se admite.

Asegúrese de haber establecido el correo electrónico de contacto en ambos jugadores, tal como se explica en el paso 2 del tutorial Uso de plantillas de correo electrónico para enviar un correo electrónico de recuperación de cuenta, antes de continuar con el paso siguiente. Use la API SendCustomAccountRecoveryEmail una vez por jugador para enviar esta plantilla:

Una vez en francés al jugador cuyo idioma preferido es el francés.
Una vez en el idioma predeterminado a un jugador sin idioma preferido establecido.

A continuación se muestra un correo electrónico de ejemplo enviado al jugador sin idioma preferido. A continuación se muestra un correo electrónico de ejemplo enviado al jugador cuyo idioma preferido es el francés.

Conclusión

Como puede ver, PlayFab detectó que había una coincidencia entre la compatibilidad de su plantilla con el francés y la preferencia de idioma del jugador. Cuando no hubo coincidencia o no había preferencia, el jugador recibió las cadenas del idioma predeterminado de su título. Si tiene alguna pregunta o comentario sobre este tutorial, póngase en contacto con nosotros a través de nuestros foros o del canal de Slack.

​Requisitos

​Actualización de una plantilla de correo electrónico existente

​Envío de correos electrónicos localizados

​Conclusión

Requisitos

Actualización de una plantilla de correo electrónico existente

Envío de correos electrónicos localizados

Conclusión