Introducción al feed de OpenAI Commerce
OpenAI Commerce es una plataforma de distribución de productos que permite a los comerciantes mostrar sus catálogos en entornos de búsqueda y compra potenciados por inteligencia artificial. A través de esta plataforma, las tiendas en línea España pueden alcanzar clientes que utilizan herramientas de búsqueda y asistentes de compra basados en tecnología de OpenAI.
El feed de productos para OpenAI Commerce actúa como el puente entre tu sistema de gestión de inventario online y la plataforma de distribución. Un feed bien estructurado y optimizado determina si tus productos aparecen en los resultados de búsqueda, si pueden procesarse en el checkout, y si son elegibles para campañas de anuncios.
Esta guía cubre todos los campos disponibles, explica por qué cada uno importa para la aprobación de listados, y proporciona recomendaciones prácticas para maximizar la visibilidad de tu catálogo de productos.
Campos de elegibilidad y control de visibilidad
Tres campos booleanos controlan dónde y cómo aparecen tus productos en la plataforma:
is_eligible_search determina si un artículo puede aparecer en los resultados de búsqueda. Si estableces este campo en falso, el producto no será indexado para búsquedas, aunque siga siendo válido en tu catálogo. Esto es útil para productos en fase de lanzamiento o artículos que deseas mantener disponibles solo bajo consulta.
is_eligible_checkout controla si el producto puede procesarse a través del flujo de compra integrado de OpenAI Commerce. Un producto puede ser buscable pero no procesable si tiene restricciones logísticas o de pago que requieren intervención manual del vendedor.
is_eligible_ads indica si el artículo es elegible para campañas de anuncios pagados dentro de la plataforma. Algunos productos, como los de marcas restringidas o categorías reguladas, pueden estar disponibles para búsqueda y compra pero no para publicidad.
Estos tres campos funcionan de forma independiente. Un producto puede ser searchable pero no elegible para anuncios, o elegible para checkout pero no para búsqueda orgánica. Revisa regularmente estos campos para asegurar que tu estrategia de visibilidad se alinea con tus objetivos de venta.
Identificadores de producto y datos básicos
Los identificadores únicos son críticos para evitar duplicados y garantizar el seguimiento correcto del inventario:
| Campo | Tipo | Obligatorio | Propósito |
|---|---|---|---|
| item_id | Texto | Sí | Identificador único del producto en tu sistema |
| gtin | Texto | Recomendado | Código de barras global (EAN, UPC) |
| mpn | Texto | Recomendado | Número de parte del fabricante |
| group_id | Texto | Condicional | Agrupa variantes del mismo producto |
| offer_id | Texto | Condicional | Identifica una oferta específica de un vendedor |
item_id debe ser único dentro de tu cuenta y consistente en cada actualización del feed. Si cambias el item_id de un producto, la plataforma lo tratará como un artículo nuevo, perdiendo historial de rendimiento y reseñas.
gtin acelera significativamente la aprobación de listados. Los productos con GTIN válido se verifican automáticamente contra bases de datos de fabricantes, reduciendo rechazos por información incorrecta. Si tu producto no tiene GTIN asignado, la aprobación manual tardará más tiempo.
mpn es especialmente importante para electrónica, componentes y artículos técnicos. Muchos clientes buscan por número de parte para encontrar exactamente el producto que necesitan.
group_id agrupa variantes como talla, color o material bajo un único producto lógico. Sin group_id, cada variante aparecerá como un artículo separado en los resultados de búsqueda, fragmentando tu visibilidad.
Información de producto y descripción
Los campos de contenido determinan cómo los clientes y los algoritmos de búsqueda entienden qué vendes:
title debe incluir el nombre del producto, la marca y el atributo diferenciador principal (talla, color o especificación clave). Ejemplo: "Zapatillas Nike Air Max 90 Blancas Talla 42". Títulos genéricos o truncados reducen la relevancia en búsqueda.
description proporciona contexto adicional. Incluye características principales, materiales, dimensiones y uso previsto. La descripción debe ser legible por humanos, no una lista de palabras clave. Los algoritmos de búsqueda penalizan el relleno de palabras clave.
brand es obligatorio para la mayoría de categorías. Si tu producto es de marca propia, usa el nombre de tu tienda. Un brand incorrecto o inconsistente causa rechazos de listado y reduce la confianza del cliente.
product_category clasifica el artículo en la taxonomía de OpenAI Commerce. Usa categorías específicas, no genéricas. "Electrónica > Smartphones > Teléfonos inteligentes Android" es mejor que "Electrónica".
condition especifica el estado del producto: nuevo, reacondicionado o usado. Los productos reacondicionados requieren documentación adicional de garantía. Los usados deben incluir una descripción clara del desgaste o daños.
Atributos de variante y características
Los campos de atributos permiten a los clientes filtrar y encontrar exactamente lo que buscan:
| Campo | Aplicación |
|---|---|
| size | Ropa, calzado, accesorios |
| size_system | Especifica si es EU, US, UK, talla única, etc. |
| color | Cualquier producto disponible en múltiples colores |
| gender | Ropa, calzado, accesorios de género específico |
| age_group | Juguetes, ropa infantil, productos de cuidado |
| material | Muebles, ropa, accesorios |
Si tu producto tiene variantes, crea un registro de feed separado para cada combinación de atributos y asigna el mismo group_id a todos. Por ejemplo, una camiseta disponible en rojo/S, rojo/M, azul/S y azul/M requiere cuatro registros con el mismo group_id.
Los campos de atributos mejoran significativamente la experiencia de búsqueda y reducen devoluciones causadas por confusión sobre especificaciones.
Precios, disponibilidad y promociones
La información de precios y stock determina si un cliente puede completar la compra:
price es el precio regular del producto. Debe incluir impuestos si es obligatorio en tu país. Cambios frecuentes en price sin actualizar el feed causan discrepancias que generan desaprobación de listados.
sale_price, sale_price_start_date y sale_price_end_date comunican promociones temporales. La plataforma valida que sale_price sea menor que price y que las fechas sean válidas. Un sale_price mayor que price causa rechazo automático.
availability indica si el producto está en stock ("in stock"), agotado ("out of stock") o disponible bajo pedido ("available for order"). Este campo afecta directamente a is_eligible_checkout. Los productos sin stock pueden aparecer en búsqueda pero no en el flujo de compra.
availability_date especifica cuándo un producto agotado volverá a estar disponible. Si proporcionas una fecha futura, la plataforma puede mantener el listado activo y notificar a clientes interesados.
unit_pricing_measure y base_measure comunican el precio por unidad (por kg, por litro, por 100 ml). Esto es obligatorio en muchos países para productos de consumo. Ejemplo: unit_pricing_measure="0.5" base_measure="l" indica que el precio es por medio litro.
Información de vendedor y políticas
Los datos del vendedor establecen confianza y transparencia:
seller_name debe coincidir exactamente con el nombre registrado de tu negocio en OpenAI Commerce. Inconsistencias generan alertas de verificación.
seller_url debe apuntar a tu página de inicio o a una página de perfil de vendedor. No uses URLs de productos individuales.
return_policy comunica las condiciones de devolución. Especifica el período de devolución en días, si el cliente paga envío de retorno, y cualquier restricción. Ejemplo: "30 días, envío pagado por el cliente, excepto defectos de fabricación". Una política clara reduce disputas y rechazos de pago.
seller_privacy_policy y seller_tos deben enlazar a documentos legales completos en tu sitio web. URLs rotas o contenido no coincidente causan rechazos de aprobación.
Datos de envío y logística
Los campos de envío permiten a los clientes entender opciones y tiempos de entrega:
pickup_method especifica si el cliente puede recoger en tienda, en punto de recogida, o solo envío a domicilio. Esto es crítico para productos voluminosos o pesados.
pickup_sla comunica el tiempo de entrega esperado (por ejemplo, "1-2 días laborales", "3-5 días hábiles"). El SLA debe ser realista. Promesas incumplidas generan devoluciones y reseñas negativas.
weight, item_weight_unit, length, width, height y dimensions_unit son necesarios para calcular costos de envío y verificar si un producto cabe en cajas estándar. Dimensiones incorrectas causan sorpresas en el checkout y devoluciones.
Para productos pequeños o ligeros, estos campos son opcionales pero recomendados. Para muebles, electrodomésticos o cualquier artículo voluminoso, son obligatorios.
Imágenes y presentación visual
image_url debe apuntar a una imagen de alta resolución (mínimo 800x800 píxeles) del producto. La imagen debe mostrar el producto en su contexto real, no solo el embalaje. Imágenes borrosas, cortadas o con marca de agua causan rechazos.
additional_image_urls permite hasta 10 imágenes adicionales. Incluye vistas desde diferentes ángulos, detalles de características, y el producto en uso. Más imágenes reducen devoluciones causadas por expectativas incorrectas.
Las imágenes deben ser de tu propiedad o tener licencia explícita de uso. Imágenes robadas de competidores causan rechazos y pueden resultar en suspensión de cuenta.
Campos de dirección geográfica
store_country indica el país donde se almacena o envía el producto. Este es el país del vendedor, no el país de destino.
target_countries especifica en qué países estás dispuesto a enviar. Si tu tienda opera en España pero envías a toda la UE, establece target_countries con la lista de países relevantes. La plataforma usa este campo para mostrar productos solo a clientes en territorios elegibles.
Si no proporcionas target_countries, la plataforma asume que el producto está disponible globalmente, lo que puede generar pedidos imposibles de cumplir.
Optimización práctica del feed
Validación y limpieza de datos
Antes de enviar el feed a OpenAI Commerce, valida cada campo contra los requisitos:
- Verifica que item_id sea único y no cambie entre actualizaciones.
- Confirma que gtin, si se proporciona, sea válido usando un validador de checksum.
- Asegúrate de que price sea mayor que sale_price (si sale_price existe).
- Comprueba que availability sea uno de los valores permitidos: "in stock", "out of stock", "available for order".
- Valida que image_url responda con código 200 y sea una imagen real.
- Verifica que todas las URLs de política sean accesibles y contengan información completa.
Actualización del feed
Actualiza el feed con frecuencia, al menos diariamente. Los cambios de inventario deben reflejarse en pocas horas. Si un producto se agota, cambia availability a "out of stock" inmediatamente. Discrepancias entre el feed y tu sitio web generan desaprobación y pérdida de confianza del cliente.
Monitoreo de rechazos
OpenAI Commerce proporciona informes de rechazos. Revisa regularmente qué productos fueron desaprobados y por qué. Los motivos comunes incluyen:
- Información de contacto del vendedor incompleta.
- Política de devolución poco clara o no vinculada.
- Imágenes de baja calidad o no disponibles.
- Precio inconsistente entre feed y sitio web.
- Categoría de producto incorrecta.
Corrige estos problemas en el feed y vuelve a enviar. La mayoría de rechazos se resuelven en la siguiente actualización.
Estrategia de atributos
Usa todos los campos de atributos relevantes para tu categoría. Un producto con atributos completos aparece en más búsquedas de filtro y tiene mejor posición en resultados. Por ejemplo, una zapatilla sin color, talla o material especificados aparecerá menos frecuentemente que una con todos estos campos completos.
Resumen
El feed de OpenAI Commerce es la base de tu visibilidad en la plataforma. Un feed bien estructurado, con datos precisos y actualizados regularmente, mejora significativamente la aprobación de listados, la experiencia del cliente y las tasas de conversión.
Los campos de elegibilidad (is_eligible_search, is_eligible_checkout, is_eligible_ads) te permiten controlar dónde aparecen tus productos. Los identificadores únicos (item_id, gtin, mpn) garantizan un seguimiento correcto. Los datos de contenido (title, description, brand, product_category) mejoran la relevancia en búsqueda. Los atributos (color, talla, material) permiten filtrado preciso. Los campos de precio y disponibilidad aseguran que los clientes puedan completar compras. Los datos del vendedor y políticas establecen confianza.
Implementa un proceso de validación y actualización regular del feed. Monitorea los rechazos y corrige los problemas sistemáticamente. Con estos pasos, tu catálogo de productos será más visible, más confiable y generará más ventas en OpenAI Commerce.