> 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/add-product-catalogs-as-a-brand.md). # 以品牌方身份添加商品目录 产品目录是一种数据馈送，包含您的产品及其元数据列表。它们通常用于在线销售产品，但也可用于其他行业，例如信用卡、旅游、房产列表等。许多品牌会通过其电子商务（或购物车）解决方案创建产品目录，并可导出后与 impact.com 共享。 添加零售产品目录时，您需要完成一系列步骤，这些步骤有助于展示您的产品、提升客户体验并简化购买流程。请按以下步骤操作： {% embed url="" %} ## 准备上传您的目录 请执行以下操作，以使您的目录获得尽可能最佳的曝光和效果。 {% stepper %} {% step %} ### 确保满足 Marketplace 可见性要求 1. 目录文件中的每个产品都必须包含以下关键字段的完整数据，否则可能会被排除在 Marketplace 展示位之外，例如 Product Marketplace 和移动应用： * SKU / `CatalogItemId` * `产品 URL` * `图片 URL` * `库存可用性` * `价格` （仅显示价格高于 2.00 美元 USD 的产品） * 请参阅 [产品目录字段要求](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md) 以查看完整字段列表。 2. 为避免不必要的验证错误并确保您具备所有必填字段，最好还将您的目录文件与我们的 [产品目录最佳实践](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) 保持一致，然后再继续。 {% endstep %} {% step %} ### 检查您的项目广告设置 在向您的项目添加产品目录之前，请确保已在广告设置中启用它们。除非启用此设置，否则合作伙伴将无法查看您的产品目录。 1. 在顶部导航栏中，选择 ![](/files/34cff7cafbbfcd416778a35b63cb058c27bcda8b) **\[用户资料] → 设置**. 2. 在右侧栏中，在 *常规*下，选择 [**广告设置**](https://app.impact.com/secure/advertiser/campaign/campaign-ad-settings-flow.ihtml). 3. 在 *广告类型* 部分，在 *产品目录*下，确保 ![](/files/d4151d93ed2da7b33e79d07ae02bdd88dbd67390) **\[已勾选复选框]** **为此项目启用产品目录** 已勾选。 4. 选择 **保存**. {% endstep %} {% endstepper %} ## 连接您的目录 请执行以下操作，将您的目录添加到 impact.com，并使其产品可供推广。 {% stepper %} {% step %} ### 上传您的产品目录 1. 在左侧导航栏中，选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[Engage]** → **内容** → **产品** → [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. 在右上角，选择 **创建产品目录** **资产** → **零售**. * 有关信用卡目录，请参阅 [添加信用卡目录](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-credit-card-catalogs-as-a-brand.md). 3. 输入一个唯一的 **产品目录名称** （合作伙伴将通过此名称搜索它）。 4. 可选地，输入 **标签** ，合作伙伴可使用这些标签搜索此产品目录。 5. 可选地，上传一个包含 *目录说明* 的 PDF 文档，以便合作伙伴了解如何浏览您的产品目录。 6. 为您的产品目录选择一种上传方式（按推荐顺序列出）： * **从 URL 拉取**：impact.com 将从您的服务器拉取目录。 * **集成购物车导入**：impact.com 将从您的购物车中拉取目录。 * **Impact FTP 服务器**：您将文件上传到我们的 FTP 服务器。 * **Impact SFTP 服务器**：一种仅供特定集成使用的专用上传方式。 * **直接上传**：每次需要更新时，您都需手动上传目录文件。 7. 如适用，请选择一个 **格式**。否则，选择 **集成购物车导入**. {% tabs %} {% tab title="格式" %} 1. 选择 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]**，然后选择一种格式。 2. 输入 **上传文件名** ，以及产品目录的文件扩展名。您在此输入的名称必须与您上传文件的名称一致。 * 例如， `starks_catalog.xml`, `starks_catalog.txt`, `starks_catalog.csv`. * 如果您使用 CSV 文件，请将字段名中的空格替换为下划线。 | 格式 | 说明 | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Google Merchant Center** | impact.com 目前支持 Google Merchant 的 [基于文本的格式](https://support.google.com/merchants/answer/7052112) （以制表符分隔的 TXT 文件，而非 CSV 文件），以及 [XML 文件](https://support.google.com/merchants/answer/14987622) （RSS 和 Atom）。 | | **自定义格式** |

impact.com 也支持自定义格式的目录。您可以上传 .XML、.TXT、.CSV 和 .PSV 格式的文件。

1. 指定您的自定义目录的 链接 URL 字段、目录项 ID 字段和名称字段 ，并分别在对应的文本框中填写。这些字段为必填项。

2. 填写 目录项 ID 和 名称 必填字段。

3. 可选地，您可以向产品目录添加自定义字段。选择 添加另一个字段，然后选择 \[下拉菜单] 并选择一个选项。

| | **eBay Commerce Merchant Center** | impact.com 支持 eBay Commerce 的基于文本（.TXT 和 .CSV）以及 XML 格式。使用 .CSV 文件时，请确保将 Field 列中的空格替换为下划线。您还可以查看 eBay Commerce 商家文件字段 [此处](https://docs.google.com/spreadsheets/d/1np1YixxczH_IZBxer-EckMkAdcV9_lp74RQAtI-1Ct0/edit?usp=sharing). | | **Connexity Merchant Center** | impact.com 目前支持以下 .TXT 和 .CSV 文件版本： [Connexity 的产品目录](https://connexity.jitbit.com/helpdesk/KB/View/8469181-required-data-feed-fields-and-template)。生成产品目录后，您可以将其上传到 impact.com。 | | **由 Conversant 提供的 CJ Affiliate** | impact.com 支持以下多种格式的 [CJ Affiliate 产品目录](https://developers.cj.com/docs/data-imports/product-feeds)，包括在以下部分下的 .TXT、.CSV、.PSV 和 .XML 文件： *产品供稿规范：Shopping（Google 格式）* 部分。生成产品目录后，您可以将其上传到 impact.com。 | {% hint style="info" %} **示例** ```programlisting name,id,url,manufacturingcost,mycurrency,mycategory ACME Bird Seed,1234567,http://example.com/products,20,USD,Accessories ``` {% endhint %} {% endtab %} {% tab title="集成购物车导入" %} 1. 选择您的 **购物车** 解决方案： * **Shopify**, **Magento**, **BigCommerce**, **WooCommerce**, **Demandware**, **Shoplazza**，或 **Amazon**. 2. 输入您的电子商务访问详情。请选择下方的电子商务解决方案，了解如何找到这些信息：
**Shopify** 查看我们关于 [Shopify 产品目录](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog) 的指南，了解如何查找和设置您的凭证。 1. 输入 **基础 URL** ，即您的商店。 * 例如， `https://www.acmeacademy.com`. 2. 输入您的 **访问令牌**. * 了解如何获取您的 [访问令牌](https://shopify.dev/docs/api/storefront/latest/objects/CustomerAccessToken). 3. 可选地，输入一个 **集合 ID**. 4. 可选地， ![\[Toggle on\]](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-84d1224fd3bb6ba94b899febe2021eaa.svg) **\[切换开启]** **包含产品变体** ，以过滤掉变体。 **Magento** 1. 输入 **基础 URL** ，即您的商店。 * 例如， `https://www.acmeacademy.com`. 2. 对于 **消费者密钥**, **消费者机密**, **访问令牌**和 **访问令牌密钥**，请访问您的 [身份验证密钥和令牌](https://devdocs.magento.com/guides/v2.3/get-started/authentication/gs-authentication-token.html). **BigCommerce** 1. 输入您的 **商店哈希**. 2. 输入您的 **访问令牌**. * 您需要 [创建店铺级 API 账户](https://support.bigcommerce.com/s/article/Store-API-Accounts) 在 BigCommerce 中，并使用生成的访问令牌连接您的产品目录。以下是您将获得的 BigCommerce API 凭证示例： ```programlisting 客户端 ID：h81bpnt123hrx3crd219ebxyr3dsou1 客户端密钥：edbdc3c61dd6030909a5ea6a4c8123456a2824b41536bee6274b27a17fcbe5f8 访问令牌：mv05yxg8ji49cdboa5wc8vpx1un1234 ``` * 对于店铺级 API 范围，请将 *产品* 和 *信息和设置* 都设为只读。其他所有范围可保持不变。 **WooCommerce** 1. 输入 **基础 URL** ，即您的商店。 * 例如， `https://www.acmeacademy.com`. 2. 输入您的 **API 用户名** 和 **密码**. * **API 用户名** — 输入您的 *消费者密钥* 此处 * **API 密码** — 输入您的 *消费者机密* 此处 了解如何 [生成您的密钥](https://woocommerce.com/document/woocommerce-rest-api/#generate-api-keys)。您还需要启用 [旧版 REST API](https://woocommerce.com/document/woocommerce-rest-api/#enable-legacy-rest-api). **Demandware** 1. 输入您的 **基础 URL** 和 **站点 ID**。它们将相同。了解如何获取您的 [站点 ID](https://documentation.b2c.commercecloud.salesforce.com/DOC1/index.jsp?topic=%2Fcom.demandware.dochelp%2FDWAPI%2Fscriptapi%2Fhtml%2Fapi%2Fclass_dw_system_Site.html). * 例如， `https://www.acmeacademy.com`. 2. 了解如何获取 [API 用户名和密码凭证](https://developer.salesforce.com/docs/commerce/b2c-commerce/references/b2c-commerce-ocapi/get-started-with-ocapi.html). **Shoplazza** 1. 输入 **基础 URL** ，即您的商店。 * 例如， `https://www.acmeacademy.com`. 2. 输入您的 **访问令牌**. * 了解如何获取您的 [访问令牌](https://www.shoplazza.dev/reference/overview-23). 3. 可选地，指定一个 **集合 ID** ，以仅添加来自特定 [Shoplazza 产品集合](https://www.shoplazza.dev/reference/collection-list). **Amazon** {% hint style="warning" %} **警告：** Amazon 购物车集成目前仅适用于拥有 [卖家订阅](/brand/zh/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) 的品牌，且不是自助服务功能。 {% endhint %} 如果您的卖家目录包含超过 1,000 个产品，请改用以下手动 [文件上传方式之一](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand#format) 来导入。由于 Amazon API 限制，自动目录导入仅限 1,000 个产品。 {% endtab %} {% endtabs %} 8. 在 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单] 中，** 选择 **语言** 和 **货币** ，目录将以此显示给合作伙伴。 9. 使用 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]** 来选择 **服务区域** ，用于地理定向。 * 您的 *可用* 区域是您的项目所针对的服务区域。您可以按以下方式在项目设置中更改：
### 管理可用服务区域 * 在顶部导航栏中，选择 ![](/files/34cff7cafbbfcd416778a35b63cb058c27bcda8b) **\[用户资料]** **→ 设置**. * 在 *常规* 右侧栏中的 [**Marketplace 资料**](https://app.impact.com/secure/advertiser/campaign/view-edit-campaign-flow.ihtm). * 在 *项目信息*，前往 *服务区域*. * 使用 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]** 和 ![](/files/e13da78c3fe9466cb109d0fdd9febb23a52c304d) **\[未勾选复选框]** ，根据需要选择或取消选择服务区域。 * 完成后，选择 **保存**.
10. 可选地，您可以通过 API 管理您的产品目录。请参阅 [目录概览](https://integrations.impact.com/brand-api-reference/reference/catalogs). 11. 可选地，设置移动端回退。
### 配置移动端回退 您可以在产品目录上设置移动端回退。此选项可将流量导向您的移动应用，使合作伙伴能够在多个平台上为单个应用使用通用广告。 1. 在 *移动应用回退* 部分， ![](/files/3980f01ba7b178cc917bfb7b270feb4fac2992c6) **\[切换开启] 移动端回退**. * 或者，找到现有的产品目录并选择 **编辑**. 2. 在 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]** 下的选项 *Android* 和 *iOS*，为每个平台选择一个回退选项。然后，此选择将填充为下载您应用的 URL。 * 一旦设置了移动端回退，impact.com 将自动检测消费者的设备类型，并将其引导至相应的应用商店下载您的应用。 3. 选择 **保存**.
12. 选择 **保存**. 13. 可选地，如需限制哪些合作伙伴可以访问此产品目录， ![](/files/3980f01ba7b178cc917bfb7b270feb4fac2992c6) **\[切换开启] 限制合作伙伴访问**，然后输入 *合作伙伴* 以及合作伙伴 *群组* 的名称，这些对象应具有访问权限。 14. 选择 *合作伙伴下载选项* ，为此目录提供哪些选项。您可以启用的选项包括 **FTP**, **API**，或 **合作伙伴门户浏览器下载** 15. 选择 **保存** 以创建产品目录条目并进入上传界面（适用于直接上传）。 * 否则，如果不是通过 *直接上传*添加您的目录，您将返回到 *产品目录* 界面，并继续以下流程。 {% endstep %} {% step %} ### 查看并排查目录健康问题 每个产品目录都有一个健康评分，用于突出显示任何问题。要达到 *优秀* 级别，请解决错误、警告和重复项。 1. 在左侧导航菜单中，选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[Engage] → 内容 → 产品 →** [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. 如果目录中存在任何错误、警告或重复条目，您将在 *健康* 列中看到每种问题的数量。 * **待处理** - 您的目录正在上传。 * **处理中** - 您的目录正在处理。 * **优秀** - 您的目录状态良好。此产品数据集完整且结构清晰，因而最有可能取得良好效果。 * **良好** - 某些关键字段（如类别或状态）可能缺失。修复这些问题对于提高目录的整体质量是必要的。 * **较差** - 超过 10% 的必需信息缺失。必须修复目录并重新上传。 3. 选择 *错误*, *警告*，或 *重复项* 以查看有问题的条目。 * 在重复项中，impact.com 仅显示第一项；所有与第一项重复的条目都将被忽略。 4. 请使用以下内容解决这些问题： [排查产品目录错误和警告](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md) 作为指南。然后使用上传原始目录时相同的方法，将目录重新上传到 impact.com。 * 自动获取目录的上传方式应在下次获取事件发生时自动更新。 {% hint style="warning" %} **重要提示：** 为确保您的目录获得尽可能最佳的曝光和效果，请务必查看 [产品目录最佳实践](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md). {% endhint %} {% endstep %} {% step %} ### 让合作伙伴可使用目录 添加目录并检查其健康状况后，请继续执行最后一步，使其可供合作伙伴使用，并确保您的产品在 Product Marketplace 中展示。这可能会吸引更多项目申请。请考虑 [创建工作流](/brand/zh/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications.md) ，以自动化您的项目申请处理。 1. 在 [*产品目录*](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) 界面中，找到您刚添加的目录。 2. 将鼠标悬停在您刚添加的目录上，在右侧选择 ![](/files/48274f9251fd79e93a99aad7b4393690b07a61c9) **\[更多]** → **设为可供使用**.

注意： 启用直接产品链接时，请将产品落地页域名作为可深度链接域名添加到 “允许合作伙伴深度链接到我网站上的特定页面” 跟踪设置部分。

{% endstep %} {% endstepper %} --- # 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/add-product-catalogs-as-a-brand.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.