> 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).

# 排查商品目录错误和警告

每个产品目录都有一个健康评分，用于指示目录中存在哪些问题（如果有）。要让您的目录进入 *优秀* 范围，您必须排查并纠正其中存在的任何错误、警告和重复项。

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FZTsEfqMM8xnWruw90lbm%2Feng-350-5.mp4?alt=media&token=80c0e779-2118-482b-9a88-10ff3da3f8a4>" %}

1. 从左侧导航菜单中，选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[Engage]** → **内容** → **产品** → [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. 如果某个目录存在错误、警告或重复的行项目，你将在 *健康* 列。

   <div data-with-frame="true"><figure><img src="/files/8855092c100d76565e3a29df8f6e2ef9bd983c2a" alt="" width="563"><figcaption></figcaption></figure></div>

   * 会自动获取目录的上传方法应在下一次获取事件发生时自动更新。

<details>

<summary>健康说明</summary>

| 健康指标    | 描述                                             |
| ------- | ---------------------------------------------- |
| **待处理** | 您的产品目录正在上传。                                    |
| **处理中** | 您的产品目录正在处理中。                                   |
| **优秀**  | 表示目录健康——该产品数据集完整且结构良好，因此最有可能有效运行。              |
| **良好**  | 表示某些包含关键数据（如类别或状态）的建议字段可能缺失。解决这些缺口将提升您目录的整体质量。 |
| **较差**  | 表示您发送的记录中有超过 10% 缺少必填信息。此目录必须修复后重新上传。          |

</details>

#### 查看错误和警告

1. 在 *健康* 列，请选择 **错误**, **警告**，或 **重复项** 链接。
   * 您将被重定向到一个页面，其中包含有关错误或警告的更多详细信息。在 impact.com 中，重复项组中只会显示第一项；所有与第一项重复的条目都会被忽略。
2. 你也可以选择使用 *搜索* 字段和页面顶部的筛选器，以便对问题进行排序和查看。

<details>

<summary>筛选说明</summary>

|          |                                                        |
| -------- | ------------------------------------------------------ |
| **错误类型** | 您可以专门筛选 *错误*, *警告*, *重复项*，或 *全部* 问题。                   |
| **必填**   | 您可以筛选任何特定的缺失必填产品目录字段或 *全部* 字段。                         |
| **建议**   | 您可以筛选任何特定的缺失推荐产品目录字段或 *全部* 字段。                         |
| **无效**   | 您可以筛选任何特定的基于验证的错误。这些错误可以是重复的 SKU、无效的 Google 类别代码或其他错误。 |

</details>

3. 查看问题并按需进行修改。然后，重新上传您的产品目录。

<details>

<summary>常见错误和警告消息</summary>

| 错误消息                                                                                                           | 说明                                                                                                  |
| -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| *记录“X”：缺少必填字段：(字段名称)*                                                                                          | 指定行缺少一个或多个必填字段。                                                                                     |
| *记录“X”：CatalogItemId(CatalogItemId)：缺少必填字段：(字段名称)*                                                             | 数据文件中的某一行缺少必填字段。                                                                                    |
| *未找到该请求对应的目录。请检查上传文件的文件名是否与目录中注册的文件名相同*                                                                        | 该 *上传文件名* 在 *上传方式* 创建产品目录时该部分中设置的名称与您上传的文件名不完全匹配。                                                   |
| *目录文件中没有属性*                                                                                                    | 产品目录数据文件没有任何可处理的数据。                                                                                 |
| *目录中某个 ID 的项目出现了不止一次，第一条之后的记录将被忽略*                                                                             | 有 2 个或更多项目具有相同的 ID——所有产品都需要唯一值。重复项目将不会被处理。                                                          |
| *记录“X”存在错误：(第 X 行) 封装字段与分隔符之间存在无效字符*                                                                           | 数据文件中的某一行包含不正确的双引号用法。应将字段用双引号括起来，并将所有其他双引号替换为 2 个双引号（例如， *3" floppy* 变为 *"3"" floppy"*).            |
| *（起始行 X）在封装字段完成之前已到达 EOF*                                                                                      | <p>EOF 表示“文件末尾”。所提到的起始行带有一个开头双引号，但没有结尾双引号。即使读取到文件末尾，也未找到结尾双引号，因此发生了此错误。</p><p>或者，意外的换行可能中断了数据流。</p> |
| *解析 (catalog type) 字段时出错：值为：(field)*                                                                           | 产品字段无效，无法接受。                                                                                        |
| *记录 (recordNumber) 出现错误：分隔值数量 (FieldsLength) 与预期值 (ColumnNamesLength) 不匹配*                                     | 对于某一给定的数据行，如果某列存在数据但没有标题，就会发生此错误。                                                                   |
| *在目录文件中未找到有效记录*                                                                                                | 要么数据文件为空（即没有数据），要么检测到的数据无效，或者指定的文件名不正确。                                                             |
| *文件中超过 10% 的记录存在错误。*                                                                                           | 如果出现此错误，则无法处理该数据文件。                                                                                 |
| *处理失败，原因是内部系统错误。用户无需采取任何操作。我们的工程团队已收到通知，正在着手解决该问题。最后一个成功处理的目录将继续对 Media Partners 可用。如需更多信息，请联系 impact.com 支持。* | 请参见 [impact.com 状态页面](https://status.impact.com/) 以查看服务中断的详细信息。                                     |
| *值为（字段值）的字段（字段名称）没有有效的协议*                                                                                      | 字段值不是格式正确的 URL。                                                                                     |

</details>

#### Google Merchant 格式错误

如果您使用 Google Merchant Center 格式作为产品目录分类体系，可能会遇到 2 个问题，而这些问题很可能出现在该格式的 `类别` 部分。

{% tabs %}
{% tab title="缺少 Google 产品类别" %}
当您选择 *错误* 在 *产品目录* 屏幕时，您可能会看到 *缺少 Google 产品类别* 在 *建议* 列。

这意味着您的目录中未包含 Google 类别代码或完整的 Google 类别字符串。

要解决此问题，请参考您的 Google Merchant Center 帐户。Google 会自动为商品建议类别——在上传更正后的目录时应使用该建议。

<div data-with-frame="true"><figure><img src="/files/a4fcbb83ed86088df351fae86d5cf06c7498d71a" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Google 产品类别不匹配" %}
当您选择 *错误* 在 *产品目录* 屏幕时，您可能会看到 *Google 产品类别不匹配* 在 *无效* 列。

这意味着您目录中商品使用的类别与预期的 [分类代码](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) （例如 7386）或 Google 提供的完整类别格式不匹配。请参见下面的完整 Google 类别格式示例。

`动物与宠物用品 > 宠物用品 > 鸟类用品 > 鸟笼配件 > 鸟笼食水碗`

要解决此问题，请更正目录中列出 Google 产品类别的格式，然后重新上传目录。

<div data-with-frame="true"><figure><img src="/files/2000eec488450ef0d0f6f385bf96dcc2d709402c" alt=""><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}

#### 排查 *从 URL 拉取* 问题

如果您的目录配置为从 URL 拉取，但未能正确加载、更新或处理，请使用下表来识别并解决问题。

<table><thead><tr><th width="230.53125">问题</th><th width="258">检查内容</th><th>如何修复</th></tr></thead><tbody><tr><td><em>URL 不是直接下载链接</em></td><td>在浏览器中打开您的 URL。如果它重定向到登录页面、云存储落地页，或返回 404/403 错误，则该 URL 不是直接下载链接。</td><td>将 URL 更新为打开后可直接下载文件，或在浏览器中显示原始数据的链接。</td></tr><tr><td><em>文件名不匹配</em></td><td>该 <em>上传文件名</em> 在您的目录设置中，文件名必须与 URL 处的实际文件名完全一致，包括扩展名（<code>.csv</code>, <code>.xml</code>, <code>.txt</code>, <code>.gz</code>).</td><td>更新 <em>上传文件名</em> 您目录设置中的名称，使其与文件名完全一致——哪怕是细微不匹配也会导致 <em>未找到与该请求对应的目录</em> 错误。</td></tr><tr><td><em>格式或分隔符不匹配</em></td><td>确认所选格式（CSV、TXT、XML、GMC）与您的文件一致。如果使用分隔文件，请确认分隔符（逗号、制表符、竖线）与配置相符。</td><td>请在目录设置中更正格式或分隔符。不匹配会导致 <em>未找到有效记录</em> 错误。</td></tr><tr><td><em>FTP/SFTP：凭据或路径无效</em></td><td>请验证您的 URL 是否使用以下格式： <code>sftp://{username}:{password}@{host}/{file_path}</code>。路径必须指向确切文件，而不仅仅是目录。凭据中的特殊字符必须进行 URL 编码（例如， <code>@</code> → <code>%40</code>).</td><td>请使用 FileZilla 等 FTP 客户端测试您的凭据。使用更正后的凭据和完整文件路径更新 URL。</td></tr><tr><td><em>拉取超时或连接失败</em></td><td>您服务器的防火墙可能正在阻止 impact.com 的请求。</td><td>请联系您的托管服务提供商或 IT 团队，将 impact.com 的 IP 地址范围加入允许列表。</td></tr><tr><td><em>URL 需要身份验证</em></td><td>从 URL 拉取不支持基于会话或基于 Cookie 的身份验证。</td><td>请改用以下之一：可公开访问的直接下载 URL、在 URL 中嵌入的 HTTP Basic Auth（<code>https://user:pass@host/path</code>），或在 URL 中包含凭据的 FTP/SFTP。如果您的数据源需要基于浏览器的登录，请切换到 <em>直接上传</em> 或 <em>FTP Push</em>.</td></tr><tr><td><em>URL 超过 2,048 个字符</em></td><td>带签名的云存储 URL 可能会超过 2,048 个字符的限制，并且可能会被截断。</td><td>使用能保留直接下载的短链接服务，或将文件托管在更短的 URL 上。</td></tr><tr><td><em>目录卡在处理中或待处理状态</em></td><td>检查文件是否仍可通过该 URL 访问，以及文件大小对于您的拉取频率而言是否异常大。</td><td>确认文件可用。如果目录仍处于 <em>处理中</em> 或 <em>待处理</em>, <a href="https://app.impact.com/support/portal.ihtml?createTicket=true">联系支持团队</a> 状态，请申请手动重新处理。</td></tr><tr><td><em>目录停止自动更新</em></td><td>检查文件是否仍可通过同一 URL 访问，以及文件名、格式或服务器访问设置是否已更改。</td><td>在原始 URL 恢复该文件，或更新您的目录设置以反映新的 URL 或文件名。对于大型目录（100 万+ 项），请考虑降低拉取频率以避免超时。</td></tr><tr><td><em>上传后字段或数据缺失</em></td><td>确认您的字段名称符合所选格式的规范——例如， <a href="https://support.google.com/merchants/answer/7052112">Google Merchant Center 字段</a> 用于 GMC 格式。将标准规范之外的自定义字段映射到 impact.com 的自定义字段槽位（<code>Numeric1</code>, <code>文本1</code>等）。</td><td>从 impact.com 下载您上传的目录，并将其与源文件进行比较，以找出数据丢失的位置。按需更新字段名称或映射，然后重新上传。</td></tr></tbody></table>


---

# 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/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md?ask=<question>&goal=<endgoal>
```

`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.