> 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/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).
# 排查产品目录错误和警告
每个产品目录都有一个健康评分，用于显示目录中的任何问题。请使用本指南在 impact.com 处理你的目录后解决其生成的错误和警告，并修复合作伙伴可见性问题，从而让你的目录保持在 *优秀* 范围内。
如果 impact.com 无法接收你的目录文件，请参见 [排查产品目录上传和连接问题](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/pai-cha-chan-pin-mu-lu-shang-chuan-he-lian-jie-wen-ti.md).
{% hint style="info" %}
**提示：** 健康的目录不仅仅是清除错误。请遵循 [产品目录最佳实践](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) ，以保持数据完整、结构良好，并为良好的可见性和性能做好设置。
{% endhint %}
{% embed url="" %}
## 目录健康评分
1. 在左侧导航菜单中，选择  **\[Engage]** **→** **内容** **→** **产品** **→** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. 如果某个目录存在任何错误、警告或重复行项目， *健康* 列会显示各项的数量。
* 自动上传方式会在下一次计划抓取时更新你的目录。
每个目录都会在 *健康* 列中显示以下健康指示之一：
* *待处理*：你的产品目录正在等待首次上传或数据抓取。
* *处理中*：你的产品目录正在处理中。
* *优秀*：表示目录健康。此产品数据集完整且结构良好，因此最有可能高效运行。
* *良好*：表示某些包含关键信息的建议字段（如类别或描述）可能缺失。填补这些空缺可提升目录的整体质量。
* *较差*：表示你提供的记录中有超过 10% 缺少必需信息。此目录必须修复并重新上传。
## 上传后排查错误和警告
文件接收后，impact.com 会验证每条记录。错误会阻止记录被处理，而警告会标记已接受但可能引发问题的数据。请使用下方各部分来解读并解决它们。
### 查看错误和警告
1. 在 *健康* 列中，选择 **错误**, **警告**，或 **重复项** 链接。
* 你将被重定向到一个包含更多详细信息的页面。对于重复项集合，impact.com 只会显示第一条；所有与第一条重复的项目都会被忽略。
2. 可选地，使用 *搜索* 字段以及页面顶部的筛选器来筛选这些问题。
3. 检查这些问题并按要求进行修改，然后重新上传你的产品目录。
在详情页面上使用以下筛选器来缩小问题范围：
* *错误类型*：专门筛选 *错误*, *警告*, *重复项*，或 *所有* 问题。
* *必填*：筛选任何特定缺失的必填产品目录字段，或 *所有* 字段。
* *建议*：筛选任何特定缺失的推荐产品目录字段，或 *所有* 字段。
* *无效*：筛选任何基于验证的特定错误，例如重复的 SKU、无效的 Google 类别代码或其他错误。
### 常见错误和警告消息
在 *上传状态* 列中，或在你从 *健康* 列打开的详情页面上，找到目录显示的消息。使用说明来解决它。
| 消息 | 说明 |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *记录 'X'：缺少必填字段：（字段名称）* | 指定的行缺少一个或多个必填字段。 |
| *记录 'X'：CatalogItemId(CatalogItemId)：缺少必填字段：（字段名称）* | 数据文件中的某一行缺少必填字段。 |
| *未找到该请求对应的目录。请检查上传文件的文件名是否与目录中注册的名称相同* | 该 *上传文件名* 在 *上传方式* 部分设置的名称与您上传的文件名并不完全匹配。 |
| *目录文件中没有任何属性* | 产品目录数据文件不包含任何可处理的数据。 |
| *目录中同一 ID 的目录项出现了不止一次，第一条之后的项目将被忽略* | 有两个或更多项目具有相同的 ID。所有产品都需要唯一值，重复项目不会被处理。 |
| *记录 'X' 出错：（第 X 行）封装标记与分隔符之间存在无效字符* | 某一行对双引号的使用无效。请用双引号将字段括起来，并将所有其他双引号替换为两个双引号。 |
| *（起始行 X）在封装标记完成之前已到达文件末尾* | EOF 表示“文件末尾”。所提到的起始行包含一个开头双引号，但没有结束双引号，或者意外的换行中断了数据流。 |
| *解析（目录类型）字段时出错：值为：（字段）* | 产品字段无效，无法被接受。 |
| *记录（recordNumber）出错：分隔值的数量（FieldsLength）与预期值（ColumnNamesLength）不匹配* | 对于给定行，某一列中存在数据，但该列没有标题。 |
| *在目录文件中未找到有效记录。请检查文件内容是否与您配置的目录格式一致，然后重新上传。* | impact.com 已读取该文件，但其中不包含任何产品记录。请检查该文件是否包含你的产品并与所选目录格式匹配，然后重新上传。 |
| *文件中超过 10% 的记录存在错误，因此目录未更新。请检查并更正这些记录，然后重新上传文件。* | 目录中存在错误的记录过多，导致无法更新。这也包括每条记录都有错误的文件。请参见 [*了解 10% 错误阈值*](#understand-the-10-error-threshold) 下文。 |
| *目录文件不是有效的 XML，无法读取。请确保文件是格式正确的 XML，然后重新上传。* | XML 文件为空、被截断或包含未闭合的标签，因此 impact.com 无法读取它。请修复 XML 使其格式正确，然后重新上传。 |
| *该文件似乎不是有效的 RSS 或 Atom feed 格式。请检查文件是否与您配置的目录格式一致，然后重新上传。* | 该文件不是 RSS 或 Atom feed，例如当错误网页被保存并替代了你的 feed 时。XML 目录文件必须在其起始元素中包含 `rss`, `RDF`，或 `feed` 。 |
| *我们无法读取你的目录文件内容……* | impact.com 无法读取文件内容。常见原因包括空文件、意外的文件结构、无效分隔符或不正确的字符编码。请检查文件是否与所选目录格式匹配，然后重新上传。如果问题仍然存在， [联系支持团队](https://app.impact.com/support/portal.ihtml). |
| *我们无法从已配置的拉取 URL 获取目录文件。请验证该 URL 以及文件是否可访问。* | impact.com 无法从你的 *拉取 URL* 下载文件。请参见 [*从 URL 拉取*](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/pai-cha-chan-pin-mu-lu-shang-chuan-he-lian-jie-wen-ti.md#pull-from-url-recommended) 中的《排查产品目录上传和连接问题》以排查该 URL。 |
| *由于内部系统错误，处理失败……* | 你无需采取任何操作。最近一次成功处理的目录仍会继续向合作伙伴提供。有关服务中断的详情，请参阅 [impact.com 状态页面](https://status.impact.com/) 。 |
| *字段（字段名）带有值（字段值），但没有有效的协议* | 该字段值不是格式正确的 URL。 |
### 格式和分隔符警告
在分隔文件（CSV 和 TSV）中，放错位置的分隔符或换行符可能会把数据切分到错误的位置，并阻止记录正确处理。请使用下表来解决这些警告。
| 问题 | 如何修复 |
| ----------------------------- | ----------------------------------------- |
| 分隔符问题：错误的逗号、制表符或空行会破坏字段之间的边界。 | 更正目录文件中的分隔符用法，使每个字段都被一致地分隔，然后重新上传。 |
| 描述字段中的换行会中断记录处理。 | 分隔文本格式（CSV 和 TSV）不支持换行。上传前请删除描述等文本字段中的换行。 |
{% hint style="info" %}
**eBay Commerce Merchant Center 格式：** 在 `.csv` 文件中，请将字段列值（类别）中的空格替换为下划线。例如，使用 `Item_Title` 而不是 `Item Title`.
{% endhint %}
### Google Merchant Center 格式错误
如果你使用 Google Merchant Center（GMC）格式，大多数问题都出在该格式的 `类别` 部分、预定义字段值或 XML 结构上。
#### 缺少 Google 商品类别
当你在 *错误* 上选择 *产品目录* 屏幕时，你可能会在 *缺少 Google 商品类别* 中看到 *建议* 列。这意味着你的目录中没有包含 Google 类别代码或完整的 Google 类别字符串。
为了解决此问题，请参阅你的 [Google Merchant Center 账户](https://merchants.google.com/)。Google 会自动为商品建议类别；上传更正后的目录时，请使用这些建议。
#### Google 商品类别不匹配
当你在 *错误* 上选择 *产品目录* 屏幕时，你可能会在 *Google 商品类别不匹配* 中看到 *无效* 列。这意味着你目录中商品使用的类别与预期的 [分类法代码](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) （例如 7386）或 Google 提供的完整类别格式不匹配，例如：
`Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes`
为了解决此问题，请更正 Google 商品类别的列出格式，然后重新上传你的目录。
#### 可用性值未被接受
类似以下的错误 *无法解析字段：availability，其值为* 表示某个预定义字段使用了 GMC 无法识别的值。对于 GMC 目录，类别和值必须准确无误。
* 请使用 `availability` 作为可用性字段。
* 支持的可用性值有 `in_stock`, `out_of_stock`, `preorder`，和 `backorder`.
* 检查可能影响格式的特殊符号，例如值字段中出现的货币符号。
#### XML 结构错误
如果你上传的是 Google Merchant Center（XML 格式）目录，并看到 *该文件似乎不是有效的 RSS 或 Atom feed 格式*，则 XML 结构很可能不正确。
XML 文件的起始元素中必须包含 `rss`, `RDF`，或 `feed` 。请更正根元素并重新上传。
如果你看到 *目录文件不是有效的 XML，无法读取*，则文件为空、被截断或包含未闭合的标签。请修复 XML 使其格式正确，然后重新上传。
### 了解 10% 错误阈值
如果上传文件中超过 10% 的记录包含错误，则该文件不会被处理。发生这种情况时：
* 你的目录仍会显示上一次成功上传的版本，因此会显示较早的 *最近一次成功提交* 时间戳。
* 该 **查看产品** 选项仅在此前已成功为该目录 ID 上传文件时才会显示。
修复被标记的记录，使包含错误的比例低于 10%，然后重新上传。
## 排查合作伙伴可见性和跟踪链接问题
即使目录健康，一个健康的目录也不会触达你的合作伙伴，直到你 [将其设为可用](#partners-cant-see-the-catalog) 并满足 [合作伙伴可见性要求](#partners-cant-see-or-search-specific-products)。如果你的目录已成功处理，但合作伙伴在可见性、产品访问或跟踪链接方面遇到问题，请使用本部分。
### 合作伙伴看不到目录
请检查以下两个设置：
* 确保目录可供使用：
1. 选择  **\[Engage]** **→** **内容** **→** **产品** **→** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) 并找到该目录。
2. 选择  **\[更多]** 然后选择 **设为可用**.
* 检查是否限制了合作伙伴访问：
1. 选择  **\[Engage]** **→** **内容** **→** **产品** **→** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) 并找到该目录。
2. 将鼠标悬停在目录上，然后选择 **编辑**.
3. 在 *限制合作伙伴访问* 部分，检查是否 **仅允许特定合作伙伴访问** 已  开启。
4. 如果是， .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) 将其关闭并选择 **保存**.
{% hint style="success" %}
**注意：** 该 **设为可用** 选项仅适用于具有 *优秀* 或 *良好* 健康状态的目录，且这些目录处于 *非活跃* 或 *待激活*.
{% endhint %}
### 合作伙伴无法查看或搜索特定产品
要使产品在合作伙伴界面中可见，必须满足以下所有要求：
* 原价高于 2.00 美元。
* 该产品的库存可用性不是 *缺货。*
* 该产品具有有效的产品 URL，并指向一个实时的产品详情页。
* 该产品有图片 URL。
* 该产品位于未应用任何 [规则](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) 的目录中。
### 合作伙伴跟踪链接返回“格式错误”错误
如果合作伙伴在使用你产品中的跟踪链接时看到“你点击的链接格式错误”，通常表示未启用深度链接，或者该产品的落地页域名未设置为允许域名。要启用深度链接、设置允许域名并解决此错误，请参见 [设置深度链接允许的域名](/brand/zh/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md).
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/zh/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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
