> 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="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FTtHlyOvkaoQKdu5KeXFY%2Fcamp-250-6-final_draft.mp4?alt=media&token=5d10fe55-bb9a-4d8a-85d6-d0eace7c24ad>" %}

## 准备要上传的目录

请执行以下操作，为目录设置最佳的曝光度和效果。

{% stepper %}
{% step %}

### 确保符合 Marketplace 的曝光要求

1. 目录文件中的每件产品都必须在以下关键字段中包含完整数据，否则可能不会显示在 Product Marketplace 和移动应用等 Marketplace 页面中：
   * `SKU` / `CatalogItemId`
   * `Product URL`
   * `Image URL`
   * `Stock Availability`
   * `Price` （仅显示价格高于 2.00 美元的产品）
     * 有关字段完整列表，请参阅 [产品目录字段要求](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md) 。
2. 为避免不必要的验证错误并确保包含所有必填字段，建议您在继续操作前，按照我们的 [产品目录最佳实践](https://help.impact.com/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) **\[互动]** → **内容** → **产品** → [**产品目录**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. 在右上角，选择 **创建产品目录** **资源** → **零售**.
   * 有关信用卡商品目录，请参阅 [添加信用卡商品目录](https://help.impact.com/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）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **自定义格式**                         | <p>impact.com 也支持自定义格式的商品目录。您可以上传 .XML、.TXT、.CSV 和 .PSV 格式的文件。</p><p>1. 指定自定义商品目录的 <strong>链接 URL 字段、目录商品 ID 字段和名称字段</strong> 在相应的文本框中填写。这些字段为必填项。</p><p>2. 填写 <strong>目录商品 ID</strong> 和 <strong>名称</strong> 必填字段。</p><ul><li>查看 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md">产品目录字段要求</a> ，查看完整字段列表。</li><li>请参阅下方示例，了解填写产品详情时应遵循的格式。</li></ul><p>3. 你也可以选择为产品目录添加自定义字段。</p><p>a. 选择 <strong>添加另一个字段。</strong></p><p>b. 选择 <img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media" alt=""> <strong>\[下拉菜单]。</strong></p><p>c. 选择一个选项。</p><ul><li>查看 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md">产品目录字段要求</a> ，详细了解下拉菜单中的选项。</li></ul> |
| **eBay Commerce Merchant Center** | impact.com 支持 eBay Commerce 的文本格式（.TXT 和 .CSV）以及 XML 格式。使用 .CSV 文件时，请确保将 Field 列中的空格替换为下划线。你也可以在 [此处](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)的多种格式，包括 *产品 Feed 规范：购物（Google 格式）* 部分中所述的 .TXT、.CSV、.PSV 和 .XML 文件。生成产品目录后，你可以将其上传到 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**, **BigCommerce**, **WooCommerce**, **Shoplazza**，或 **Amazon**.
2. 输入你的电子商务访问详细信息。选择下方的电子商务解决方案，了解如何查找这些信息：<br>

   **Shopify**

   查看我们的指南，了解 [Shopify 产品目录](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog) ，学习如何查找和设置凭据。

   1. 在 **Shopify 身份验证版本**旁边，选择与您的设置相符的连接方式（详情请参阅上方指南）。
      * 每个 Shopify 商店只能支持一个 *V3 - Impact 应用（推荐）* 目录。同一商店中的任何其他目录，请选择 **V1 - 无应用**.
   2. 按照上方指南，输入所选方式对应的凭据。
   3. 输入您商店的 **基本 URL** 。
      * 例如， `https://www.acmeacademy.com`.
   4. 您也可以选择要纳入目录的 Shopify 产品系列：
      * **V3 - Impact 应用（推荐）**：选择 **获取所有产品系列**，然后在 **产品系列名称** 下拉菜单中选择一个或多个产品系列。
      * **V2 - 自定义应用** 或 **V1 - 无应用**：在 **产品系列 ID** 字段中输入一个或多个产品系列 ID，并用逗号分隔。
      * 要导入整个目录，请将此字段留空。
   5. 您也可以关闭以下选项，以便不将产品变体纳入目录： ![](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) **\[关闭开关] 包含产品变体**.

   **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 用户名** — 输入你的 *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).

   **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 购物车集成功能目前仅对拥有 [Seller 订阅](https://help.impact.com/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 %}
{% endstep %}

{% step %}

### 配置商品目录设置

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. 使用 ![](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) **\[用户个人资料] → 设置 →** [**市场资料**](https://app.impact.com/secure/advertiser/campaign/view-edit-campaign-flow.ihtm)，然后更新 *服务区域* 下的 *计划信息*.
3. 你也可以设置移动端备用跳转，将流量引导至你的移动应用。这样，合作伙伴便可在多个平台上为同一个应用使用通用广告。
   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 会自动检测消费者的设备类型，并将其引导至相应的应用商店下载应用。
4. 如需限制可访问此产品目录的合作伙伴， ![](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) **\[开启] 限制合作伙伴访问权限**，然后输入 *合作伙伴* 以及应具有访问权限的合作伙伴 *群组* 名称。
5. 选择要为此目录提供的 *合作伙伴下载选项* 。可启用的选项包括 **FTP**, **API**或 **合作伙伴门户浏览器下载**.
6. 选择 **保存** 以创建产品目录条目并进入上传页面（用于直接上传）。
   * 如果未通过 *直接上传*添加目录，则会返回 *产品目录* 页面，并继续以下流程。

{% hint style="success" %}
**注意：** 你也可以通过 API 管理产品目录。请参阅 [目录概览](https://integrations.impact.com/brand-api-reference/reference/catalogs).
{% endhint %}
{% 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. 请参考 [《产品目录错误和警告疑难排解》](https://help.impact.com/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" %}
**重要提示：** 为了确保您的目录获得尽可能高的可见度和效果，请务必参阅 [《产品目录最佳实践》](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md).
{% endhint %}
{% endstep %}

{% step %}

### 向合作伙伴开放目录

添加目录并检查其状态后，请继续完成最后一步，向合作伙伴开放目录，并确保您的产品在产品市场中展示。这有助于吸引更多计划申请。您可以考虑 [创建工作流](https://help.impact.com/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) **\[更多]** → **开放使用**.<br>

   <div data-gb-custom-block data-tag="hint" data-style="success" data-icon="circle-info" class="hint hint-success"><p><strong>注意：</strong> 若要启用产品直达链接，请在跟踪设置的 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md"><em>允许合作伙伴深度链接到我网站上的特定页面</em></a> 部分，将产品落地页域名添加为可深度链接的域名。</p></div>

{% 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=<question>&goal=<user_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.
