· 4 min de lectura
Gestionar feeds de productos por API: crear, acceso SFTP, historial de subidas y archivo
Hasta octubre, el feed de productos era la última pieza de ChatGPT Ads que solo se podía gestionar en el OpenAI Ads Manager: crearlo, obtener credenciales, revisar subidas. La API de anunciantes cubre ahora ese flujo, y Chatvertise lo ha integrado en la página «Product Feeds». Este artículo recorre el ciclo de vida de un feed, señala los límites que siguen vigentes y describe una rareza que sorprende al pausar el acceso SFTP.
Un feed desde su creación hasta el archivo
- 1
Crear el feed
Definir nombre y países; al principio el feed es un contenedor vacío.
Falla aquí con:
falta name → 400 - 2
Crear el acceso SFTP
Contraseña (visible una sola vez) o clave SSH pública; la dirección de conexión es fija.
- 3
Subir el catálogo
Por SFTP, archivo o en el OpenAI Ads Manager; la API en sí no acepta productos.
- 4
Revisar el procesamiento
Historial de subidas con estado, número de filas y diagnósticos por subida.
- 5
Conectar una campaña de feed
Product sets por grupo de anuncios, anuncio plantilla; ajuste «sustitución completa» por subida.
Archivar
Solo sin campañas conectadas; después el feed desaparece de la lista.
1. Crear el feed
Un feed nuevo solo necesita dos datos: un nombre y la lista de países a los que se aplica. Sin nombre, la API lo rechaza. El resultado es un contenedor vacío con un ID de feed; todavía no contiene productos. En Chatvertise está en «Crear un feed nuevo», en la página de Product Feeds.
2. Crear el acceso SFTP
Para subir por SFTP generas credenciales para el feed: una contraseña o una clave SSH pública. La dirección de conexión es fija y se muestra junto a ellas. Dos cosas importan: la contraseña tiene 32 caracteres y se muestra exactamente una vez; Chatvertise no la guarda. Y quien elige SSH tiene que enviar la clave pública, si no la API responde con un error.
3. Subir el catálogo
Aquí termina la API: los productos siguen sin poder subirse a través de la API de anunciantes, solo por SFTP, como archivo o en Ads Manager. Puedes ajustar productos concretos después mediante una actualización delta, por ejemplo disponibilidad o título, pero no cargar el catálogo. Para los comerciantes de Shopify, la importación de Shopify sigue siendo el camino más corto, porque evita la subida del feed.
4. Revisar el procesamiento
Tras la subida, la API muestra un historial de todas las subidas de la cuenta con estado, número de filas y diagnósticos. Chatvertise las lista en la tabla «Últimas subidas del feed»: qué subida se procesó cuándo, cuántas filas tenía y qué filas rechazó OpenAI y con qué motivo. Eso sustituye la espera a ciegas de si un catálogo ha llegado. La lista de las subidas más recientes por feed va aparte, y con muchas subidas el historial se carga por páginas.
5. Ajustes y campaña de feed
Además del nombre, los países y la cuestión de si se respeta la disponibilidad de búsqueda de los productos, hay un ajuste llamado «Reemplazo completo en cada subida»: si está activado, cada subida sustituye el catálogo completo; si está desactivado, solo añade cambios. Quien exporta cada noche el catálogo entero quiere «activado»; quien solo envía deltas, «desactivado». En cuanto hay productos, sigue la campaña de feed con product sets y anuncio plantilla.
6. Archivar
Un feed que ya no se necesita se puede archivar. Después desaparece de la lista y su acceso SFTP deja de poder consultarse. La llamada es idempotente: archivar una segunda vez no es un error. Chatvertise bloquea el botón mientras haya campañas conectadas al feed, para que ninguna campaña de feed en marcha pierda su fuente.
La rareza al pausar el acceso SFTP
El acceso SFTP se puede pausar, por ejemplo cuando cambia un proveedor. Lo que uno esperaría: activar restablece el acceso anterior. Lo que ocurre en realidad: tras pausar, el método de autenticación queda vacío, y activar deja el acceso desactivado. Tienes que generar credenciales nuevas. Chatvertise lo indica en ese punto; en la práctica significa que pausar es una revocación, no un interruptor.
Qué cambia con variantes y disponibilidad
Desde octubre, la consulta de productos de un feed devuelve variante, disponibilidad e ID de oferta por producto. Chatvertise pasa esos campos a la vista previa de productos. Para los product sets significa que un filtro de mercancía disponible es posible en cuanto el feed incluye la disponibilidad.
Para quién es relevante
- Agencias que gestionan feeds para varios clientes: crear, generar acceso y revisar diagnósticos de subida sin entrar en cada Ads Manager.
- Tiendas con exportación propia: el job SFTP nocturno gana un paso de comprobación que hace visibles las filas fallidas.
- Todos los demás: quien tiene un feed y solo lo consulta rara vez necesitará las nuevas funciones. Aun así, el historial de subidas merece un vistazo tras cada actualización del catálogo.
Todas las novedades del mes, incluidos los endpoints de cuenta, están en la actualización de finales de octubre.
Preguntas frecuentes
- ¿Ya puedo subir productos a través de la API?
- No. La API crea feeds, gestiona credenciales y muestra resultados de subida, pero el catálogo en sí sigue llegando por SFTP, archivo o Ads Manager. Los productos concretos se pueden modificar mediante una actualización delta.
- ¿Qué pasa si pierdo la contraseña SFTP?
- No se puede volver a mostrar. Genera una contraseña nueva; sustituye a la anterior.
- ¿Puedo recuperar un feed archivado?
- No. A diferencia de los anuncios, los feeds no tienen salida del archivo. Si lo necesitas, crea un feed nuevo y vuelve a subir el catálogo.