Esta guía explica cómo generar un archivo XML que contenga todo el catálogo de productos, esencial para sincronizar tus productos con plataformas publicitarias y de venta como Google Merchant Center, TikTok Shop o Facebook Catalog.
Dado que la generación del feed se realiza a través de una dirección web específica (URL), la configuración se efectúa agregando parámetros a dicha dirección.
1. Construcción de la URL Base
Para generar el feed, debes acceder a una URL específica de tu sitio. La URL base depende del formato y la plataforma de destino.
1. Identifica tu dominio (ej. https://tuosito.com).
2. Agrega la ruta del feed /api/plugin/ecommerceFeeds/.
3. Elige el tipo de feed que deseas generar:
| Plataforma | Tipo de Feed | Ejemplo de URL Base |
|---|---|---|
| Google Merchant / Standard | standard.xml | https://tuosito.com/api/plugin/ecommerceFeeds/standard.xml |
| TikTok Shop | tiktok.xml | https://tuosito.com/api/plugin/ecommerceFeeds/tiktok.xml |
> Nota: Si accedes a esta URL sin parámetros adicionales, se generará el feed completo con todos los productos activos.
2. Configuración Avanzada del Feed (Filtros y Variantes)
Puedes personalizar el contenido del feed añadiendo parámetros de configuración después de un signo de interrogación (?) en la URL base.
2.1. Inclusión de Variantes (Talla, Color, Marca)
Si tus productos tienen variantes (ej. tallas o colores), debes especificar qué atributos deben mapearse en los campos estándar de Google/TikTok (color, size, brand).
Debes identificar el ID numérico del atributo que representa la Talla, el Color, etc., en tu sistema de gestión de productos.
| Propósito | Parámetro | Ejemplo (Si el ID 5 es Color) |
|---|---|---|
| Color | v[c]=ID_ATRIBUTO | ?v[c]=5 |
| Talla | v[s]=ID_ATRIBUTO | ?v[s]=12 |
| Marca | v[b]=ID_ATRIBUTO | ?v[b]=8 |
Ejemplo de URL con Variantes:
Si quieres incluir las variantes Talla (ID 12) y Color (ID 5):
.../tiktok.xml?v[s]=12&v[c]=5
2.2. Filtrar por Categoría
Es posible incluir o excluir productos basándose en las categorías, utilizando los IDs de las categorías.
| Propósito | Parámetro | Ejemplo |
|---|---|---|
| Incluir Categorías | include_cats=ID1,ID2 | ?include_cats=1,2,5 |
| Excluir Categorías | exclude_cats=ID1,ID2 | ?exclude_cats=10,11 |
2.3. Mapeo de Etiquetas Personalizadas (Custom Labels)
Las etiquetas personalizadas (customlabel0 hasta customlabel4) son útiles para organizar los productos en campañas publicitarias. Puedes mapear estas etiquetas a:
- Categorías: Para incluir la jerarquía completa de categorías del producto.
- Atributos: Para incluir el valor de un atributo específico (ID numérico).
- Texto Fijo: Para incluir una cadena fija.
| Etiqueta | Parámetro | Valor Ejemplo | Descripción |
|---|---|---|---|
customlabel0 | c[0] | categories | Inserta la ruta completa de las categorías. |
customlabel1 | c[1] | 15 | Inserta el valor del Atributo con ID 15. |
customlabel2 | c[2] | Estate2024 | Inserta la cadena fija "Estate2024". |
3. Generación del Feed Final
Para generar el feed, pega la URL completa en el navegador (o proporciónala a la plataforma destino).
Ejemplo de URL Completa (TikTok Shop):
Genera el feed para TikTok Shop incluyendo las variantes Talla (ID 12) y Color (ID 5), y mapeando customlabel0 a la ruta de las categorías:
https://tuosito.com/api/plugin/ecommerceFeeds/tiktok.xml?v[s]=12&v[c]=5&c[0]=categories
Una vez abierta la URL, el sistema procesará los datos y devolverá directamente el archivo XML (o CSV, si se solicita) que podrás guardar o utilizar para la sincronización automática.
> Importante: El proceso de generación del feed puede tardar varios segundos (hasta 120 segundos, según la cantidad de productos) para evitar interrupciones.
