Uso de etiquetas Twig en la descripción avanzada de artículos de eBay

M2E Multichannel Connect es compatible con las etiquetas Twig en las descripciones avanzadas de eBay, lo que le permite controlar mejor cómo aparece la información de sus productos. Esta función está diseñada para usuarios experimentados familiarizados con HTML y la lógica de las plantillas.

Twig le permite crear plantillas dinámicas, condicionales y flexibles en su Descripción Política.

Con Twig, puede:

• Mostrar contenido diferente según el tipo de anuncio (por ejemplo, simple frente a variacional).
• Formatear el texto automáticamente (por ejemplo, convertirlo a mayúsculas).
• Omitir los campos vacíos para evitar que los datos que faltan rompan el diseño.
• Insertar productos relacionados o resaltar los detalles de las variaciones de forma dinámica.

💡 Para obtener instrucciones básicas de configuración, consulte la guía de descripción avanzada de artículos de eBay.

Para obtener una lista completa de la sintaxis y las etiquetas compatibles, visite la documentación oficial de Twig. A continuación se indican los aspectos esenciales para trabajar con Twig en M2E Multichannel Connect.

Variables dinámicas y colecciones #

M2E admite una serie de variables y colecciones predefinidas que puede utilizar en sus plantillas Twig. Estas variables le ayudan a representar dinámicamente datos específicos de productos, catálogos y eBay.

Variable	Descripción	Condiciones de renderizado
isVariant	Devuelve true si el producto tiene variantes.	Se utiliza para mostrar de forma condicional contenido relacionado con variantes.
isMultiVariant	Indica que el producto pertenece a un grupo de variantes principal.	Renders solo para grupos de variantes.
{{sku}}, {{title}}, {{price}}, {{description}}, etc.	Atributos comunes de los productos de tu tienda o catálogo.	Siempre disponible, salvo que esté vacío.
{#attributeName#}	Atributos adicionales creados en tu tienda o catálogo M2E.	Solo se renderiza si el atributo existe y tiene un valor.
ebay.site	El dominio del mercado eBay (por ejemplo, ebay.com, ebay.co.uk).	Siempre disponible para anuncios activos.
ebay.itemId	El ID de eBay del artículo.	Disponible una vez que el artículo esté listado.
ebay.category, ebay.categoryPath	El nombre de la categoría y la ruta completa de la categoría.	Disponible para anuncios activos.
suggestedProducts	Muestra productos similares o relacionados en tu descripción.	Se renderiza automáticamente cuando se anuncian artículos similares en bloque (4 por variable).

ℹ️ Las variables vacías o que faltan se omiten automáticamente si se envuelven en condiciones {% if ... is not empty %}.

Etiquetas comunes de Twig #

Twig proporciona operadores lógicos y herramientas de formato para crear contenido dinámico. Estas son las más útiles para las plantillas de eBay:

• {% if ... %} ... {% endif %} – muestra el contenido si una condición es verdadera.
• {% if not ... %} ... {% endif %} – muestra el contenido si una condición es falsa.
• {% if … is not empty %} – comprueba si existe un valor antes de mostrarlo.
• {% set … = … %} – asigna un valor de atributo a una variable Twig.

💡 Consulte la lista completa de etiquetas disponibles en la documentación de Twig.

Casos de uso prácticos #

A continuación se muestran ejemplos comunes de cómo puede utilizar Twig para que sus descripciones de eBay sean más dinámicas y se adapten mejor a los datos del producto. Cada ejemplo incluye una breve explicación de cuándo utilizarlo, seguida del fragmento de código Twig y lo que hace en la práctica.

Caso práctico 1: Añadir atributos de producto #

Puede insertar atributos o metacampos de su tienda o catálogo M2E en la descripción del artículo de eBay. Estos atributos le permiten mostrar automáticamente detalles del producto, como títulos, SKU, etc., o campos personalizados como marca, material, etc.

Hay dos tipos de atributos que puede utilizar:

• Atributos comunes – campos estándar de la tienda, como título, descripción, SKU o precio.
  Formato: {{title}}, {{shortDescription}}, {{sku}}, etc.
• Atributos de tienda/catálogo – atributos personalizados creados en su tienda o catálogo M2E, por ejemplo, marca o material.
  Formato: {#brand#}, {#vendor#}, {#material#}, etc.

A continuación, te explicamos cómo puedes mostrarlos y darles formato en tu plantilla:

{% if sku is not empty %}
  <p>SKU: {{sku}}</p>
  <p>SKU (UPPER): {{ sku|upper }}</p>
{% endif %}
{% if '{#brand#}' is not empty %}
  <p>Brand: {{ '{#brand#}' }}</p>
{% endif %}

Cómo funciona:

• La variable {{sku}} extrae datos del campo SKU de su tienda.
• La variable {#brand#} extrae datos de su catálogo M2E o del atributo de la tienda.
• La condición garantiza que los atributos vacíos se omitan automáticamente.

Puede insertar atributos utilizando el menú desplegable Insertar variable en el editor avanzado de descripciones de artículos de eBay.

Caso de uso 2: Mostrar contenido para listados variacionales #

Cuando vendes productos con múltiples variantes (como Color o Talla), es posible que desees mostrar un breve aviso que anime a los compradores a explorar todas las opciones disponibles.

Ejemplo de código:

{% if isVariant %}
<p style="color: green">✅ Product has variations: try it in 12 colors and 7 sizes!</p>
{% endif %}

Cómo funciona:

El bloque solo aparecerá en los anuncios que tengan variaciones (isVariant = true). Si un anuncio no incluye variaciones, este mensaje se omitirá automáticamente.

Caso de uso 3: Mostrar contenido para anuncios simples #

Si su producto no tiene variaciones, puede mostrar un mensaje personalizado o un diseño destinado a anuncios de un solo artículo.

Ejemplo de código:

{% if not isVariant %}
<p style="color: red">❌ Product has NO variations! 1 size, 1 color.</p>
{% endif %}

Cómo funciona:

La condición not isVariant garantiza que el mensaje solo aparezca en anuncios simples (isVariant = false). Esto ayuda a diferenciar las plantillas basadas en variaciones y las de un solo producto dentro de una misma descripción.

Caso de uso 4: omitir campos vacíos #

A veces, a los productos les faltan atributos opcionales (como el peso, la marca o el material). Si insertas estos atributos directamente, es posible que tu descripción muestre líneas en blanco o un formato incorrecto.

Puede evitarlo comprobando si el valor existe antes de mostrarlo.

Ejemplo de código:

{% set weight = '{#weight_test#}' %}
{% if weight is not empty %}
  <p>Weight: {{ weight }}</p>
{% endif %}

Cómo funciona:

• {% set %} asigna el valor del atributo a una variable local.
• {% if weight is not empty %} garantiza que la línea solo se muestre si el peso existe. Si un producto no tiene un valor de peso, se omite todo el párrafo, lo que mantiene limpio el diseño.

Caso de uso 5: Dar formato al texto con filtros Twig #

Los filtros Twig te permiten ajustar cómo se muestran tus datos, por ejemplo, convertir el texto a mayúsculas, recortar espacios o poner palabras en mayúsculas.

Ejemplo de código:

<p>Vendor: {{ '{#vendor#}' }}</p>
<p>Vendor (UPPER): {{ '{#vendor#}'|upper }}</p>

Cómo funciona:

• El filtro |upper transforma el texto a mayúsculas.
• Puede utilizar otros filtros como |capitalize, |lower o incluso |replace para manipular cadenas.

Caso de uso 6: Mostrar variables de eBay #

Además de los datos de la tienda y el catálogo, también puede mostrar información de eBay en tiempo real en su descripción. Esto es útil para incluir elementos dinámicos como ID de artículos, categorías o enlaces a su anuncio en tiempo real.

Ejemplo de código:

<p>eBay site: <strong>{{ ebay.site }}</strong></p>
<p>Item ID: <strong>{{ ebay.itemId }}</strong></p>
<p>
  <a href="https://{{ ebay.site }}/{{ ebay.itemId }}" target="_blank">
    View this product on eBay
  </a>
</p>
<p>Category path: <strong>{{ ebay.category }} – {{ ebay.categoryPath }}</strong></p>

Cómo funciona:

• El objeto ebay proporciona detalles del anuncio en tiempo real una vez publicado el artículo.
• Puede utilizar estas variables para enlazar automáticamente con su anuncio de eBay o mostrar la ruta de su categoría.

Vista previa de la descripción avanzada #

Puede hacer clic en Vista previa en el editor de la Descripción Política de eBay para ver cómo quedará el diseño final en eBay antes de publicarlo.

✅ Si tienes alguna pregunta o necesitas ayuda para configurar tu descripción avanzada de eBay, ponte en contacto con nuestro equipo de asistencia.