> 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。

添加零售产品目录时，您需要完成 4 个步骤，这些步骤有助于展示您的产品、提升客户体验并简化购买流程。请按照以下 4 个步骤操作：

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F1diRYN9k9QfiHhDHlZMK%2Feng-350-6.mp4?alt=media&token=417e2657-d1ae-4bce-a600-f7e6572d4322>" %}

{% stepper %}
{% step %}
**检查程序广告设置**

在将产品目录添加到您的程序之前，请确保已在广告设置中启用它们。除非启用此设置，否则合作伙伴将无法查看您的产品目录。

1. 从顶部导航栏中选择 ![](/files/1cbb667ec4878308f24ec4acd13cbf03ede0bdfe) **\[用户资料] → 设置**.
2. 在右侧栏中，在 *常规*下，选择 [**广告设置**](https://app.impact.com/secure/advertiser/campaign/campaign-ad-settings-flow.ihtml).
3. 在 *广告类型* 部分中，在 *产品目录*下，确保 ![](/files/d4151d93ed2da7b33e79d07ae02bdd88dbd67390) **\[已勾选框]** **为此程序启用产品目录** 已勾选。
4. 选择 **保存**.
   {% endstep %}

{% 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. 为您的产品目录选择一种上传方式：
   * **直接上传**
   * **impact.com FTP 服务器**
   * **impact SFTP 服务器**
   * **从 URL 拉取**
   * **集成购物车导入**
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）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **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 产品目录的多种格式 [CJ Affiliate 产品目录](https://developers.cj.com/docs/data-imports/product-feeds)，包括 .TXT、.CSV、.PSV 和 .XML 文件，位于 *产品馈送规范：购物（Google 格式）* 部分。生成产品目录后，您可以将其上传到 impact.com。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **自定义格式**                         | <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://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">自定义格式文件字段</a> 以获取完整字段列表。</li><li>请参阅下面的示例，了解输入产品详情时应遵循的格式。</li></ul><p>3. 可选地，您可以向产品目录添加自定义字段。选择 <strong>添加另一个字段</strong>，然后选择 <img src="/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1" alt=""> <strong>\[下拉菜单]</strong> 并选择一个选项。</p><ul><li>查看 <a href="https://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">自定义格式文件字段</a> 以了解下拉菜单中的选项。</li></ul> |

{% 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. 输入您的电子商务访问详细信息。请在下方选择您的电子商务解决方案，以了解在哪里查找这些详细信息：<br>

   **Shopify**

   查看我们的 [Shopify 产品目录](https://integrations.impact.com/impact-brand/docs/shopify-product-catalog#step-1-gather-your-shopify-store-details) 指南，了解如何查找并设置您的凭据。

   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. 输入您的 **访问令牌**。了解如何 [创建访问令牌](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token) .
      * 在调用 API 创建令牌之前，您需要 [在 Bigcommerce 中创建店铺级 API 账户](https://support.bigcommerce.com/s/article/Store-API-Accounts?language=en_US) 并 [获取其管理员 API 访问令牌](https://developer.bigcommerce.com/docs/start/authentication) (`X-Auth-Token`）以验证您的请求。这是您将获得的 BigCommerce API 凭据示例：

        ```programlisting
        Client ID: h81bpnt123hrx3crd219ebxyr3dsou1
        Client secret: edbdc3c61dd6030909a5ea6a4c8123456a2824b41536bee6274b27a17fcbe5f8
        Access token: mv05yxg8ji49cdboa5wc8vpx1un1234
        ```
      * 还要包括必需的标头字段（`channel_id` / `channel_ids`, `allowed_cors_origins`）以及主体字段（`expires_at`).

   <div data-with-frame="true"><figure><img src="/files/e870da50e8b6bba589045ada3f14036ec6c2fea2" alt=""><figcaption></figcaption></figure></div>

   **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 %}

如果您的 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. 从 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]** 中选择 **语言** 和 **货币** ，以便向合作伙伴显示目录。
9. 使用 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]** 来选择 **服务区域** 用于地理定向。
   * 您的 *可用* 区域是您的程序所定位的服务区域。您可以按如下方式在程序设置中更改此项：<br>

     **管理可用服务区域**

     * 从顶部导航栏中选择 ![](/files/1cbb667ec4878308f24ec4acd13cbf03ede0bdfe) **\[用户资料]** **→ 设置**.
     * 在 *常规* 右侧栏中，选择 [**Marketplace 资料**](https://app.impact.com/secure/advertiser/campaign/view-edit-campaign-flow.ihtm).
     * 在 *程序信息*，然后进入 *服务区域*.
     * 使用 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]** 和 ![](/files/e13da78c3fe9466cb109d0fdd9febb23a52c304d) **\[未勾选框]** 以根据需要选择或取消选择服务区域。
     * 完成后，选择 **保存**.<br>
10. 可选地，您可以通过 API 管理您的产品目录。请参阅 [目录概览](https://integrations.impact.com/impact-brand/reference/catalogs-overview).
11. 可选地，设置移动端回退。<br>

    **配置移动端回退**

    您可以在产品目录上设置移动端回退。此选项允许您将流量发送到移动应用，从而使合作伙伴能够在多个平台上为单个应用使用通用广告。

    1. 在 *移动应用回退* 部分， ![](/files/3980f01ba7b178cc917bfb7b270feb4fac2992c6) **\[开启切换] 移动端回退**.
       * 或者，找到现有产品目录并选择 **编辑**.
    2. 从 ![](/files/9ee7bd3c79aae4d0667377d18611647c3469f8d1) **\[下拉菜单]** 下的选项 *Android* 和 *iOS*，为每个平台选择一个回退选项。随后此选择将填充为下载您应用的 URL。
       * 一旦设置了移动端回退，impact.com 将自动检测消费者的设备类型，并将其引导至相应的应用商店下载您的应用。
    3. 选择 **保存**.<br>
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. 处理这些问题，然后使用与上传原始目录相同的方法将目录重新上传到 impact.com。
   * 自动获取目录的上传方式应在下一次抓取事件发生时自动更新。
     {% 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) **\[更多]** → **设为可用**.<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="/pages/7e018428977ed40ba4dc6046c8b55b61463d1c51"><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 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=<question>&goal=<endgoal>
```

`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.
