Ir al contenido

Establecer el idioma y la configuración regional del usuario

Decide qué señal determina el idioma que recibe un consumidor y, a continuación, establece ese valor en el perfil de usuario para que tus Campaigns y Canvas localizados se dirijan a la audiencia correcta.

Acerca de este ejemplo

UponVoyage, una marca de viajes ficticia, personaliza mensajes para consumidores en doce mercados. El equipo de marketing obtiene el idioma a partir de un atributo personalizado market que se establece con el país desde el que un consumidor reserva su viaje de ida. Ese atributo se corresponde con una región, no con un idioma, así que los consumidores que reservan desde un país multilingüe, o desde un país que no es el suyo, pueden recibir el idioma equivocado.

Este ejemplo compara tres señales para el idioma de un consumidor y muestra cómo establecer cada una en el perfil:

  • Idioma recopilado por el SDK: El atributo estándar language, obtenido de la configuración regional del dispositivo o del navegador
  • Preferencia de idioma explícita: Un valor que el consumidor elige en tu aplicación o en tu sitio, establecido mediante el SDK o la REST API
  • Atributo personalizado de mercado o región: Un atributo de negocio como market, que se usa cuando tu contenido varía según la región y no según el idioma

language y country son atributos estándar independientes en Braze. Cuando importan las variantes regionales (por ejemplo, el español de España frente al español de Latinoamérica), segmenta por ambos atributos en lugar de almacenar una cadena de configuración regional combinada.

Este ejemplo muestra cómo elegir una señal de idioma y establecerla en el perfil. Para almacenar y enviar textos traducidos, consulta Comparar enfoques de traducción.

Consideraciones

  • El país se obtiene primero de la geolocalización por IP. Braze identifica country mediante la geolocalización de la dirección IP. Si la geolocalización no está disponible, Braze identifica country por la configuración regional del dispositivo. No trates country como un valor informado por el dispositivo. Para más información, consulta Recopilación de datos del SDK.
  • La recopilación del idioma es opcional y se puede desactivar. language es un dato opcional que se recopila de forma predeterminada, por lo que una integración mínima o una lista de propiedades de dispositivo permitidas puede excluirlo. Confirma que tu integración sigue recopilándolo antes de depender de él. Para más información, consulta Almacenamiento.
  • Es posible que falte la configuración regional del dispositivo más reciente. No todos los consumidores tienen un valor, así que planifica un idioma alternativo para los mensajes que la usen.
  • Establecer un valor de forma explícita detiene la recopilación automática. Después de establecer language o country mediante el SDK, la REST API o una importación CSV, Braze deja de actualizar automáticamente ese campo para ese consumidor. Planifica cómo cambiará un consumidor su preferencia más adelante.
  • Los valores explícitos consumen puntos de datos. Las actualizaciones de atributos mediante el SDK y la API registran puntos de datos, mientras que la recopilación automática no. Para más información, consulta Puntos de datos.
  • language debe ser un código ISO 639-1. Usa códigos de dos letras como en o nl. Para ver el conjunto admitido, consulta Códigos de idioma. country usa códigos ISO 3166-1 alfa-2 como GB o BE.
  • Cambiar tu modelo de idioma afecta a los activos existentes. Cuando pases de un atributo personalizado a atributos estándar, revisa las Campaigns, los Canvas, los Segments y el código Liquid que hacen referencia al atributo antiguo antes de retirarlo.

Configuración

Paso 1: Elige la señal que determina el idioma

Señal Úsala cuando Contrapartida
language recopilado por el SDK Quieres cobertura para todos los consumidores con una sesión de SDK sin trabajo de ingeniería adicional a la integración existente Refleja la configuración del dispositivo, que puede ser distinta del idioma en el que el consumidor quiere recibir marketing
Preferencia de idioma explícita Los consumidores pueden elegir un idioma en tu aplicación, en tu sitio o en una página de configuración de la cuenta Requiere una interfaz para la elección y una llamada a Braze cuando cambie
Atributo personalizado de mercado o región El contenido, los precios o los textos legales varían según el mercado y no según el idioma Un atributo market solo se corresponde con un idioma cuando cada mercado tiene un único idioma

Si puedes recopilar una preferencia explícita, úsala como señal principal y recurre a language recopilado por el SDK como alternativa. Un atributo market es un mal sustituto para deducir el idioma en países multilingües como Bélgica, Canadá y Suiza.

Paso 2: Confirma lo que tu integración ya recopila

  1. Ve a Audiencia > Búsqueda de usuarios, abre el perfil de un consumidor y revisa los campos Idioma y País.
  2. Si Idioma está vacío en todos los perfiles, confirma que tu integración de SDK no lo excluye de la recopilación de propiedades del dispositivo.
  3. Comprueba si Configuración regional del dispositivo más reciente tiene un valor. Úsala para diagnósticos y no segmentes por ella sin una alternativa.

Paso 3: Establece una preferencia de idioma explícita

Usa este paso solo si elegiste una preferencia de idioma explícita en el paso 1. Para language recopilado por el SDK, confirma la recopilación en el paso 2 y pasa directamente a la segmentación. Para un atributo personalizado market o de región, establece ese atributo mediante el SDK o la REST API y, luego, continúa con los pasos 4 a 6 según sea necesario.

Cuando un consumidor elija un idioma, envía esa elección a Braze para que tenga prioridad sobre la recopilación automática.

Establece el valor mediante el SDK cuando la elección se produzca en tu aplicación o en tu sitio. Para ver los nombres de los métodos en cada plataforma, consulta Establecer atributos de usuario.

Para las preferencias almacenadas en tus propios sistemas, envía los atributos estándar mediante el endpoint /users/track:

{
  "attributes": [
    {
      "external_id": "{YOUR_EXTERNAL_ID}",
      "language": "nl",
      "country": "BE"
    }
  ]
}

Sustituye YOUR_EXTERNAL_ID por el identificador del consumidor cuya preferencia ha cambiado.

Paso 4: Establece el país cuando un consumidor indique una región

Establece country de forma explícita cuando un consumidor te indique su región; por ejemplo, cuando navega por un sitio específico de un país o selecciona un mercado al registrarse. Usa la misma solicitud /users/track o el mismo método del SDK que en el paso anterior.

Si quieres que el país basado en la IP se siga actualizando, no establezcas country de forma explícita. Elige una sola fuente por consumidor y aplícala de forma coherente.

Paso 5: Dirige los mensajes según el idioma y el país

  1. Crea Segments con los filtros Idioma y País en lugar de un atributo de configuración regional combinado.
  2. Para mensajes que varían según la región dentro de un mismo idioma, filtra por ambos atributos; por ejemplo, language es es y country es ES.
  3. Para enviar un único mensaje que se muestre según cada configuración regional, añade configuraciones regionales usando los atributos predeterminados de idioma y país y, luego, consulta Mensajes multilingües.
  4. Si mantienes un atributo market para contenido regional, añade una configuración regional basada en atributos personalizados en lugar de asignar ese atributo a un idioma.

Paso 6: Abandona un modelo de idioma basado en el mercado

  1. Busca en tu espacio de trabajo las Campaigns, los Canvas, los Segments y los Content Blocks que hacen referencia al atributo market.
  2. Rellena language en los perfiles existentes mediante una importación CSV o la API cuando ya conozcas la preferencia del consumidor.
  3. Actualiza los activos para que filtren por Idioma y conserva el atributo market solo donde el contenido varíe según la región.
  4. Confirma que cada configuración regional se muestra como esperas con Vista previa del mensaje como usuario antes de retirar el atributo antiguo.
New Stuff!