Categorías de Producto de Google — Descarga de la Lista de Taxonomía
Antes de poder asignar Categorías de Producto de Google a las categorías de tu tienda, debes descargar la lista oficial de taxonomía de Google. Esta descarga con un solo clic obtiene la lista directamente desde Google y la almacena localmente para que el autocompletado de categorías funcione sin conexión.
Disponible desde v1.0.3
Descripción general
Google mantiene una lista estandarizada de categorías de producto —conocida como la Taxonomía de Productos de Google— que Facebook e Instagram utilizan para clasificar los productos de tu catálogo. Cada categoría tiene un ID numérico y una ruta legible como Apparel & Accessories > Clothing > Dresses.
El módulo necesita una copia local de esta lista para potenciar el campo de autocompletado del panel Google Product Category Association. Sin ella, ese panel no está disponible y no puedes mapear las categorías de tu tienda a las de Google.
El archivo de taxonomía se descarga desde los servidores públicos de Google y se guarda dentro de la carpeta del módulo como downloads/{lang}.txt. El módulo intenta obtener la taxonomía en el idioma predeterminado de tu tienda (por ejemplo, fr-FR.txt para tiendas en francés) y, si no hay una versión localizada disponible, utiliza el inglés (en-US.txt) como alternativa.
Cómo descargar o actualizar la lista
- Ve a Módulos > Gestor de módulos, busca Facebook & Instagram Product Catalogue Feed Pro y haz clic en Configurar.
- En el menú de navegación izquierdo, haz clic en Google Product Categories List (la pestaña con el icono de descarga).
- Si la lista nunca se ha descargado, el panel muestra un aviso para que la descargues. Si ya hay una lista presente, el panel muestra la fecha de la última actualización.
- Haz clic en Download Google Product Categories.
- El módulo obtiene el archivo más reciente desde los servidores de Google y lo guarda. Cuando la descarga finaliza, aparece un banner de confirmación en verde.
Una vez completada la descarga, el panel Google Product Category Association se activa y puedes empezar a mapear las categorías de tu tienda.
Cuándo actualizar la lista
Google actualiza su taxonomía varias veces al año: se añaden nuevas categorías, algunas se renombran y las obsoletas se eliminan. El panel muestra la fecha del archivo actual para que puedas valorar su antigüedad.
Actualiza la lista cuando:
- El archivo actual tenga más de unos pocos meses de antigüedad.
- Notes que una categoría que necesitas no aparece en las sugerencias del autocompletado.
- Google anuncie una actualización de la taxonomía (publica notas de versión en el Centro de Ayuda de Commerce).
- Acabas de instalar el módulo por primera vez — la rutina de instalación intenta una descarga automática, pero actualizar manualmente confirma que el archivo está al día.
No hay ningún inconveniente en descargar con más frecuencia. La operación tarda unos segundos, reemplaza el archivo local y no afecta a las asociaciones de categorías que ya hayas guardado.
Notas importantes
Alternativa de idioma. El módulo intenta primero descargar la taxonomía en el idioma predeterminado de tu tienda. Por ejemplo, una tienda configurada en español descarga es-ES.txt. Si Google no publica un archivo para ese locale, el módulo utiliza en-US.txt como alternativa. De cualquier forma, el autocompletado funciona, aunque los nombres de las categorías estarán en el idioma del archivo descargado con éxito.
Conectividad del servidor. La descarga se conecta a https://www.google.com/basepages/producttype/taxonomy-with-ids.{lang}.txt. Si tu servidor tiene restricciones de HTTP/HTTPS saliente o un cortafuegos que bloquea solicitudes a hosts externos, la descarga fallará. En ese caso, pide a tu proveedor de hosting que permita conexiones salientes a www.google.com, o descarga el archivo manualmente desde esa URL y súbelo a modules/facebookproductsfeed/downloads/en-US.txt.
Permisos de archivo. Si el módulo no puede escribir en la carpeta downloads/, verás un error que te pide revisar los permisos de escritura de archivos y carpetas. El directorio downloads/ dentro del módulo debe tener permisos de escritura para el usuario del servidor web (normalmente www-data).
Las asociaciones de categorías se conservan. Actualizar la lista de taxonomía solo actualiza el archivo de texto local utilizado para el autocompletado. No modifica ni elimina ningún ID de categoría de Google que ya hayas asignado a las categorías de tu tienda en la base de datos.
Multi-tienda. El archivo descargado se comparte entre todas las tiendas. Las asociaciones de categorías de cada tienda se almacenan por separado, pero todas usan el mismo archivo de taxonomía para las sugerencias de autocompletado.
Resolución de problemas
| Problema | Solución |
|---|---|
| La descarga falla con un error de red | Confirma que tu servidor puede acceder a www.google.com en el puerto 443. Contacta con tu proveedor si las conexiones salientes están bloqueadas. |
| Error "Couldn't create the file" | La carpeta downloads/ no tiene permisos de escritura. Establece sus permisos en 755 (o 775) y asegúrate de que sea propiedad del usuario del servidor web. |
| El autocompletado de categorías no muestra resultados tras la descarga | Vacía la caché del Back Office de PrestaShop (Parámetros avanzados > Rendimiento > Vaciar caché) y recarga la página de configuración. |
| El panel sigue mostrando "debes descargar" tras una descarga exitosa | La confirmación se mostró pero la página no se recargó. Pulsa F5 o navega de nuevo a la pestaña Google Product Categories List. |
| El archivo descargado está en inglés pero mi tienda está en otro idioma | Es posible que Google no publique un archivo de taxonomía para el locale de tu tienda. La lista en inglés se utiliza como alternativa — todos los IDs de categoría son universales independientemente del idioma. |
Preguntas frecuentes
¿Necesito descargar la lista de taxonomía de nuevo tras actualizar el módulo?
No. El archivo persiste entre actualizaciones del módulo. Descarga una copia nueva solo cuando quieras incorporar categorías nuevas o renombradas por parte de Google.
¿Qué ocurre con mis mapeos de categorías existentes si actualizo la lista de taxonomía?
Nada. Tus mapeos se almacenan en la base de datos por ID de categoría de Google, no por nombre. Actualizar el archivo de texto local no altera esos IDs ni elimina ninguna asociación.
¿Puedo usar el panel Google Product Category Association sin descargar la lista?
No. El árbol de categorías y el autocompletado del panel de Asociación solo se muestran una vez que hay un archivo de taxonomía en downloads/. La descarga es un requisito previo que solo hay que realizar una vez.
¿El módulo me notifica cuando Google actualiza la taxonomía?
No. No hay ninguna notificación automática. Comprueba periódicamente la fecha de la última actualización que se muestra en el panel y actualiza cuando tenga más de unos pocos meses.
¿Por qué el autocompletado muestra nombres de categorías en inglés aunque mi tienda esté en francés?
Google solo publica archivos de taxonomía localizados para ciertos idiomas. Si no hay un archivo para el locale francés (fr-FR.txt), el módulo descarga en-US.txt en su lugar. Los IDs de categoría son los mismos en todos los idiomas, por lo que tu feed sigue siendo válido independientemente del idioma que use el archivo local.