> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md). # Solucionar errores y advertencias de catálogos de productos Cada catálogo de productos tiene una puntuación de salud que indica qué problemas, si los hay, están presentes en tu catálogo. Para llevar tu catálogo al *excelente* rango, debes solucionar y corregir cualquier error, advertencia y duplicado presente en él. {% embed url="" %} 1. En el menú de navegación izquierdo, seleccione ![](/files/fe7777a565e5a85579aeb006aa379fcc1b594c29) **\[Engage]** → **Contenido** → **Productos** → [**Catálogos de productos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. Si un catálogo tiene errores, advertencias o elementos de línea duplicados, verás cuántos de cada uno hay en el *Estado* columna.
* Los métodos de carga que recuperan automáticamente el catálogo deberían actualizarse automáticamente cuando ocurra el siguiente evento de recuperación.
Descripciones de salud | Indicador de salud | Descripción | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pendiente** | Tu catálogo de productos se está cargando. | | **En proceso** | 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 funcionar eficazmente. | | **Bueno** | Indica que ciertos campos sugeridos que contienen datos cruciales como la categoría o el estado podrían faltar. Abordar estas lagunas mejorará la calidad general de tu catálogo. | | **Malo** | Indica que falta información obligatoria en más del 10 % de los registros que enviaste. Este catálogo tendrá que corregirse y volver a cargarse. |
#### Ver errores y advertencias 1. En el *Estado* columna, selecciona el **errores**, **advertencias**, o **duplicados** enlace. * Se te redirigirá a una página con más detalles sobre los errores o advertencias. Solo el primer elemento de un conjunto de duplicados se representará en impact.com; todos los elementos que dupliquen al primero se ignorarán. 2. Opcionalmente, usa el *Buscar* campo y los filtros en la parte superior de la página para ordenar los problemas.
Descripciones de los filtros | | | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Tipo de error** | Puedes filtrar específicamente por *Errores*, *Advertencias*, *Duplicados*, o *Todos* problemas. | | **Obligatorio** | Puedes filtrar por cualquier campo obligatorio específico faltante del catálogo de productos o *Todos* campos. | | **Sugeridos** | Puedes filtrar por cualquier campo recomendado específico faltante del catálogo de productos o *Todos* campos. | | **Inválido** | Puedes filtrar por cualquier error específico basado en la validación. Puede ser un SKU duplicado, un Código de categoría de Google no válido u otros errores. |
3. Revisa los problemas y realiza los cambios necesarios. Luego, vuelve a cargar tu catálogo de productos.
Mensajes comunes de error y advertencia | Mensaje de error | Explicación | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *Registro 'X': faltan campos obligatorios: (nombre del campo)* | La línea especificada no tiene uno o más campos obligatorios. | | *Registro 'X': CatalogItemId(CatalogItemId): faltan campos obligatorios: (nombre del campo)* | Una línea del archivo de datos no tiene un campo obligatorio. | | *No se encontró ningún catálogo para la solicitud. Compruebe si el nombre del archivo cargado es el mismo que el registrado con el catálogo* | El *Nombre del archivo cargado* establecido en la *Método de carga* sección al crear un catálogo de productos 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 que puedan procesarse. | | *El elemento del catálogo con ID aparece más de una vez en el catálogo, y los posteriores a la primera aparición se ignorarán* | 2 o más elementos tienen el mismo ID: todos los productos requieren un valor único. Los elementos duplicados no se procesarán. | | *El registro 'X' tiene un error: (línea X) carácter no válido entre el token encapsulado y el delimitador* | Una línea del archivo de datos contiene un uso no válido de comillas dobles. Estas deben manejarse correctamente encerrando el campo entre comillas dobles y reemplazando todas las demás comillas dobles por 2 comillas dobles (p. ej., *3" floppy* se convierte en *"3"" floppy"*). | | *(Línea inicial X) se alcanzó EOF antes de que terminara el token encapsulado* |

EOF significa "fin de archivo". La línea inicial mencionada tiene una comilla doble de apertura sin una comilla doble de cierre. Este error se ha producido porque no se encontró una comilla doble de cierre, incluso al leer hasta el final del archivo.

Alternativamente, un salto de línea inesperado podría haber interrumpido el flujo de datos.

| | *Error al analizar el campo (tipo de catálogo): con valor: (campo)* | El campo del 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 de datos determinada, si existen datos en una columna sin encabezado, se producirá este error. | | *No se encontraron registros válidos en el archivo del catálogo* | O bien el archivo de datos está vacío (es decir, no hay datos), 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 puede procesarse si ocurre este error. | | *El procesamiento falló debido a un error interno del sistema. No se requiere ninguna acción por parte del usuario. Nuestro equipo de ingeniería ha sido notificado y está trabajando para resolver el problema. El último catálogo procesado correctamente seguirá estando disponible para los socios de medios. Ponte en contacto con el soporte de impact.com si necesitas más información.* | Consulta la [Página de estado de impact.com](https://status.impact.com/) para obtener detalles sobre las 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 el formato adecuado. |
#### Errores del formato de Google Merchant Hay 2 problemas que podrías encontrar si usas el formato de Google Merchant Center como taxonomía de tu catálogo de productos, y probablemente surgirán en torno al `Categoría` sección. {% tabs %} {% tab title="Falta la categoría de producto de Google" %} Cuando selecciones *errores* en la *Catálogos de productos* pantalla, podrías ver *Falta la categoría de producto de Google* en el *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 resolver este problema, consulta tu cuenta de Google Merchant Center. Google sugiere automáticamente categorías para los elementos; esta sugerencia debe usarse al cargar el catálogo corregido.
{% endtab %} {% tab title="Incompatibilidad de categoría de producto de Google" %} Cuando selecciones *errores* en el *Catálogos de productos* pantalla, podrías ver *Incompatibilidad de categoría de producto de Google* en el *Inválido* columna. Esto significa que la categoría utilizada para los elementos de tu catálogo no coincide con el [código de taxonomía](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (p. ej., 7386) o el formato completo de categoría que proporciona Google. Consulta el siguiente ejemplo de un formato completo de categoría de Google. `Suministros para animales y mascotas > Suministros para mascotas > Suministros para aves > Accesorios para jaulas de aves > Platos de comida y agua para jaulas de aves` Para resolver este problema, corrige el formato en que se enumeran las categorías de producto de Google en tu catálogo y luego vuelve a cargarlo.
{% endtab %} {% endtabs %} #### Solucionar problemas *Obtener desde URL* problemas Si tu catálogo está configurado para extraerse desde una URL y no se está cargando, actualizando o procesando correctamente, usa la tabla siguiente para identificar y resolver el problema.
ProblemaQué comprobarCómo solucionarlo
La URL no es un enlace de descarga directaAbre tu URL en un navegador. Si redirige a una página de inicio de sesión, a una página de aterrizaje de almacenamiento en la nube o devuelve un error 404/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 abrirse en un navegador.
Incompatibilidad del nombre de archivoEl Nombre del archivo cargado 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 del archivo cargado en la configuración de tu catálogo 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.
Incompatibilidad de formato o delimitadorConfirma 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 incompatibilidad provoca No se encontraron registros válidos errores.
FTP/SFTP: credenciales o ruta no válidasVerifica 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 en las credenciales deben codificarse en URL (p. ej., @ → %40).Prueba tus credenciales con un cliente FTP como FileZilla. Actualiza la URL con las credenciales corregidas y la ruta completa del archivo.
La extracción agota el tiempo de espera o no logra conectarseEl 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 permitir los rangos de direcciones IP de impact.com.
La URL requiere autenticaciónExtraer desde URL no admite autenticación basada en sesiones ni en cookies.Usa una de las siguientes opciones en su lugar: una URL de descarga directa accesible públicamente, autenticación básica HTTP integrada en la URL (https://user:pass@host/path), o FTP/SFTP con credenciales en la URL. Si tu feed requiere inicio de sesión basado en navegador, cambia a Carga directa o FTP Push.
La URL supera los 2.048 caracteresLas URL firmadas de almacenamiento en la nube pueden superar el límite de 2.048 caracteres y podrían truncarse.Usa un acortador de URL que conserve la descarga directa o aloja el archivo en una URL más corta.
Catálogo bloqueado en Procesando o PendienteComprueba si el archivo sigue siendo accesible en la URL y si el tamaño del archivo es inusualmente grande para tu frecuencia de extracción.Verifica que el archivo esté disponible. Si el catálogo permanece en En proceso o Pendiente, contacte con soporte para solicitar un reprocesamiento manual.
El catálogo dejó de actualizarse automáticamenteComprueba 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 M de elementos), considera reducir la frecuencia de extracción para evitar tiempos de espera.
Faltan campos o datos después de la cargaConfirma 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, Texto1, etc.).Descarga tu catálogo cargado desde impact.com y compáralo con tu archivo de origen para identificar dónde se están perdiendo datos. Actualiza los nombres de los campos o las asignaciones según sea necesario y luego vuelve a cargarlo.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.