Ir al contenido

Shopify Markets

Este artículo cubre la integración de Shopify Markets, incluyendo qué está dentro del alcance, cómo funciona y cómo usar los datos de tus mercados en tu mensajería.

Cómo funciona la integración

Shopify Markets amplía tu integración actual de Shopify. Conecta tu tienda predeterminada mediante la ruta de integración estándar o personalizada (SDK). Después, selecciona entre los mercados configurados en tu tienda aquellos que quieres que Braze sincronice. Las integraciones existentes pueden añadir mercados sin afectar a los catálogos, los grupos de suscripción ni los eventos. Para ver las instrucciones paso a paso, consulta Configuración de Shopify Markets.

Shopify Markets ofrece estas capacidades:

  • Perfiles adaptados al mercado: La integración captura la configuración regional de Shopify de cada usuario junto con los atributos estándar de país e idioma de Braze. Así puedes segmentar y desencadenar mensajes por mercado sin ninguna configuración personalizada.
  • Catálogos localizados: Los datos de producto específicos de cada mercado se sincronizan a diario. Incluyen precios y moneda, además de títulos, descripciones y URL de producto traducidos.
  • Personalización adaptada al mercado: Usa la etiqueta de Liquid {% shopify_market %} para personalizar con productos del catálogo del mercado de cada usuario, incluido el contenido traducido de Shopify. También puedes hacer referencia a detalles del mercado, como la moneda de presentación, a partir de eventos compatibles de Shopify como ecommerce.order_placed.
  • Alternativa de tienda predeterminada: Cuando un usuario no pertenece a ninguno de tus mercados conectados, Braze usa la configuración y los productos de tu tienda predeterminada. Así, cada usuario recibe un mensaje completo y preciso.

Para ver ejemplos, consulta Usar los datos de usuario de Markets y Tutorial: Mostrar productos y precios por mercado.

Tipos de mercado de Shopify admitidos

Puedes seleccionar hasta 25 mercados de un solo país o de varios países activos. Cada país solo puede pertenecer a un mercado seleccionado.

No se admiten los mercados de subregiones, los mercados de comercio minorista, los mercados B2B ni los mercados de canal.

Qué necesita cada mercado

Cada mercado seleccionado necesita un catálogo de mercado con productos activos. Braze lee lo siguiente de ese catálogo:

Datos Descripción
Precios Se establecen en el catálogo de mercado, en la moneda especificada para ese mercado. No se admite la configuración “Usar monedas locales” de Shopify.
Traducciones Traducciones adaptadas realizadas con la aplicación Translate & Adapt de Shopify, como el título del producto y el título de la variante. Actualmente, Braze no admite la configuración de idioma específica de cada mercado.

Perfil de mercado Shopify para un mercado de Australia.

Consideraciones

General

  • Una tienda conectada: Solo puedes conectar una tienda de Shopify con Markets habilitado a un espacio de trabajo de Braze a la vez.
  • Alcance de las configuraciones regionales: Las configuraciones regionales incorporan los títulos y descripciones de productos traducidos según lo que hayas configurado con la aplicación Translate & Adapt de Shopify, así como las URL específicas de cada configuración regional. El precio, la moneda y otros campos compartidos del catálogo se mantienen iguales en todas las configuraciones regionales de un mercado. De forma predeterminada, Braze usa el idioma predeterminado de cada mercado, que es la configuración regional principal que Shopify asigna a ese mercado. Si activas la compatibilidad ampliada de configuraciones regionales, Braze sincroniza las configuraciones regionales adicionales establecidas para ese mercado.

Catálogo de mercado

  • Nuevas vistas de mercado en tu catálogo original de Shopify: Markets no crea catálogos independientes. En su lugar, Braze los muestra como parte de tu catálogo original de Shopify. Los datos de Markets se añaden como nuevas filas a tu catálogo de Shopify.
  • Selecciones de catálogo: Hasta 30 selecciones de catálogo.
  • Frecuencia de actualización: Los datos de productos del catálogo de mercado se actualizan una vez al día.
  • Precios de mercado y contenido localizado: Las filas de mercado incluyen el precio del mercado y compare_at_price, además de los títulos localizados de productos y variantes y las URL de productos cuando las traducciones están configuradas con la aplicación Translate & Adapt de Shopify.
  • Bajada de precio: Se admite en los catálogos de mercado. Un cambio de precio en un catálogo de mercado se desencadena según el precio de ese mercado, en lugar del precio predeterminado de tu tienda. Como los datos de productos del catálogo de mercado se actualizan una vez al día, las bajadas de precio se detectan diariamente y no en el momento en que cambia el precio en Shopify.
  • Vuelta a estar disponible: La vuelta a estar disponible se admite para los productos del catálogo predeterminado de tu tienda. Las filas de mercado no desencadenan notificaciones de vuelta a estar disponible. Esta característica tiene en cuenta el inventario total disponible de una variante de producto en todas las ubicaciones de Shopify, por lo que el stock añadido en una ubicación de comercio minorista puede desencadenar una notificación.

Configuración de Shopify Markets

Si ya tienes una integración de Shopify activa

Markets se suma a tu integración actual. No necesitas desconectarla ni volver a crear tu configuración.

  • Tus grupos de suscripción pasan a ser tus grupos de toda la tienda y siguen recibiendo cada adhesión voluntaria, incluidos los grupos adicionales que hayas asignado.
  • Tus suscriptores existentes permanecen en los grupos en los que ya están. Si añades grupos de país más adelante, Braze no añade a ellos a los suscriptores existentes.
  • Tu catálogo sigue sincronizándose. Las filas de mercado se añaden a él en lugar de a un catálogo nuevo, y tus selecciones existentes siguen funcionando con tus filas predeterminadas.
  • Tu tienda predeterminada aparece junto a los mercados que hayas seleccionado, para que puedas asignarle grupos de suscripción y crear selecciones de catálogo de la misma manera.

Si tu tienda ya está conectada, empieza por el paso 2 para obtener más información sobre cada configuración y cómo funciona.

Paso 1: Conecta tu tienda con Shopify Markets habilitado

  1. Conecta tu tienda mediante la integración estándar de Shopify o la integración personalizada de Shopify. Cuando tu tienda esté conectada, configura Shopify Markets en el creador de configuración.
  2. Completa el flujo de OAuth y confirma que Braze solicita los ámbitos de mercados en OAuth:
    • read_markets
    • read_publications
    • read_locales
  3. Cuando la autorización se complete correctamente y se abra el creador de configuración, selecciona Iniciar configuración.
  4. Activa los SDK de Braze.

Paso 2: Selecciona los datos de usuario de tu mercado

  1. En Seguimiento de datos de Shopify, selecciona Sincronizar datos de Shopify Markets.
  2. Selecciona Seleccionar mercados para elegir tu mercado y asegúrate de haber seleccionado el seguimiento de eventos de comportamiento y atributos de usuario.
    • (Opcional) Activa la sincronización de datos históricos

Datos de usuario de Markets

Para admitir Shopify Markets, Braze sincroniza datos adicionales además de los eventos y atributos estándar de la integración.

Atributos del perfil de usuario
Atributo Tipo de datos Descripción Origen de datos
shopify_locale Atributo personalizado La configuración regional del cliente, como en o fr-CA. El píxel web de Braze la establece a partir del idioma del navegador del comprador, y cada pedido que realiza la actualiza a la configuración regional con la que completó la compra. La sincronización de datos históricos también la importa desde el registro de cliente de Shopify. Las modificaciones del cliente en Shopify no la cambian. Píxel web, webhooks de pedidos, sincronización de datos históricos
browser_language Atributo estándar El idioma configurado en el navegador del cliente. SDK de Braze
country Atributo estándar El país del cliente. SDK de Braze
Propiedades del evento de pedido
Propiedad Descripción Origen de datos
country Código de país de dos letras del cliente. La default_address del cliente en Shopify, o la shipping_address del pedido si no hay una dirección predeterminada
presentment_currency La moneda con la que pagó el cliente, que puede ser distinta de la moneda de tu tienda. Moneda de presentación del pedido de Shopify
market_handle Identificador del mercado que coincide con el país del cliente. Vacío cuando no coincide ningún mercado configurado. Braze, a partir de tu configuración de mercados

Estas propiedades se añaden a:

  • Eventos recomendados de comercio electrónico: ecommerce.order_placed, ecommerce.order_cancelled, ecommerce.order_refunded
  • Eventos personalizados: shopify_paid_order, shopify_fulfilled_order, shopify_partially_fulfilled_order
Cómo funcionan estas propiedades del evento de mercado
Propiedad Cómo funciona
market_handle market_handle es el identificador que le diste al mercado en Shopify, como france. El mismo identificador se usa como prefijo de los ID de las filas de mercado en tu catálogo, como france_46714756268231. Está vacío cuando no has configurado mercados o cuando el país del pedido no coincide con ningún mercado que hayas configurado, así que comprueba si el valor está vacío antes de usarlo en Liquid o en un filtro de Segment.
country country procede de la dirección predeterminada del cliente y usa la shipping_address si no existe una predeterminada. Por ejemplo, un cliente en Francia que envía un pedido a Japón sigue asociado al mercado de Francia.
Propiedades del evento Las propiedades del evento son una instantánea del momento en que ocurrió el evento y no cambian después. Si un cliente actualiza su dirección predeterminada más adelante, los eventos nuevos usan su nuevo país, mientras que los eventos anteriores conservan el país con el que se registraron.
Moneda

Cuando los informes de Shopify Markets están habilitados, los eventos de webhook nativos de Shopify de pago, pedido y reembolso incluyen dos conjuntos de valores:

  • La moneda de tu tienda en los campos existentes de precio y total, sin cambios
  • El objeto presentment_currency, que contiene los importes que el cliente vio y pagó

Esos eventos también pueden incluir propiedades de mercado relacionadas, como country y market_handle.

Usa presentment_currency cuando quieras mostrarle a un cliente lo que pagó, por ejemplo, en una confirmación de pedido o un recordatorio de pago. Usa los valores en la moneda de la tienda cuando compares ingresos entre mercados, ya que ya están en una sola moneda.

Los eventos de carrito del píxel de Shopify no incluyen presentment_currency. Los eventos personalizados de pago y compra que envías a través de una CDP como Segment tampoco lo incluyen. Para mantener la moneda del mercado en tus mensajes e informes, incluye un objeto equivalente en la carga útil de tu evento personalizado o mantén habilitados los eventos nativos de Shopify para los tipos de eventos que necesites.

Información de producto localizada

Los eventos de Shopify compatibles incluyen los títulos de productos y variantes en el idioma predeterminado de tu tienda. Braze no traduce las cargas útiles de los eventos.

Los títulos, las descripciones y las URL de producto traducidos se encuentran en las filas de mercado de tu catálogo. Para mostrar información de producto localizada en un mensaje, busca el producto en tu catálogo con el ID del producto o de la variante del evento.

Paso 3: Gestiona usuarios

  1. Selecciona tu tipo de external_id en el desplegable.
  2. Activa las adhesiones voluntarias de correo electrónico y SMS desde Shopify, lo que permite a Braze sincronizar los estados de suscripción de correo electrónico y SMS desde Shopify. Tienes dos opciones:
    • Usar la integración: Braze sincroniza los estados de correo electrónico y SMS. Selecciona los grupos de suscripción con los que se sincronizan.
    • Crear la tuya propia: Para tener más control sobre la gestión de estados, crea una integración personalizada con los endpoints de grupos de suscripción de Braze.
  3. Selecciona los grupos de suscripción con los que se sincroniza el consentimiento de Shopify:
    • Grupos de toda la tienda (obligatorio): Selecciona al menos un grupo de correo electrónico y un grupo de SMS. Aquí se registra cada adhesión voluntaria que Braze recibe de Shopify.
    • Grupos de país (opcional): Asigna uno o más grupos a cualquier país de tus mercados sincronizados. Las adhesiones voluntarias también se registran aquí cuando Braze puede determinar el país del cliente.

Cómo funcionan las adhesiones voluntarias y las bajas

En Shopify, cada cliente tiene un estado de consentimiento de correo electrónico y un estado de consentimiento de SMS. Cuando los clientes se adhieren voluntariamente, se suscriben a tu marca, no a un país ni a una lista.

Braze registra cada adhesión voluntaria en tus grupos de toda la tienda. Si configuras grupos de país y Braze puede saber en qué país está el cliente, la adhesión voluntaria también se registra en los grupos de ese país.

Si no configuras grupos de país, las adhesiones voluntarias solo van a tus grupos de toda la tienda, lo que coincide con la forma en que Shopify gestiona actualmente el consentimiento.

Cómo determina Braze el país

Canal Determinación del país
Correo electrónico Usa primero la configuración regional de Shopify del cliente; si no está disponible, usa el atributo de país de su perfil de Braze.
SMS Usa el país del número de teléfono, determinado mediante los patrones de enrutamiento por país de E.164.

Una configuración regional solo identifica un país cuando incluye una región, como fr-FR. Una configuración regional fr por sí sola no lo hace.

En el caso de SMS, el país procede del número de teléfono. El comprador debe añadirse a un grupo de suscripción que pueda enviar mensajes a ese número.

Qué ocurre cuando alguien se adhiere voluntariamente

Estado del país Grupos de toda la tienda Grupos de país
Determinado y configurado en tus mercados Suscrito Suscrito a los grupos de ese país
No se puede determinar Suscrito No suscrito
Determinado, pero no configurado en tus mercados Suscrito No suscrito

La pertenencia a grupos de suscripción se basa en los eventos de consentimiento de Shopify. Si cambia el país o la configuración regional de un comprador, su pertenencia a grupos no cambia. Braze solo la actualiza cuando Shopify envía un nuevo evento de consentimiento, por ejemplo, si se vuelve a recopilar el consentimiento del comprador en Shopify después de que haya cambiado el país o la configuración regional.

Qué ocurre cuando alguien se da de baja

Una baja en Shopify elimina al usuario de todos los grupos de suscripción asignados a tu integración de Shopify. Ocurre lo mismo tanto si se dio de baja a través del sitio de un mercado como a través de la página de su cuenta de Shopify.

Los grupos de suscripción de tu espacio de trabajo que no están asignados a la integración no se ven afectados.

Adhesiones voluntarias de países que no has configurado

Si un cliente se adhiere voluntariamente desde un país que no forma parte de tus mercados configurados, ya sea porque nunca lo añadiste o porque eliminaste ese mercado, se suscribe a tus grupos de toda la tienda. No se añade a ningún grupo de país.

Configurar mercados no restringe a quién puedes enviar mensajes. Si no puedes enviar mensajes a un país por motivos legales o normativos, excluye a esos usuarios con un filtro de Segment o dirígelos a un grupo de suscripción independiente.

En el caso de SMS, los permisos de país de cada grupo de suscripción siguen controlando la entrega. Un usuario cuyo país no esté permitido en el grupo no recibirá mensajes de él.

Los usuarios no se añaden a los grupos de país más adelante

Si Braze no puede determinar el país de un cliente cuando se adhiere voluntariamente, solo se añade a tus grupos de toda la tienda. Si su país se conoce más adelante, no se añade automáticamente a los grupos de ese país.

Cuando activas Markets en una tienda ya integrada, tus grupos de suscripción existentes pasan a ser tus grupos de toda la tienda. Los suscriptores existentes siguen suscritos a estos grupos y no se añaden automáticamente a los nuevos grupos de país.

Para añadirlos tú mismo, crea un Segment para esos usuarios y suscríbelos con un paso de Actualización de usuario en Canvas.

Recuento de suscriptores entre grupos

Una sola adhesión voluntaria puede añadir a un usuario a más de un grupo de suscripción, por lo que sumar los totales de los grupos cuenta a la misma persona varias veces. Usa un Segment cuando necesites un recuento de suscriptores únicos.

Cómo funciona

  1. Un cliente se suscribe a SMS durante el pago o a través de un formulario.
  2. Shopify envía la suscripción a Braze.
  3. Braze establece al usuario como pendiente y envía tu mensaje de texto de confirmación.
  4. El cliente responde con tu palabra clave de confirmación y pasa a estar suscrito.
  5. Si no responde antes de que termine el periodo de confirmación, sigue pendiente.

Para obtener más información, consulta Doble adhesión voluntaria.

Paso 4: Sincroniza los productos

  1. Para sincronizar productos dentro de tu mercado, selecciona Sincronizar productos y variantes de Shopify con Braze.
  2. Asigna el ID del catálogo de Braze y configura cualquier ajuste adicional.

Tu catálogo incluye una vista por mercado de los productos predeterminados de tu tienda. Por cada producto publicado en tu mercado, Braze añade una fila de mercado a tu catálogo existente, además de los campos estándar del catálogo de Shopify que ya se admiten. Si activas Shopify Markets en una integración existente, estas filas pueden tardar unos minutos en sincronizarse.

En las filas de mercado, estos campos tienen valores específicos del mercado:

Campo Descripción
id Un ID compuesto con el identificador del mercado como prefijo, como france_46714756268231. Las filas predeterminadas conservan sus ID de artículo originales.
market_handle El identificador que le diste al mercado en Shopify, como france.
locale La configuración regional del mercado, que determina el idioma del contenido traducido.
price Precio específico del mercado según los precios contextuales del mercado, después de aplicar cualquier ajuste de la lista de precios.
compare_at_price Precio de comparación específico del mercado después de los ajustes. Braze devuelve 0 cuando no se resuelve ningún precio de comparación para ese mercado, incluso cuando la lista de precios del mercado está configurada para anular los precios de comparación.
product_title y variant_title Títulos traducidos, cuando las traducciones se configuran a través de la aplicación Translate & Adapt de Shopify.
product_url La URL del producto para ese mercado.

Paso 5: Activa canales

  1. (Opcional) Selecciona si quieres habilitar la mensajería en el navegador.
  2. Selecciona Finalizar configuración.

Usar los datos de usuario de Markets

Cuando estos atributos y propiedades estén en los perfiles de usuario, podrás usarlos para segmentar usuarios por mercado y personalizar mensajes.

Segmentar por mercado

Filtra por país, idioma del navegador o shopify_locale en los Segments y en los criterios de entrada de Campaign o Canvas. Por ejemplo, puedes dirigirte a los usuarios de Francia o crear una ruta de Canvas según shopify_locale.

También puedes usar los filtros de Segment de Shopify Market, que segmentan según el mercado asociado a la actividad de pedidos de un comprador. Para llegar solo a los compradores asociados a tu mercado predeterminado, crea un Segment que excluya a los usuarios de cada mercado no predeterminado que sincronices. Por ejemplo, incluye a todas las personas que hayan hecho un pedido, excepto cuando el mercado sea México.

Para seleccionar productos del catálogo por identificador de mercado (incluido cuando market_handle es default en las filas de productos predeterminados), consulta Tutorial: Mostrar productos y precios por mercado.

Desencadenar y personalizar con Liquid

Haz referencia a los datos de mercado en tus mensajes con estas variables de Liquid.

Desde el perfil de usuario

Atributo Liquid
El idioma del cliente {{custom_attribute.${shopify_locale}}}
El país del cliente {{${country}}}

Desde los eventos de pedido

Propiedad del evento Liquid
El país del pedido {{event_properties.${country}}}
El mercado del pedido {{event_properties.${market_handle}}}
La moneda con la que pagó el cliente {{event_properties.${metadata}.presentment_currency.code}}
El total del pedido en esa moneda {{event_properties.${metadata}.presentment_currency.<total_value>}}

Mostrar precios en la moneda del cliente

Combina siempre un importe con su código de moneda. Mostrar un importe por sí solo es el error más común en la mensajería multimercado, porque “129,95” significa algo distinto en cada mercado.

Usa el total del pedido para los mensajes a nivel de pedido, como una confirmación, y el precio del producto para el contenido a nivel de producto, como un carrito o una recomendación.

Thanks for your order! Your total: {{event_properties.${metadata}.presentment_currency.code}}
{{event_properties.${metadata}.presentment_currency.<total field>}}

Como estas propiedades viajan con el evento, el mensaje se mantiene preciso para el mercado de cada cliente sin necesidad de configuración adicional.

Comprobar valores vacíos

Hay dos valores que no siempre están presentes, y ambos se muestran de forma incorrecta cuando faltan.

market_handle está vacío cuando el país del cliente no coincide con un mercado configurado. Compruébalo antes de crear ramas en función de este valor:

{% if event_properties.${market_handle} != blank %}
  ...
{% endif %}

compare_at_price devuelve 0 cuando no se resuelve ningún precio de comparación para ese mercado. Comprueba si es 0 antes de mostrarlo o de calcular un descuento; de lo contrario, el cliente verá un precio tachado de cero.

Mostrar información localizada del producto

Los nombres de producto de los eventos están en el idioma predeterminado de tu tienda. Para mostrar títulos, descripciones o URL de productos traducidos, busca el producto en tu catálogo con el ID del producto o de la variante del evento. Para ver un ejemplo, consulta Tutorial: Mostrar productos y precios por mercado.

Desencadenar mensajes a partir de la actividad de pedidos

Las propiedades de mercado se incluyen en los eventos de Shopify compatibles, por lo que una Campaign o un Canvas desencadenado por un pedido puede usarlas sin configuración adicional. Estos eventos incluyen country, presentment_currency y market_handle.

Tipo de evento Eventos
Eventos recomendados de comercio electrónico ecommerce.order_placed, ecommerce.order_cancelled, ecommerce.order_refunded
Eventos personalizados shopify_paid_order, shopify_fulfilled_order, shopify_partially_fulfilled_order

presentment_currency se incluye en los eventos de pago, pedido y reembolso compatibles, por lo que un recordatorio de pago o una confirmación de pedido puede mostrar el importe que vio el cliente. Los eventos de carrito no incluyen presentment_currency, country ni market_handle. Para más detalles, consulta Moneda.

Informes de Markets

Cuando Markets está habilitado, Braze desglosa los ingresos y el rendimiento de los mensajes por país.

Ingresos por país

Tu informe de ingresos incluye un desglose por país junto al desglose por aplicación, tanto para el total histórico como para un intervalo de tiempo seleccionado.

Cada pedido se atribuye a un país, y todos sus ingresos se asignan a ese país. El país se toma primero del pedido y, después, del perfil del comprador. Los pedidos en los que no está disponible ninguno de los dos aparecen en Desconocido.

Los ingresos se muestran en USD, igual que en el resto del informe de ingresos. Para ver lo que pagó realmente un comprador, usa presentment_currency en el evento de pedido.

Rendimiento por país

Los análisis de Campaign y Canvas incluyen una tabla de Rendimiento por país que muestra cómo funcionó un mensaje en cada país, con una fila de total para cada país. La moneda y los ingresos totales se agregan a partir del presentment_currency del pedido.

Columna Qué muestra
País Cada país al que llegó tu mensaje.
Moneda La moneda de los ingresos de ese país, agregados según presentment_currency.
Ingresos totales Ingresos atribuidos a ese país.
Compras Compras atribuidas a ese país.

También puedes desglosar el rendimiento de Campaign y Canvas por país en el Generador de informes usando Países (Shopify Markets) como fila o desglose detallado.

Eliminar un mercado

Al eliminar un mercado, Braze deja de sincronizar datos nuevos para sus países. No se eliminan los datos que ya tienes.

Grupos de suscripción

Al eliminar un mercado, se actualiza tu configuración de Markets. No se eliminan grupos de suscripción de tu espacio de trabajo ni se quitan los usuarios que ya están suscritos a grupos por país.

Qué cambia en tu configuración

  • Los países del mercado eliminado dejan de aparecer en la interfaz de Markets.
  • Braze elimina las asignaciones de grupos de suscripción de esos países de la configuración de tu integración.

Qué se mantiene igual

  • Los grupos de suscripción por país permanecen en tu espacio de trabajo y siguen disponibles para la segmentación, pero Shopify deja de sincronizar las bajas con ellos. Los usuarios que se den de baja en Shopify podrían seguir apareciendo como suscritos en esos grupos por país, a menos que actualices su estado de suscripción de otra forma, por ejemplo, mediante los endpoints de grupos de suscripción o un flujo de trabajo de bajas en Braze.
  • Los usuarios que ya están suscritos a los grupos por país de un mercado eliminado siguen suscritos.
  • Las nuevas adhesiones voluntarias de compradores en los países eliminados se sincronizan solo con tus grupos de toda la tienda, igual que las adhesiones voluntarias de países que no has configurado.
  • Braze deja de sincronizar nuevas adhesiones voluntarias o bajas con los grupos por país de los países eliminados.
  • Los grupos de suscripción de toda la tienda siguen recibiendo actualizaciones de consentimiento.

Datos de usuario

  • Los atributos que ya están en el perfil de un usuario, incluidos shopify_locale y country, no cambian.
  • El market_handle dentro de los nuevos eventos de pedido deja de estar disponible.
  • Los filtros de Segment de Shopify Market para los mercados eliminados dejan de estar disponibles.
  • El código Liquid que hace referencia a un mercado eliminado deja de estar disponible.

Catálogos

  • Las filas de mercado de ese mercado dejan de actualizarse y se eliminan de tu catálogo.
  • Las selecciones de catálogo creadas a partir de esas filas de mercado dejan de devolver productos. Actualízalas o elimínalas antes de tu próximo envío.
  • Tus filas predeterminadas, y las selecciones creadas a partir de ellas, no se ven afectadas.

Tutorial: Mostrar productos y precios por mercado

Usa un catálogo con mercados para crear un único mensaje que muestre a cada usuario los productos y precios de su propio mercado.

  1. Crea una selección que utilice datos de mercados.
  2. Haz referencia a la selección en un mensaje con Liquid.

Puedes usar un mercado fijo cuando un mensaje se dirija a un mercado concreto.

Paso 1: Crear una selección con datos de mercados

Las selecciones son conjuntos de productos seleccionados a los que haces referencia en los mensajes. En los catálogos de Shopify con mercados sincronizados, la sección Configuración de filtros incluye un área Ámbito de mercado que limita los datos de producto a un mercado o los personaliza para cada usuario.

  1. Ve a tu catálogo de Shopify y abre la pestaña Selecciones.
  2. Selecciona Crear selección, ponle un nombre a la selección, añade una descripción opcional y establece un límite de resultados.
  3. En Configuración de filtros, en Ámbito de mercado, selecciona en el desplegable Mercado cómo resuelve la selección los productos específicos de cada mercado:
    • Personalizado: Cada destinatario ve los productos y precios del mercado que coincide con el atributo country de su perfil.
    • Un mercado sincronizado: Selecciona un mercado por su nombre para fijar la selección a los productos y precios de ese mercado. Usa esta opción cuando un mensaje se dirija a un solo mercado.
  4. Completa cualquier criterio de filtro adicional y guarda la selección.
  5. En Vista previa para el usuario, selecciona un usuario para ver lo que devuelve la selección para ese perfil. Las selecciones que usan Personalizado solo se pueden previsualizar después de seleccionar un usuario.
Objetivo Filtro
Un mercado específico market_handle = au
Solo productos predeterminados market_handle = default

Paso 2: Añadir selecciones de catálogo con mercados a los mensajes

Para mostrar a cada usuario los productos de su propio mercado en un único mensaje, crea una selección con este filtro:

Nombre de la selección Campo Operador Valor
market_products market_handle es igual a {{shopify_market.handle}}
default_products market_handle es igual a default

En el momento del envío, Braze sustituye {{shopify_market.handle}} por el mercado de cada usuario, de modo que market_products ofrece a todos los productos correctos. default_products es la alternativa para los usuarios sin un mercado coincidente.

Haz referencia a tu selección en el mensaje con la etiqueta {% shopify_market %}:

{% shopify_market %}
{% if shopify_market.handle %}
  {% catalog_selection_items <your_catalog_name> <your_market-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% else %}
  {% catalog_selection_items <your_catalog_name> <your_default-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% endif %}
  • Coloca {% shopify_market %} antes de {% catalog_selection_items %} para que el mercado del usuario quede establecido antes de que se ejecute la selección.
  • Sustituye <your_catalog_name> por tu catálogo y usa tus propios nombres de selección si son diferentes.
  • La comprobación de {{shopify_market.handle}} dirige a los usuarios sin un mercado coincidente a default_products, para que sigan recibiendo productos en lugar de un mensaje vacío.
  • Cuando uses compare_at_price en Liquid, comprueba si es “0” antes de mostrarlo o de calcular un descuento. Un mercado sin precio de comparación muestra un precio de cero o produce un descuento incorrecto.

Previsualiza el mensaje como un usuario de tu mercado para confirmar que muestra los productos, precios y títulos traducidos de ese mercado.

New Stuff!