Introducción
Los feeds de texto personalizado (custom_txt) permiten a los comerciantes distribuir información de productos mediante un formato de texto delimitado flexible. A diferencia de los formatos estándar como CSV o XML, los feeds de texto personalizado ofrecen mayor control sobre la estructura de los datos y el delimitador utilizado. Este artículo explica cómo configurar, mapear campos y optimizar un feed de texto personalizado para garantizar que los datos se procesen correctamente en canales de distribución de terceros.
Estructura y formato del feed de texto personalizado
Un feed de texto personalizado utiliza delimitadores específicos para separar campos y registros. La estructura básica consta de:
- Encabezado de columnas: Primera fila que define el nombre de cada campo.
- Filas de datos: Cada fila representa un producto con sus atributos separados por el delimitador elegido.
- Delimitador: Carácter o secuencia que separa los campos (tabulaciones, tuberías, comas u otros caracteres).
La elección del delimitador es crítica. Si el delimitador aparece dentro de los valores de los campos, los datos se procesarán incorrectamente y el producto no se aprobará en el canal. Por ejemplo, si utiliza comas como delimitador y una descripción de producto contiene comas, debe escapar esos caracteres o cambiar a un delimitador menos probable que aparezca en sus datos.
Mapeo de campos obligatorios y opcionales
Cada canal de distribución requiere un conjunto específico de campos. Los campos obligatorios varían según el destino, pero generalmente incluyen:
| Campo | Descripción | Impacto en aprobación |
|---|---|---|
| id | Identificador único del producto | Sin este campo, el producto no se carga en el sistema |
| title | Nombre del producto | Afecta la búsqueda y la visualización en listados |
| description | Descripción completa del producto | Mejora la relevancia y puede ser requerida por algunos canales |
| price | Precio del producto | Sin precio, el producto no se publica |
| link | URL de la página del producto | Obligatoria para redirigir al usuario a su tienda |
| image_link | URL de la imagen principal del producto | Afecta la aprobación visual y la presentación |
| availability | Estado de disponibilidad (in stock, out of stock, etc.) | Determina si el producto aparece en búsquedas |
| brand | Marca del producto | Algunos canales requieren este campo |
| condition | Estado del producto (new, refurbished, used) | Obligatorio en ciertos canales como marketplaces |
| google_product_category | Categoría estándar de Google | Mejora la clasificación y la relevancia |
| product_type | Categoría personalizada de su tienda | Complementa la categorización del producto |
| gtin | Código de barras (EAN, UPC, ISBN) | Algunos canales lo requieren para validación |
| mpn | Número de parte del fabricante | Ayuda a identificar productos únicos |
| item_group_id | Identificador de grupo para variantes | Agrupa productos relacionados (tallas, colores) |
Configuración práctica del feed de texto personalizado
Selección del delimitador
Antes de crear su feed, elija un delimitador que no aparezca en sus datos. Las opciones comunes son:
- Tabulación (\t): Recomendada porque rara vez aparece en descripciones de productos.
- Tubería (|): Menos común en textos, pero más legible en editores de texto.
- Punto y coma (;): Útil si sus datos contienen comas naturales.
Codificación de caracteres
Guarde el archivo en codificación UTF-8 sin BOM (Byte Order Mark). Esto garantiza que caracteres especiales, acentos y símbolos se procesen correctamente en todos los canales.
Validación antes de envío
Antes de cargar el feed:
- Verifique que el número de campos en cada fila coincida con el encabezado.
- Compruebe que no haya saltos de línea dentro de los valores de campo (a menos que estén escapados).
- Valide que todos los campos obligatorios contengan datos válidos.
- Pruebe con un pequeño lote de productos antes de cargar el feed completo.
Campos opcionales que mejoran la aprobación
Aunque no siempre son obligatorios, estos campos aumentan significativamente las posibilidades de aprobación y mejor rendimiento:
- color: Especifica el color del producto (mejora la búsqueda por atributos).
- size: Indica el tamaño disponible.
- material: Describe el material de fabricación.
- shipping: Costo de envío (algunos canales lo requieren).
- shipping_weight: Peso del producto para cálculos de envío.
- custom_label_0 a custom_label_4: Etiquetas personalizadas para segmentación.
Manejo de caracteres especiales y escapado
Si sus valores contienen el delimitador elegido, deben escaparse. Los métodos comunes son:
- Comillas dobles: Envuelva el valor en comillas dobles:
"valor, con coma". - Barra invertida: Escape el carácter:
valor\,con coma. - Duplicación: Duplique el carácter especial:
valor,,con coma.
Consulte la documentación específica del canal para confirmar el método de escapado aceptado.
Errores comunes y su impacto
| Error | Consecuencia | Solución |
|---|---|---|
| Número de campos inconsistente | El producto se rechaza durante la carga | Valide que cada fila tenga el mismo número de campos |
| Caracteres no escapados | Los datos se dividen incorrectamente | Escape caracteres especiales o cambie el delimitador |
| Valores vacíos en campos obligatorios | El producto no se aprueba | Proporcione datos válidos para todos los campos requeridos |
| URLs mal formadas en image_link o link | El producto se rechaza o no se muestra | Verifique que las URLs sean completas y válidas |
| Codificación incorrecta | Caracteres acentuados aparecen corruptos | Guarde en UTF-8 sin BOM |
Optimización para diferentes canales
Cada canal tiene requisitos específicos. Aunque el formato base es el mismo, los campos requeridos y las validaciones varían. Por ejemplo:
- Marketplaces: Requieren gtin, condition y image_link de alta calidad.
- Redes de afiliación: Necesitan link, price y descripción clara.
- Plataformas de publicidad: Priorizan google_product_category y custom_label para segmentación.
Antes de crear su feed, revise la documentación del canal específico donde lo distribuirá. Si trabaja con múltiples canales, considere crear un feed maestro que incluya todos los campos posibles, luego extraiga solo los necesarios para cada destino.
Actualización y mantenimiento del feed
Los feeds de texto personalizado deben actualizarse regularmente para reflejar cambios en inventario, precios y disponibilidad. Configure un proceso automatizado que:
- Exporte datos de su sistema de gestión de productos.
- Valide la integridad de los datos.
- Aplique transformaciones necesarias (formato de fechas, conversión de moneda).
- Cargue el feed en el canal según una programación (diaria, semanal).
Monitore los registros de carga para identificar errores recurrentes y ajuste su proceso de exportación.
Conclusión
Los feeds de texto personalizado ofrecen flexibilidad para comerciantes que necesitan distribuir datos de productos con estructura específica. El éxito depende de una configuración cuidadosa del delimitador, mapeo completo de campos, validación rigurosa de datos y cumplimiento de los requisitos del canal destino. Siga estas prácticas para garantizar que sus productos se aprueben, se muestren correctamente y generen conversiones en los canales donde se distribuyen.