> 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 FTP 服务器**：你将文件推送到我们的 FTP 服务器。 * **Impact 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 的产品目录](https://connexity.jitbit.com/helpdesk/KB/View/8469181-required-data-feed-fields-and-template)的 .TXT 和 .CSV 文件版本。生成产品目录后，你可以将其上传到 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. 输入你的 **商店的** 和 **Site 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 购物车集成目前仅适用于拥有 [Seller 订阅](/brand/zh/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) 的品牌，且不是自助服务功能。 {% endhint %} 如果你的 Seller 目录包含超过 1,000 个产品，请改用以下手动 [文件上传方式](#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. 选择 **保存** 以创建产品目录条目并转到上传屏幕（用于直接上传）。 * 否则，如果不是通过 *直接上传*添加你的目录，你将返回到 *产品目录* 屏幕并继续以下流程。 * 如果你的目录无法上传或连接，请参阅 [排查产品目录上传和连接问题](/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). {% 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] → 内容 → 产品 →** [**产品目录**](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 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/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 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.