> 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 和 Mobile App： * `SKU` / `CatalogItemId` * `产品 URL` * `图片 URL` * `库存可用性` * `价格` （仅显示价格高于 2.00 美元的产品） * 参见 [产品目录字段要求](/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. 从顶部导航栏中选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[用户资料] → 设置**. 2. 在右侧列中，在 *常规*下选择 [**广告设置**](https://app.impact.com/secure/advertiser/campaign/campaign-ad-settings-flow.ihtml). 3. 在 *广告类型* 部分中，在 *产品目录*下确保 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[已勾选复选框]** **为此计划启用产品目录** 已勾选。 4. 选择 **保存**. {% endstep %} {% endstepper %} ## 连接您的目录 请执行以下操作，将您的目录添加到 impact.com，并使其中的产品可供推广。 {% stepper %} {% step %} ### 上传您的产品目录 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. 在右上角选择 **创建产品目录** **资源** → **零售**. * 有关信用卡目录，请参见 [添加信用卡目录](/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.com FTP 服务器**：您将文件推送到我们的 FTP 服务器。 * **impact.com SFTP 服务器**：一种专用于特定集成的特殊上传方式。 * **直接上传**：每次需要更新目录时，您都需要手动上传目录文件。 7. 如果适用，请选择一个 **格式**。否则，请选择 **集成购物车导入**. {% tabs %} {% tab title="格式" %} 1. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]**，然后选择一种格式。 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. 可选地，您可以向产品目录添加自定义字段。

a. 选择 添加另一个字段。

b. 选择 \[下拉菜单]。

c. 选择一个选项。

| | **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 目前支持 Connexity 产品目录的 .TXT 和 .CSV 文件版本。 [Connexity 的产品目录](https://connexity.jitbit.com/helpdesk/KB/View/8469181-required-data-feed-fields-and-template)。生成产品目录后，您可以将其上传到 impact.com。 | | **CJ Affiliate by Conversant** | impact.com 支持多种格式的 [CJ Affiliate 产品目录](https://developers.cj.com/docs/data-imports/product-feeds)，包括 .TXT、.CSV、.PSV 和 .XML 文件，位于 *Product Feed Specifications: Shopping (Google Format)* 部分。生成产品目录后，您可以将其上传到 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. 在 **Shopify Authentication Version**旁边，选择与您的设置相匹配的连接方式（详见上方指南）。 2. 按照上方指南输入所选方式的凭据。 3. 输入 **商店的** 基础 URL * 例如， `https://www.acmeacademy.com`. 4. 可选地，输入一个 **集合 ID**. 5. 可选地， ![\[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. 对于 **Consumer Key**, **Consumer Secret**, **Access Token**和 **Access Token Secret**，请访问您的 [身份验证密钥和令牌](https://devdocs.magento.com/guides/v2.3/get-started/authentication/gs-authentication-token.html). **BigCommerce** 1. 输入您的 **Store Hash**. 2. 输入您的 **Access Token**. * 您需要 [在 BigCommerce 中创建一个商店级 API 账户](https://support.bigcommerce.com/s/article/Store-API-Accounts) ，并使用生成的访问令牌连接您的产品目录。这是您将获得的 BigCommerce API 凭据示例： ```programlisting Client ID: h81bpnt123hrx3crd219ebxyr3dsou1 Client secret: edbdc3c61dd6030909a5ea6a4c8123456a2824b41536bee6274b27a17fcbe5f8 Access token: mv05yxg8ji49cdboa5wc8vpx1un1234 ``` * 对于商店级 API 范围，请将 *产品* 和 *信息和设置* 都设为只读。其余范围可保持不变。 **WooCommerce** 1. 输入 **商店的** 基础 URL * 例如， `https://www.acmeacademy.com`. 2. 输入您的 **API 用户名** 和 **密码**. * **API 用户名** — 输入您的 *Consumer Key* 这里 * **API 密码** — 输入您的 *Consumer Secret* 这里 了解如何 [生成您的密钥](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. 输入您的 **商店的** 和 **站点 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. 输入您的 **Access Token**. * 了解如何获取您的 [Access Token](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 %} 如果您的 Seller 目录包含超过 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. 从 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]** 中选择 **语言** 和 **货币** ，目录将在其中向合作伙伴显示。 9. 使用 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]** 选择 **服务区域** 进行地理定向。 * 您的 *可用* 区域是您的计划所针对的服务区域。您可以按如下方式在计划设置中更改此项：
### 管理可用服务区域 * 从顶部导航栏中选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[用户资料]** **→ 设置**. * 在 *常规* 右侧列中的 [**Marketplace 资料**](https://app.impact.com/secure/advertiser/campaign/view-edit-campaign-flow.ihtm). * 在 *计划信息*下，前往 *服务区域*. * 使用 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]** 和 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9fd92d4378edf839f6a1f6fc0beaa1660b3892b5%2F69842c54f03332c1e2eed608d72b25ad10248384a914164a7255a1e94dc76ee2.svg?alt=media) **\[未勾选复选框]** ，按需选择或取消选择服务区域。 * 完成后，选择 **保存**.
10. 可选地，您可以通过 API 管理您的产品目录。请参阅 [目录概览](https://integrations.impact.com/brand-api-reference/reference/catalogs). 11. 可选地，设置移动端回退。
### 配置移动端回退 您可以在产品目录上设置移动端回退。此选项可让您将流量发送到移动应用，从而使合作伙伴能够在多个平台上使用适用于单个应用的通用广告。 1. 在 *移动应用回退* 部分， ![](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) **\[打开切换] 移动回退**. * 或者，找到一个现有产品目录并选择 **编辑**. 2. 从 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]** 下的选项 *Android* 和 *iOS*，并为每个平台选择一个回退选项。随后，该选择将填充为下载您应用的 URL。 * 一旦设置了移动端回退，impact.com 将自动检测消费者的设备类型，并将其引导至相应的应用商店下载您的应用。 3. 选择 **保存**.
12. 选择 **保存**. 13. 可选地，如果要限制哪些合作伙伴可以访问此产品目录， ![](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) **\[打开切换] 限制合作伙伴访问**，然后输入以下名称： *合作伙伴* 以及合作伙伴 *组* ，它们应拥有访问权限。 14. 选择哪些 *合作伙伴下载选项* 要为此目录提供。您可以启用的选项包括 **FTP**, **API**，或 **合作伙伴门户浏览器下载** 15. 选择 **保存** 以创建产品目录条目并转到上传界面（适用于直接上传）。 * 否则，如果不是通过 *直接上传*添加您的目录， *产品目录* 您将返回到 {% endstep %} {% step %} ### 审核并排查目录健康问题 每个产品目录都有一个健康评分，用于突出显示任何问题。要达到 *优秀* 范围，请解决错误、警告和重复项。 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] → Content → Products →** [**产品目录**](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. 将鼠标悬停在您刚添加的目录上，在右侧选择 ![](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) **\[更多]** → **设为可用**.

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

{% 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.