Internacionalización: cómo localizar acciones
viernes, 14 de diciembre de 2018
Supongamos que creaste una acción que les ofrece a los usuarios una experiencia increíble. El único problema es que solo está disponible para aquellos que hablan el idioma en el que se escribió. Te estás perdiendo de tantos otros usuarios que también podrían disfrutar de lo que creaste… ¿Cómo puedes hacer que tu acción llegue a todo el mundo? ¡Pues localizándola!
¿Qué es la localización?
Es el proceso mediante el que se personalizan experiencias para diferentes idiomas y configuraciones regionales. A continuación, se muestran en diferentes idiomas algunos ejemplos de un saludo perteneciente a una acción de GDG:
"Welcome to GDG San Francisco. I can tell you about…"
"Benvenuto a GDG San Francisco. Posso darti informazioni…"
"Bienvenidos a GDG San Francisco. Puedo contarte sobre…"
"Willkommen bei der GDG San Francisco. Ich kann dir mehr über unsere…"Consulta qué idiomas y configuraciones regionales admite Actions on Google.
Motivos para localizar tu contenido
- Tu acción estará disponible para más usuarios.
- Cambiará la experiencia del usuario en función del idioma utilizado.
- Mediante el Programa de la comunidad de desarrolladores del Asistente de Google, posiblemente puedas obtener el hito Taking your Action Global, si tu acción está disponible en al menos dos idiomas (uno debe ser una variante distinta del inglés) y tiene una cantidad mínima de usuarios activos en ambas lenguas.
Puedes obtener más información sobre cómo localizar tu acción en estos documentos, aunque los he organizado a continuación a modo de guía para las acciones que utilizan Dialogflow y un webhook (consulta este código de muestra sobre el tipo de proyecto al que me refiero).
- Comienza con una acción robusta y activa que estés listo para localizar. Elige una que ya hayas implementado a fin de asegurarte de que supere el proceso de revisión.
- Traduce todo el texto de la acción a diferentes idiomas:
- Respuestas de la acción
- Frases de entrenamiento para cada intent
- Entidades personalizadas
- Información del directorio de la acción
- Sección de descripción (breve y completa)
- Invocaciones de muestra
- Política de privacidad
- Condiciones de servicio (opcional)
3. Actualiza tu código de cumplimiento para brindar compatibilidad con varios idiomas. Usa una biblioteca cliente que admita i18n (internacionalización). Hay muchas bibliotecas compatibles con diferentes marcos de trabajo, así que elige la que se adapte a tus necesidades.
- Si utilizas la biblioteca de cliente Node.js para Actions on Google, consulta las bibliotecas recomendadas para este producto. Asimismo, consulta el código de muestra de Number Genie para ver cómo se implementa esto.
- Agrega idiomas a tu agente. Esta acción copiará tus intents a cada idioma nuevo.
- Agrega frases de entrenamiento, respuestas y entradas de entidades traducidas por idioma nuevo.
- Agrega idiomas a la acción yendo a la página Configuración del proyecto a través del ícono de engranaje que se encuentra junto a la sección "Descripción general". Allí, puedes hacer clic en Idiomas, donde podrás agregar todos los que quieras.
6. Prueba las acciones en la consola de Actions on Google
- En el simulador de acciones, prueba los flujos de conversación para cada idioma a fin de asegurarte de obtener los resultados esperados. El simulador te permite cambiar de idioma, así como de ubicación. Consulta la documentación correspondiente aquí.
- Agrega pruebas a tu proyecto (ejemplo de muestra de las librerías de pruebas de Actions on Google).
- A medida que pruebes diferentes flujos de conversación en los distintos idiomas, ajusta tu SSML para que las acciones suenen más naturales en ese idioma.
- Descripción (breve y completa)
- Invocaciones de muestra
- Política de privacidad
- Condiciones de servicio (opcional)
- Se recomienda utilizar la versión Beta porque pasa por el mismo proceso de revisión que la versión de producción. Una vez que se apruebe tu proyecto, podrás lanzarlo a producción cuando estés listo.
¿Quieres más? Consulta la comunidad de Actions on Google para intercambiar opiniones con otros desarrolladores. Únete al programa de la comunidad de desarrolladores de Actions on Google para ganar un crédito mensual de USD 200 en Google Cloud y una remera del Asistente cuando publiques tu primera app.