Solucionar errores y avisos de catálogos de productos
Cada catálogo de productos tiene una puntuación de estado que indica qué problemas, si los hay, están presentes en tu catálogo. Los problemas pueden aparecer en cualquier etapa: cuando el archivo se carga o conecta, después de procesarse o cuando tus socios intentan ver y promocionar tus productos. Usa esta guía para resolver los problemas en cada etapa y llevar tu catálogo al excelente rango.
Consejo: Un catálogo saludable implica más que eliminar errores. Sigue las Mejores prácticas para catálogos de productos para mantener tus datos completos, bien estructurados y preparados para lograr una buena visibilidad y un buen rendimiento.
Puntuaciones de estado del catálogo
En el menú de navegación izquierdo, selecciona
[Engage] → Contenido → Productos → Catálogos de productos.Si un catálogo tiene errores, advertencias o líneas duplicadas, la Estado columna muestra cuántos hay de cada uno.
Los métodos de carga que recuperan automáticamente el catálogo se actualizan solos la próxima vez que se produce un evento de recuperación.
Descripciones de estado
Pendiente
Tu catálogo de productos está a la espera de su primera carga o extracción de datos.
Procesando
Tu catálogo de productos se está procesando.
Excelente
Indica un catálogo saludable. Este conjunto de datos de productos está completo y bien estructurado, lo que le da la mejor oportunidad de rendir eficazmente.
Bueno
Indica que podrían faltar ciertos campos sugeridos que contienen datos cruciales, como la categoría o la descripción. Corregir estas lagunas mejora la calidad general de tu catálogo.
Deficiente
Falta información obligatoria en más del 10 % de los registros que proporcionaste. Este catálogo debe corregirse y volver a cargarse.
Soluciona los problemas de carga y conexión
Antes de que se pueda procesar un catálogo, impact.com debe recibirlo correctamente. Los pasos siguientes están agrupados por el método de carga que seleccionaste al crear el catálogo. Si no estás seguro de qué método se está usando, selecciona el catálogo y revisa su Método de carga configuración.
Carga directa
Los problemas de Carga directa suelen deberse a una discrepancia de formato o de nombre de archivo, o a un archivo que supera el límite de 1 GB.
Formato incorrecto seleccionado
El formato que elegiste (por ejemplo, TXT) no coincide con el archivo que cargaste (por ejemplo, XML).
Vuelve a cargarlo y selecciona el formato que coincida con tu archivo. Los archivos XML usan la .xml los archivos CSV usan .csv, y los archivos delimitados por TAB usan .txt.
El nombre del archivo no coincide
El nombre del archivo que cargaste debe coincidir exactamente con el Nombre de archivo de carga configurado en la configuración de tu catálogo, incluida la extensión.
Cambia el nombre de tu archivo o actualiza el Nombre de archivo de carga para que ambos coincidan exactamente.
El archivo comprimido no se procesará
impact.com admite archivos comprimidos gzip y zip estándar. Un archivo comprimido puede usar una segunda extensión para indicar la compresión, por ejemplo catalog.xml.gz.
Confirma que tu tipo de compresión sea gzip o zip, y que el archivo use las extensiones correctas tanto para su formato como para su compresión.
Servidor FTP de impact.com
La mayoría de los problemas de FTP se deben a la configuración de conexión o a las credenciales.
No se puede conectar al servidor
Confirma que te estás conectando al host products.impact.com en el puerto 21.
Actualiza tu cliente FTP con el host y el puerto correctos y vuelve a conectarte.
Faltan credenciales de FTP
Necesitas el inicio de sesión y la contraseña de FTP emitidos para tu cuenta para conectarte.
Localiza tus credenciales del Sistema de datos de productos FTP en la configuración técnica de tu cuenta. Si no puedes encontrarlas o acceder a ellas, contacta con soporte.
Obtener desde URL
Los protocolos compatibles para Obtener desde URL son http://, https://, ftp://, y sftp://. Si tu catálogo no se está cargando, actualizando o procesando correctamente, usa la tabla siguiente para identificar y resolver el problema.
La URL no es un enlace de descarga directa
Abre tu URL en un navegador. Si redirige a una página de inicio de sesión, a una página de destino de almacenamiento en la nube o devuelve un error 404 o 403, la URL no es un enlace de descarga directa.
Actualiza la URL a una que descargue el archivo directamente o lo muestre como datos sin procesar al abrirla en un navegador.
El nombre del archivo no coincide
El Nombre de archivo de carga en la configuración de tu catálogo debe coincidir exactamente con el nombre real del archivo en la URL, incluida la extensión (.csv, .xml, .txt, .gz).
Actualiza el Nombre de archivo de carga para que coincida exactamente con el nombre de tu archivo. Una pequeña discrepancia provoca un No se encontró ningún catálogo para la solicitud error.
Discrepancia de formato o delimitador
Confirma que el formato seleccionado (CSV, TXT, XML, GMC) coincida con tu archivo. Si usas un archivo delimitado, confirma que el delimitador (coma, tabulación, barra vertical) coincida con lo configurado.
Corrige el formato o el delimitador en la configuración de tu catálogo. Una discrepancia provoca No se encontraron registros válidos errores.
FTP/SFTP: credenciales o ruta no válidas
Verifica que tu URL use el formato sftp://{username}:{password}@{host}/{file_path}. La ruta debe apuntar al archivo exacto, no solo a un directorio. Los caracteres especiales de las credenciales deben codificarse en URL (por ejemplo, @ se convierte en %40).
Prueba tus credenciales con un cliente FTP como FileZilla. Actualiza la URL con las credenciales corregidas y la ruta completa del archivo.
La obtención caduca o no logra conectarse
El firewall de tu servidor podría estar bloqueando las solicitudes de impact.com.
Contacta a tu proveedor de alojamiento o al equipo de TI para incluir en la lista de permitidos los rangos de direcciones IP de impact.com.
La URL requiere autenticación
Este método de carga no admite autenticación basada en sesión ni en cookies.
Usa una URL de descarga directa de acceso público, con autenticación básica HTTP incrustada en la URL (https://user:pass@host/path), o FTP/SFTP con credenciales en la URL. Si tu feed requiere inicio de sesión en el navegador, cambia tu catálogo a otro método de carga, como Carga directa o Servidor FTP de impact.com.
La URL supera los 2.048 caracteres
Las URL firmadas de almacenamiento en la nube pueden superar el límite de 2.048 caracteres y truncarse.
Usa un acortador de URL que preserve la descarga directa o aloja el archivo en una URL más corta.
Catálogo atascado en Procesando o Pendiente
Comprueba si el archivo sigue siendo accesible en la URL y si el tamaño del archivo es inusualmente grande para tu frecuencia de obtención.
Verifica que el archivo esté disponible. Si el catálogo sigue en Procesando o Pendiente, contacta con soporte para solicitar un reprocesamiento manual.
El catálogo dejó de actualizarse automáticamente
Comprueba si el archivo sigue disponible en la misma URL y si el nombre del archivo, el formato o la configuración de acceso al servidor han cambiado.
Restaura el archivo en la URL original o actualiza la configuración de tu catálogo para reflejar la nueva URL o el nuevo nombre de archivo. Para catálogos grandes (más de 1.000.000 de elementos), considera reducir la frecuencia de obtención para evitar caducidades.
Faltan campos o datos después de la carga
Confirma que los nombres de tus campos coincidan con la especificación del formato seleccionado, por ejemplo campos de Google Merchant Center para el formato GMC. Asigna los campos personalizados fuera de la especificación estándar a los espacios de campos personalizados de impact.com (Numeric1, Text1, y así sucesivamente).
Descarga tu catálogo cargado desde impact.com y compáralo con tu archivo de origen para encontrar dónde se están perdiendo los datos. Actualiza los nombres de los campos o los mapeos según sea necesario y, luego, vuelve a cargarlo.
Importación integrada de carrito de compras
Este método extrae tu catálogo desde una plataforma de comercio electrónico existente. La mayoría de los problemas de conexión se deben a credenciales incorrectas o a permisos de lectura faltantes. Selecciona tu plataforma a continuación.
Si ves un error como Código de estado HTTP no exitoso al conectar con Shopify: 401 o No se encontraron registros válidos en el archivo del catálogo, normalmente la causa son tus datos de autenticación o permisos.
Tu contraseña debe ser el token de acceso de la API de administración, que comienza con
shpat_(oshap_). Lo encontrarás en tu panel de Shopify en Aplicaciones → Credenciales de API → token de acceso de la API de administración.Si no ves la token de acceso de la API de administraciónselecciona Instalar aplicación en Shopify para generarlo.
Confirma el
read_productspermiso (ámbito) esté concedido a la aplicación. Sin él, Shopify devuelve un error que indica que la acción requiere la aprobación del comerciante para elread_productsámbito.Para las colecciones, encuentra el ID de la colección en tu Shopify Admin en Productos → Colecciones. Selecciona la colección; su ID aparece al final de la URL de la página.
Para ver los pasos completos de configuración, consulta la guía de integración del catálogo de productos de Shopify.
Si ves La conexión con WooCommerce no se realizó correctamente. Inténtalo de nuevo, comprueba tus credenciales y la configuración de la API.
Tu nombre de usuario de la API es tu WooCommerce clave del consumidor, y tu contraseña de la API es tu secreto del consumidor.
Activa la API REST heredada en WooCommerce: WooCommerce → Configuración → Avanzado → API heredada, y luego marca la casilla para activarla.
Como referencia, consulta la documentación de la API REST de WooCommerce.
Conectar BigCommerce requiere dos valores y los permisos de solo lectura correctos.
Introduce tu hash de la tienda y token de acceso en la interfaz de impact.com. Tu hash de tienda es el identificador en la ruta de API de tu tienda.
Establece los Productos y permisos de Información y configuración como solo lectura cuando crees la cuenta de API en BigCommerce.
Como referencia, consulta la guía de BigCommerce para crear tokens de API.
Tu aplicación privada de Shoplazza necesita acceso de lectura a los siguientes recursos: producto, colección, y tienda.
Para los pasos de configuración, consulta la guía de Shoplazza para crear aplicaciones privadas.
Soluciona errores y advertencias después de la carga
Una vez que se recibe un archivo, impact.com valida cada registro. Los errores impiden que los registros se procesen, mientras que las advertencias señalan datos que fueron aceptados pero que pueden causar problemas. Usa las secciones siguientes para interpretarlos y resolverlos.
Ver errores y advertencias
En la Estado columna, selecciona el errores, advertencias, o duplicados enlace.
Se te redirigirá a una página con más detalles. Solo el primer elemento de un conjunto de duplicados se representa en impact.com; todos los elementos que dupliquen al primero se ignoran.
Opcionalmente, usa el campo de búsqueda y los filtros en la parte superior de la página para revisar los problemas.
Revisa los problemas y realiza los cambios necesarios, luego vuelve a cargar tu catálogo de productos.
Descripciones de filtros
Tipo de error
Filtra específicamente por Errores, Advertencias, Duplicados, o Todos los problemas.
Obligatorio
Filtra cualquier campo específico obligatorio que falte en el catálogo de productos, o Todos campos.
Sugerido
Filtra cualquier campo específico recomendado que falte en el catálogo de productos, o Todos campos.
Inválido
Filtra cualquier error específico basado en validación, como un SKU duplicado, un código de categoría de Google no válido u otros errores.
Mensajes comunes de error y advertencia
Registro 'X': faltan campos obligatorios: (nombre del campo)
La línea especificada carece de uno o más campos obligatorios.
Registro 'X': CatalogItemId(CatalogItemId): faltan campos obligatorios: (nombre del campo)
Una línea del archivo de datos carece de un campo obligatorio.
No se encontró ningún catálogo para la solicitud. Comprueba si el nombre del archivo cargado es el mismo que el registrado con el catálogo
El Nombre de archivo de carga establecido en la Método de carga sección al crear el catálogo no coincide exactamente con el nombre del archivo que cargaste.
No hay atributos presentes en el archivo del catálogo
El archivo de datos del catálogo de productos no tiene datos procesables.
El elemento del catálogo con ese ID aparece más de una vez en el catálogo, y los posteriores al primero se ignorarán
Dos o más elementos tienen el mismo ID. Todos los productos requieren un valor único y los elementos duplicados no se procesan.
El registro 'X' tiene un error: (línea X) carácter no válido entre el token encapsulado y el delimitador
Una línea contiene un uso no válido de comillas dobles. Encierra el campo entre comillas dobles y reemplaza todas las demás comillas dobles por dos comillas dobles.
(Línea de inicio X) se alcanzó el EOF antes de que terminara el token encapsulado
EOF significa "fin de archivo". La línea de inicio mencionada tiene una comilla doble de apertura sin una comilla doble de cierre, o un salto de línea inesperado interrumpió el flujo de datos.
Error al analizar el campo (tipo de catálogo): con el valor: (campo)
El campo de producto no es válido y no puede aceptarse.
El registro (recordNumber) tiene un error: el número de valores delimitados (FieldsLength) no coincide con el esperado (ColumnNamesLength)
Para una fila determinada, existen datos en una columna que no tiene encabezado.
No se encontraron registros válidos en el archivo del catálogo
El archivo de datos está vacío, los datos detectados no son válidos o el nombre de archivo especificado es incorrecto.
Más del 10 % de los registros del archivo tenían errores
El archivo de datos no se puede procesar si esto ocurre. Consulta Comprender el umbral de error del 10 % a continuación.
El procesamiento falló debido a un error interno del sistema...
No se requiere ninguna acción por tu parte. El último catálogo que se procesó correctamente sigue estando disponible para los socios de medios. Consulta la página de estado de impact.com para obtener detalles sobre interrupciones del servicio.
El campo (nombre del campo) con el valor (valor del campo) no tiene un protocolo válido
El valor del campo no es una URL con formato correcto.
Advertencias de formato y delimitador
Problemas de delimitador: una coma, tabulación o línea vacía incorrecta rompe el límite entre campos.
Corrige el uso del delimitador en el archivo del catálogo para que cada campo quede separado de forma coherente y, luego, vuelve a cargarlo.
Los saltos de línea en un campo de descripción interrumpen el procesamiento del registro.
Los saltos de línea no son compatibles con los formatos de texto delimitado (CSV y TSV). Elimina los saltos de línea de campos de texto como las descripciones antes de cargarlo.
Errores del formato de Google Merchant Center
Si usas el formato de Google Merchant Center (GMC), la mayoría de los problemas surgen en torno a la sección de categoría , los valores de campo predefinidos o la estructura XML.
Cuando seleccionas errores en la Catálogos de productos pantalla, puedes ver Falta la categoría de producto de Google en la columna de sugerencias columna. Esto significa que no se incluyó ningún código de categoría de Google ni ninguna cadena completa de categoría de Google en tu catálogo.
Para resolverlo, consulta tu cuenta de Google Merchant Center. Google sugiere automáticamente categorías para los elementos; usa estas sugerencias al cargar el catálogo corregido.
Cuando seleccionas errores en la Catálogos de productos pantalla, puedes ver Desajuste de la categoría de producto de Google en la Inválido columna. Esto significa que la categoría usada para los elementos de tu catálogo no coincide con la código de taxonomía (por ejemplo, 7386) o con el formato completo de categoría que proporciona Google, por ejemplo:
Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes
Para resolverlo, corrige el formato en que se enumeran las categorías de producto de Google y, luego, vuelve a cargar tu catálogo.
Un error como No se pudo analizar el campo: availability con el valor significa que un campo predefinido está usando un valor que GMC no reconoce. Para los catálogos GMC, las categorías y los valores deben ser exactos.
Usa
availabilitypara el campo de disponibilidad.Los valores de disponibilidad admitidos son
in_stock,out_of_stock,preorder, ybackorder.Comprueba si hay símbolos especiales que puedan afectar al formato, como un símbolo de moneda que aparezca en un campo de valor.
Si sube un catálogo de Google Merchant Center (formato XML) y ve No se encontraron registros válidos en el archivo del catálogo. Corrija el archivo y vuelva a cargarlo, es probable que la estructura XML sea incorrecta.
El archivo XML debe contener rss, RDF, o feed en su elemento inicial. Corrija el elemento raíz y vuelva a cargarlo.
Formato de eBay Commerce Merchant Center: En un .csv archivo, reemplace los espacios en los valores de la columna de campos (categorías) con guiones bajos. Por ejemplo, use Item_Title en lugar de Item Title.
Comprender el umbral de error del 10 %
Si más del 10 % de los registros de un archivo cargado contienen errores, el archivo no se procesa. Cuando esto sucede:
Su catálogo sigue mostrando la versión de la última carga correcta, por lo que se espera una marca de tiempo más antigua de último envío correcto .
El Ver productos la opción solo aparece si anteriormente se cargó correctamente un archivo para ese ID de catálogo.
Corrija los registros marcados para que menos del 10 % contengan errores y luego vuelva a cargarlo.
Haga que su catálogo esté disponible para los socios
Un catálogo en buen estado aún no llegará a sus socios hasta que lo haga disponible y cumpla los requisitos de visibilidad para socios. Use esta sección si su catálogo se procesó correctamente, pero los socios están teniendo problemas de visibilidad, acceso al producto o enlaces de seguimiento.
Los socios no pueden ver el catálogo
Compruebe las dos configuraciones siguientes:
Asegúrese de que el catálogo esté disponible para su uso:
Seleccione
[Engage] → Contenido → Productos → Catálogos de productos y busque el catálogo.Seleccione
[Más] y luego elija Hacer disponible para uso.
Compruebe si el acceso de los socios está restringido:
Seleccione
[Engage] → Contenido → Productos → Catálogos de productos y busque el catálogo.Pase el cursor sobre el catálogo y luego seleccione Editar.
En la Restringir acceso de socios sección, compruebe si Permitir acceso solo a socios específicos está
activado.Si lo está,
desactívelo y seleccione Guardar.
Los socios no pueden ver ni buscar productos específicos
Para que un producto sea visible en la interfaz de usuario del socio, debe cumplir todos los siguientes requisitos:
El precio original es superior a 2,00 USD.
La disponibilidad de stock del producto no es Sin existencias.
El producto tiene una URL de producto válida que lleva a una página activa de detalles del producto.
El producto tiene una URL de imagen.
El producto está en un catálogo sin reglas aplicadas.
Los enlaces de seguimiento de los socios devuelven un error de "malformado"
Si los socios ven "El enlace en el que hizo clic está mal formado" al usar enlaces de seguimiento de sus productos, normalmente no está habilitado el enlace profundo, o el dominio de la página de destino del producto no está configurado como dominio permitido. Para habilitar el enlace profundo, configure sus dominios permitidos y resuelva este error; consulte Configurar dominios permitidos para el enlace profundo.
Última actualización
¿Te fue útil?