> 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). # 排查商品目录错误和警告 每个产品目录都有一个健康评分，用于指示你的目录中存在哪些问题（如果有）。问题可能出现在任何阶段：文件上传或连接时、处理后，或当你的合作伙伴尝试查看并推广你的产品时。请使用本指南逐步排查各阶段的问题，并将你的目录提升到 *优秀* 范围。 {% 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. 从左侧导航菜单中选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **内容** **→** **产品** **→** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. 如果目录中存在任何错误、警告或重复行项目， *健康* 列会显示每种问题各有多少。 * 会在下次抓取事件发生时自动获取目录更新的上传方式。
健康说明 | 健康指示器 | 说明 | | ------- | --------------------------------------------- | | **待处理** | 你的产品目录正在等待首次上传或数据抓取。 | | **处理中** | 你的产品目录正在处理中。 | | **优秀** | 表示目录健康。此产品数据集完整且结构良好，因此最有可能有效发挥作用。 | | **良好** | 表示某些包含关键数据的建议字段（如类目或描述）可能缺失。弥补这些缺口可提升目录的整体质量。 | | **较差** | 表示你提供的记录中有超过 10% 缺少必填信息。此目录必须修复后重新上传。 |
## 排查上传和连接问题 在目录可以被处理之前，impact.com 必须成功接收它。以下步骤按你在创建目录时选择的上传方式分组。如果你不确定当前使用的是哪种方式，请选择该目录并查看其 *上传方式* 设置。 ### 直接上传 直接上传问题通常是格式或文件名不匹配，或者文件超过了 1 GB 限制。 | 问题 | 检查内容 | 如何修复 | | -------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------- | | 所选格式错误 | 你选择的格式（例如 TXT）与上传的文件（例如 XML）不匹配。 | 请重新上传并选择与你文件相匹配的格式。XML 文件使用 `.xml` 扩展名，CSV 文件使用 `.csv`，而 TAB 分隔文件使用 `.txt`. | | 文件名不匹配 | 你上传的文件名必须与 *上传文件名* 完全一致，包括扩展名。 | 请重命名你的文件，或更新 *上传文件名* ，使两者完全匹配。 | | 压缩文件无法处理 | impact.com 支持 gzip 和标准 zip 压缩文件。压缩文件可以使用第二个扩展名来表示压缩，例如 `catalog.xml.gz`. | 请确认你的压缩类型是 gzip 或 zip，并且文件对其格式和压缩都使用了正确的扩展名。 | ### impact.com FTP 服务器 大多数 FTP 问题都归结为连接设置或凭据。 | 问题 | 检查内容 | 如何修复 | | --------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | 无法连接到服务器 | 请确认你正在连接的主机是 `products.impact.com` ，端口为 `21`. | 请使用正确的主机和端口更新你的 FTP 客户端，然后重新连接。 | | 缺少 FTP 凭据 | 连接需要为你的帐户发放的 FTP 登录名和密码。 | 找到你的 *FTP 产品数据系统凭据* ，在你帐户的技术配置设置中。如果你找不到或无法访问它们， [联系支持](https://app.impact.com/support/portal.ihtml). | ### impact.com SFTP 服务器 impact.com SFTP 服务器是专用于特定集成的特殊上传方式。 | 问题 | 检查内容 | 如何修复 | | ---------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | 你的馈送平台无法连接 | 请确认你的平台正在连接到主机 `products.impact.com` ，端口为 `22`，且使用的是为你的帐户发放的凭据。 | 请在 FileZilla 或 Cyberduck 等标准 SFTP 客户端中测试相同的凭据。如果客户端可以连接但你的馈送平台仍然无法连接，请使用以下步骤将目录切换为 *从 URL 拉取* 。 | #### 从推送切换为拉取 如果你的馈送平台（例如 Feedonomics）在将文件推送到 impact.com 的 SFTP 服务器时遇到连接错误，你可以改为重新配置 impact.com 直接从你的平台的 SFTP 服务器（例如 SFTPGo）拉取该馈送。这是推荐的解决方案，因为它完全消除了对 impact.com SFTP 的依赖。 在切换之前，请让你的馈送平台（例如 Feedonomics）为你的馈送设置一个外发 SFTP 位置，并提供： * SFTP/FTP 主机和端口（例如 sftpgo.feedonomics.com:22） * 用户名和密码 * 文件路径（例如 incoming/catalog\_feed.txt.gz） {% hint style="warning" %} **警告：** 请更新现有目录，而不是新建一个。使用相同 *上传文件名* 的新目录会返回一个 *文件名已在使用* 错误，而你现有的目录可能已经为其他程序提供数据。 {% endhint %} 1. 从左侧导航菜单中选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **内容** **→** **产品** **→** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. 将鼠标悬停在你现有的目录上，然后选择 **编辑**. 3. 在……中 *上传方式* 部分，选择 **从 URL 拉取**. 4. 选择 **格式** 与你的馈送文件匹配的 5. 输入你的 **上传文件名**，并与文件名完全一致，包括扩展名。 6. 输入你的 **拉取 URL** ，格式为 `sftp://[username]:[password]@[host]:22/[path/to/file]`. * 将凭据中的任何特殊字符进行 URL 编码，例如 `@` 会变为 `%40`. 7. 选择你的 **抓取频率**, **抓取时间**，以及 **时区**. 8. 选择 **保存**. ### 从 URL 拉取 支持的协议为 *从 URL 拉取* 是 `http://`, `https://`, `ftp://`，以及 `sftp://`。如果你的目录无法正确加载、更新或处理，请使用下表识别并解决问题。 | 问题 | 检查内容 | 如何修复 | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | URL 不是直接下载链接 | 在浏览器中打开你的 URL。如果它重定向到登录页面、云存储落地页，或返回 404 或 403 错误，则该 URL 不是直接下载链接。 | 请将 URL 更新为在浏览器中打开时可直接下载文件或显示原始数据的链接。 | | 文件名不匹配 | 该 *上传文件名* 你在目录设置中的必须与 URL 处的实际文件名完全一致，包括扩展名（`.csv`, `.xml`, `.txt`, `.gz`). | 更新 *上传文件名* ，使其与你的文件名完全一致。一个小小的不匹配就会导致 *请求未找到目录* 错误。 | | 格式或分隔符不匹配 | 请确认所选格式（CSV、TXT、XML、GMC）与你的文件匹配。如果你使用的是分隔文件，请确认分隔符（逗号、制表符、竖线）与配置一致。 | 请在目录设置中更正格式或分隔符。不匹配会导致 *未找到有效记录* 错误。 | | FTP/SFTP：凭据或路径无效 | 请验证你的 URL 使用以下格式 `sftp://{username}:{password}@{host}/{file_path}`。路径必须指向确切的文件，而不只是一个目录。凭据中的特殊字符必须进行 URL 编码（例如， `@` 会变为 `%40`). | 请使用 FileZilla 等 FTP 客户端测试你的凭据。使用更正后的凭据和完整文件路径更新 URL。 | | 拉取超时或连接失败 | 你的服务器防火墙可能正在阻止 impact.com 的请求。 | 请联系你的托管服务提供商或 IT 团队，将 impact.com 的 IP 地址范围加入允许列表。 | | URL 需要身份验证 | 此上传方式不支持基于会话或基于 cookie 的身份验证。 | 请使用可公开访问的直接下载 URL，或在 URL 中嵌入 HTTP Basic Auth（`https://user:pass@host/path`），或使用在 URL 中包含凭据的 FTP/SFTP。如果你的馈送需要基于浏览器的登录，请将目录切换为其他上传方式，例如 *直接上传* 或 *impact.com FTP 服务器*. | | URL 超过 2,048 个字符 | 签名云存储 URL 可能会超过 2,048 个字符限制并被截断。 | 请使用保留直接下载的短链接工具，或将文件托管在更短的 URL 上。 | | 目录卡在“处理中”或“待处理” | 请检查该文件是否仍可通过该 URL 访问，以及对于你的拉取频率而言文件大小是否异常大。 | 请确认文件可用。如果目录仍然处于 *处理中* 或 *待处理*, [联系支持](https://app.impact.com/support/portal.ihtml) ，请请求手动重新处理。 | | 目录停止自动更新 | 请检查同一 URL 下的文件是否仍可访问，以及文件名、格式或服务器访问设置是否已更改。 | 请在原始 URL 处恢复该文件，或更新你的目录设置以反映新的 URL 或文件名。对于大型目录（100 万+ 项），可考虑降低拉取频率以避免超时。 | | 上传后缺少字段或数据 | 请确认你的字段名称与所选格式的规范一致，例如 [Google Merchant Center 字段](https://support.google.com/merchants/answer/7052112) 用于 GMC 格式。将标准规范之外的自定义字段映射到 impact.com 的自定义字段槽位（`Numeric1`, `Text1`，依此类推）。 | 从 impact.com 下载你上传的目录，并将其与源文件进行比较，以找出数据丢失的位置。根据需要更新字段名称或映射，然后重新上传。 | ### 集成购物车导入 此方法会从现有电子商务平台拉取你的目录。大多数连接问题都源于凭据错误或缺少读取权限。请选择下面的平台。 {% tabs %} {% tab title="Shopify" %} 如果你看到如下错误，例如 *连接 Shopify 时 HTTP 状态码不成功：401* 或 *目录文件中未找到有效记录*，通常是你的身份验证信息或权限导致的。 * 你的密码必须是 **Admin API 访问令牌**，其开头为 `shpat_` （或 `shap_`）。你可以在 Shopify 管理后台中的以下位置找到它： **应用** **→** **API 凭据** **→** **Admin API 访问令牌**. * 如果你没有看到 **Admin API 访问令牌**下，选择 **安装应用** ，请在 Shopify 中安装应用来生成它。 * 请确认 `read_products` 权限（scope）已授予该应用。否则，Shopify 会返回错误，说明该操作需要商家批准该 `read_products` scope。 * 对于集合，请在 Shopify 管理后台中的以下位置查找集合 ID： **产品** **→** **集合**。选择该集合；其 ID 会显示在页面 URL 的末尾。 有关完整设置步骤，请参阅 [Shopify 产品目录集成指南](https://integrations.impact.com/impact-brand/docs/shopify-product-catalog). {% endtab %} {% tab title="WooCommerce" %} 如果你看到 *连接 WooCommerce 失败。请重试*，请检查你的凭据和 API 设置。 * 您的 **API 用户名** 是你的 WooCommerce *Consumer Key*，而你的 **API 密码** 是你的 *Consumer Secret*. * 在 WooCommerce 中启用旧版 REST API： **WooCommerce** **→** **设置** **→** **高级** **→** **旧版 API**，然后勾选复选框以启用它。 作为参考，请参阅 [WooCommerce REST API 文档](https://woocommerce.com/document/woocommerce-rest-api/). {% endtab %} {% tab title="BigCommerce" %} 连接 BigCommerce 需要两个值以及正确的只读权限。 * 输入你的 **商店哈希** 和 **访问令牌** ，位于 impact.com 界面中。你的商店哈希是商店 API 路径中的标识符。 * 设置 **产品** 和 **信息和设置** 权限设置为只读。 作为参考，请参阅 BigCommerce 关于以下内容的指南： [创建 API 令牌](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token). {% endtab %} {% tab title="Shoplazza" %} 你的 Shoplazza 私有应用需要以下资源的读取权限： `产品`, `集合`，以及 `店铺`. 有关设置步骤，请参阅 Shoplazza 关于以下内容的指南： [构建私有应用](https://www.shoplazza.dev/reference/quick-construction-of-private-apps). {% endtab %} {% endtabs %} ## 上传后排查错误和警告 文件接收后，impact.com 会验证每条记录。错误会阻止记录被处理，而警告会标记已接受但可能引发问题的数据。请使用以下部分来解读并解决它们。 ### 查看错误和警告 1. 在……中 *健康* 列中，选择 **错误**, **警告**，或者 **重复项** 链接。 * 你将被重定向到一个包含更多详细信息的页面。对于重复项集合，impact.com 只保留第一项；所有与第一项重复的项目都会被忽略。 2. 可选地，使用 *搜索* 以及页面顶部的筛选器来梳理问题。 3. 请查看这些问题并按需进行更改，然后重新上传你的产品目录。
筛选说明 | 筛选器 | 说明 | | ---- | ------------------------------------------------------- | | 错误类型 | 专门筛选 *错误*, *警告*, *重复项*，或者 *全部* 问题。 | | 必填 | 筛选任何特定缺失的产品目录必填字段，或者 *全部* 字段。 | | 建议 | 筛选任何特定缺失的产品目录推荐字段，或者 *全部* 字段。 | | 无效 | 筛选任何特定的基于验证的错误，例如重复 SKU、无效的 Google Category Code 或其他错误。 |
常见错误和警告信息 | 消息 | 说明 | | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | *记录‘X’：缺少必填字段：（字段名）* | 指定的行缺少一个或多个必填字段。 | | *记录‘X’：CatalogItemId(CatalogItemId)：缺少必填字段：（字段名）* | 数据文件中的一行缺少必填字段。 | | *请求未找到目录。请检查上传文件的文件名是否与目录中注册的文件名相同* | 该 *上传文件名* 在创建目录时设置的 *上传方式* 部分中的设置与上传文件的名称是否完全一致。 | | *目录文件中没有属性* | 产品目录数据文件没有任何可处理的数据。 | | *目录中同一 ID 的目录项出现了不止一次，第一条之后的条目将被忽略* | 两个或多个项目具有相同的 ID。所有产品都需要唯一值，重复项目不会被处理。 | | *记录‘X’有错误：（第 X 行）封装标记与分隔符之间存在无效字符* | 某一行中双引号的使用无效。请用双引号包裹字段，并将所有其他双引号替换为两个双引号。 | | *（第 X 行开始）在封装标记完成前到达文件末尾* | EOF 表示“文件末尾”。提到的起始行只有一个开头双引号，没有对应的结束双引号，或者意外的换行中断了数据流。 | | *解析（目录类型）字段时出错：值为：（字段）* | 产品字段无效，无法接受。 | | *记录（recordNumber）有错误：分隔值数量（FieldsLength）与预期值（ColumnNamesLength）不匹配* | 对于某一行，数据存在于一个没有标题的列中。 | | *目录文件中未找到有效记录* | 数据文件为空、检测到的数据无效，或指定的文件名不正确。 | | *文件中超过 10% 的记录存在错误* | 如果发生这种情况，数据文件将无法处理。请参阅 *了解 10% 错误阈值* 如下。 | | *由于内部系统错误，处理失败...* | 你无需采取任何操作。最后一次成功处理的目录仍会继续向媒体合作伙伴开放。请参阅 [impact.com 状态页面](https://status.impact.com/) 了解服务中断的详细信息。 | | *字段（字段名）和值（字段值）没有有效协议* | 字段值不是格式正确的 URL。 |
### 格式和分隔符警告 | 问题 | 如何修复 | | ----------------------------- | ------------------------------------------ | | 分隔符问题：错误的逗号、制表符或空行会破坏字段之间的边界。 | 请更正目录文件中的分隔符使用，使每个字段都一致分隔，然后重新上传。 | | 描述字段中的换行会中断记录处理。 | 分隔文本格式（CSV 和 TSV）不支持换行。上传前请移除描述等文本字段中的换行符。 | ### Google Merchant Center 格式错误 如果你使用 Google Merchant Center（GMC）格式，大多数问题都出现在该格式的 `类别` 部分、预定义字段值或 XML 结构上。 {% tabs %} {% tab title="缺少 Google 产品类别" %} 当您选择 *错误* 在 *产品目录* 界面中，你可能会看到 *缺少 Google 产品类别* 在 *建议* 列。这意味着你的目录中没有包含 Google Category Code 或完整的 Google 类别字符串。 要解决此问题，请参考你的 [Google Merchant Center 帐户](https://merchants.google.com/)。Google 会自动为项目建议类别；在上传更正后的目录时请使用这些建议。
{% endtab %} {% tab title="Google 产品类别不匹配" %} 当您选择 *错误* 在 *产品目录* 界面中，你可能会看到 *Google 产品类别不匹配* 在 *无效* 列。这意味着你的目录中用于项目的类别与预期的 [分类代码](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) （例如 7386）或 Google 提供的完整类别格式不匹配，例如： `动物及宠物用品 > 宠物用品 > 鸟类用品 > 鸟笼配件 > 鸟笼食物和水碗` 要解决此问题，请更正列出 Google 产品类别的格式，然后重新上传目录。
{% endtab %} {% tab title="可用性值不被接受" %} 例如 *无法解析字段：availability，值为* 表示预定义字段使用了 GMC 无法识别的值。对于 GMC 目录，类别和值必须完全准确。 * 使用 `availability` 用于 availability 字段。 * 支持的 availability 值为 `in_stock`, `out_of_stock`, `preorder`，以及 `backorder`. * 检查可能影响格式的特殊符号，例如值字段中出现的货币符号。 {% endtab %} {% tab title="XML：未找到有效记录" %} 如果你上传的是 Google Merchant Center（XML 格式）目录并看到 *目录文件中未找到有效记录。请修复文件并重新上传*，则 XML 结构可能不正确。 XML 文件必须在其起始元素中包含 `rss`, `RDF`，或者 `feed` 。请更正根元素并重新上传。 {% endtab %} {% endtabs %} {% hint style="info" %} **eBay Commerce Merchant Center 格式：** 在 `.csv` 文件中，请将字段列值（类别）中的空格替换为下划线。例如，使用 `Item_Title` 而不是 `Item Title`. {% endhint %} ### 了解 10% 错误阈值 如果上传文件中的记录有超过 10% 包含错误，则不会处理该文件。发生这种情况时： * 你的目录将继续显示上一次成功上传的版本，因此较旧的 *最后一次成功提交* 时间戳是预期的。 * 该 **查看商品** 只有在之前已成功为该目录 ID 上传文件时，此选项才会出现。 修复已标记的记录，使出错记录少于 10%，然后重新上传。 ## 让您的目录对合作伙伴可用 即使目录状态正常，在您将其设为可用并满足合作伙伴可见性要求之前，也不会供合作伙伴访问。如果您的目录已成功处理，但合作伙伴在可见性、商品访问或跟踪链接方面遇到问题，请使用此部分。 ### 合作伙伴看不到目录 检查以下两个设置： * 确保目录可供使用： 1. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **内容** **→** **产品** **→** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) 并找到该目录。 2. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[更多]** 然后选择 **设为可供使用**. * 检查合作伙伴访问是否受限： 1. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **内容** **→** **产品** **→** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) 并找到该目录。 2. 将鼠标悬停在目录上，然后选择 **编辑**. 3. 在……中 *限制合作伙伴访问* 部分，检查是否 **仅允许特定合作伙伴访问** 已 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) 已打开。 4. 如果是， ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) 将其关闭，然后选择 **保存**. ### 合作伙伴看不到或搜索不到特定商品 要使商品在合作伙伴界面中可见，必须满足以下所有要求： * 原价高于 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 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=&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.