> 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-promotions/upload-product-promotion-files.md).

# 上传产品促销文件

此 *产品促销* 功能可让您与合作伙伴分享特别优惠和促销活动。这些优惠会显示在合作伙伴的产品 Feed、产品 API 和 impact.com 的产品市场中，且 *特别优惠* 标记会直接显示在搜索结果中的产品卡片上。

{% hint style="warning" %}
**重要提示：** 开始之前，您需要先拥有有效的产品目录。如需了解如何创建首个产品上传文件，请参阅 [添加产品目录](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### 上传促销文件

使用 [促销文件模板](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) 创建文件。两种上传方式使用相同的文件格式。

{% tabs %}
{% tab title="直接上传" %}

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-product-promotion-flow.ihtml).
2. 在右上角，选择 **上传促销文件**.
3. 输入 **促销文件名称**.
4. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[单选按钮]** **直接上传** 方式。
5. 选择文件 **格式**.
   * impact.com 仅支持 *Google Merchant Center（TXT 格式）* 即 `.txt` 和 *Google Merchant Center（CSV 格式）* 即 `.csv` 文件。
   * 如需详细了解这些字段，请参阅下方的 *产品促销 Feed 字段参考* 。
6. 选择 **选择文件**.
   * 在电脑上找到要上传的文件。
7. 选择首选 **语言** 并 **保存**.
   {% endtab %}

{% tab title="从 URL 提取" %}
此选项支持从 FTP/SFTP 服务器或 HTTP/HTTPS URL 提取文件，确保促销数据保持最新。

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-product-promotion-flow.ihtml).
2. 在右上角，选择 **上传促销文件**.
3. 输入 **促销文件名称**.
4. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[单选按钮]** **从 URL 提取** 上传方式。
5. 选择文件 **格式**.
   * impact.com 仅支持 *Google Merchant Center（TXT 格式）* 即 `.txt` 和 *Google Merchant Center（CSV 格式）* 即 `.csv` 文件。
   * 如需详细了解这些字段，请参阅下方的 *产品促销 Feed 字段参考* 。
6. 输入 **名称** 下的文件 *上传文件名*.
7. 输入 **拉取 URL** 该 URL 指向存放促销数据文件的目录。
   * 此 URL 可以是 FTP 或 HTTPS URL。例如， `ftp://ftp.acme.com` 或 `https://acme.com/anvil_promotions/anvil.txt`
8. 选择 **获取频率** 以设置 impact.com 获取文件的频率：
   * 每天
   * 每 8 小时
   * 每 4 小时
   * 每 2 小时
9. 选择 **获取时间** impact.com 获取文件的时间。
   * 显示的选项采用 GMT -05:00 东部时间。
10. 选择你的 **时区**.
11. 选择首选 **语言** 并 **保存**.
    {% endtab %}
    {% endtabs %}

<details>

<summary>商品促销 Feed 字段参考</summary>

| 预期字段                               | 必填？ | 说明                         | 格式                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------- | --- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                | 是   | 每项促销的唯一 ID。                | ID 区分大小写，最多可包含 50 个字符，且不能包含空格或符号，例如： `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 适用范围 `[product_applicability]`     | 是   | 此属性指定促销适用于所有商品，还是仅适用于特定商品。 | <p>支持的值：</p><p>• <code>all\_products</code></p><p>•<code>specific\_products</code></p><p>只有在你的 <a href="https://support.google.com/merchants/answer/2906014?hl=en">Google 促销 Feed 文件</a> 与 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">商品目录</a> 中都包含 <code>promotion\_id</code>时，impact.com 才能将促销与特定商品进行匹配。除非你的商品目录包含促销 ID，否则不能使用 <code>specific\_products</code> 值。请参阅 <a href="#link-promotions-to-specific-products">将促销关联到特定商品</a>.</p> |
| 说明 `[long_title]`                  | 是   | 每项促销的完整标题。                 | 标题最长为 60 个字符。例如： `Free mug with purchase`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 生效时间 `[promotion_effective_dates]` | 是   | 促销的有效期。                    | <p>• <strong>开始</strong> 和 <strong>结束</strong> 日期之间用正斜杠 (/) 分隔。</p><p>• 日期格式为 (YYYY-MM-DD)，后接字母 ‘T’、促销开始或结束的具体时间，以及促销所在时区的表示形式。</p><p>• 示例： <code>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</code></p>                                                                                                                                                                                                                                                                                                                                    |
| 展示时间 `[promotion_display_dates]`   | 否   | 此属性用于指定促销上线的日期和时间范围。       | 日期 **开始** 和 **结束** 日期之间用正斜杠 (/) 分隔，例如： `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 渠道 `[redemption_channel]`          | 是   | 此属性表示促销适用于线上或实体店。          | <p>支持的值：</p><p>• <code>online</code></p><p>• <code>in\_store</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 优惠码类型 `[offer_type]`               | 是   | 此属性用于指明客户兑换优惠时是否需要优惠券代码。   | <p>支持的值：</p><p>• <code>no\_code</code></p><p>• <code>generic\_code</code></p><p><strong>重要提示：</strong> 如果此属性的值为 <code>generic\_code</code>，则必须提供 <code>generic\_redemption\_code</code> 。</p>                                                                                                                                                                                                                                                                                                                                                       |
| 优惠码 `[generic_redemption_code]`    | 否   | 此属性用于指定可在线兑换促销优惠的代码。       | 最长为 20 个字符，例如： `EXTRA20`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 目标网址 `[promotion_destination]`     | 否   | 此属性用于指定每项促销的格式。            | <p>支持的值：</p><p>• <code>Shopping\_ads</code></p><p>•<code>Buy\_on\_Google\_listings</code></p><p>• <code>Free\_listings</code></p><p>如要将促销提交到一个或多个目标位置，请将每个目标位置的值分别作为单独的列提交。</p>                                                                                                                                                                                                                                                                                                                                                                     |

</details>

#### 将促销关联到特定商品

如果促销仅适用于部分商品，请在促销文件中将 `product_applicability` 设为 `specific_products` 。然后，将促销 ID 添加到商品目录中每件符合条件的商品，以便 impact.com 将其匹配。如果促销适用于所有商品，请使用 `all_products` 并跳过这些步骤。

1. 在促销文件中，为促销指定唯一的 `promotion_id`，例如： `103330482`.
2. 在 Google Merchant Center 商品目录中，添加一个 `promotion_id` 字段。
   * 如需了解 impact.com 支持的 Google Merchant Center 文件类型，请参阅 [商品目录文件格式](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/file-formats-for-product-catalogs.md) 。
3. 对于促销适用的每件商品，请输入相同的 `promotion_id` 值。
   * 这些值必须完全一致，包括大小写。
4. 上传更新后的商品目录和促销文件。
   * 如需帮助，请参阅 [添加商品目录](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md) 和 [上传促销文件](#upload-a-promotion-file).
   * 促销仅适用于商品目录中 `promotion_id` 与之匹配的商品。

{% hint style="info" %}
**示例：** “ *购买即可获赠马克杯* ”促销适用于咖啡豆和法压壶，但不适用于热水壶。为便于说明，此处省略了其他必需列。
{% endhint %}

促销文件：

| promotion\_id | product\_applicability | long\_title |
| ------------- | ---------------------- | ----------- |
| 103330482     | specific\_products     | 购买即可获赠马克杯   |

商品目录：

| id       | title    | promotion\_id |
| -------- | -------- | ------------- |
| SKU-1001 | 咖啡豆，1 千克 | 103330482     |
| SKU-1002 | 法式滤压壶    | 103330482     |
| SKU-1003 | 烧水壶      |               |

#### 排查错误和警告消息

<details>

<summary>查看错误和警告</summary>

在 *商品促销* 页面的 *状态* 列下，选择 *错误* 或 *警告* ，即可查看更多错误信息，例如错误类型或错误消息。有关促销文件 [管理商品促销文件](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) 的更多信息，请参阅该文档，了解促销文件的 *状态* 。

</details>

<details>

<summary>搜索和筛选错误</summary>

您可以点击文件中的 *错误* 和 *警告* ，并使用搜索框和筛选条件，查看已上传促销文件中的所有错误。

*错误类型* 筛选条件包括：

* 全部
* 警告
* 错误
* 复制

</details>

<details>

<summary>错误和警告消息</summary>

| 错误消息                    | 说明                    |
| ----------------------- | --------------------- |
| 缺少必填字段：{Required field} | 上传文件中缺少一个或多个必填字段。     |
| 因生效日期已过期而跳过的记录          | 促销的生效结束日期已过，因此跳过了该记录。 |

</details>


---

# 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-promotions/upload-product-promotion-files.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.
