> 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" %}
**重要：** 在开始之前，您需要拥有一个有效的商品目录。有关创建您的首个商品上传的帮助，请参见 [添加商品目录](/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### 上传促销文件

{% 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] → 内容 → 商品 → 商品促销**.
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 字段参考*](#para-idm73509110741608) 下方了解有关这些字段的更多信息。
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] → 内容 → 商品 → 商品促销**.
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 字段参考*](#para-idm73509110741608) 下方了解有关这些字段的更多信息。
6. 输入 **名称** 您的文件位于 *上传文件名称*.
   * [查看此模板](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) ，以便在上传促销时获得指导。
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 为数字格式，不应包含空格或符号，例如， `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 适用性 `[product_applicability]`    | 是   | 此属性指定该促销适用于所有商品还是仅适用于特定商品。 | <p>支持的值：</p><p>• <code>all\_products</code></p><p>• <code>specific\_products</code></p><p><strong>注意：</strong> impact.com 只能将您的 <a href="https://support.google.com/merchants/answer/2906014?hl=en">Google 促销 feed 文件</a> 与您的 <a href="/brand/zh/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">产品目录</a> 如果您的商品 feed 包含 <code>promotion\_id</code>。换句话说，如果您的商品 feed 不包含促销 ID，您就不能拥有 <code>specific\_products</code> 值。</p> |
| 说明 `[long_title]`                | 是   | 每个促销的完整标题。                 | 标题的最大长度为 60 个字符。例如， `购买即送免费马克杯`.                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 生效 `[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>线上</code></p><p>• <code>门店内</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>

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

<details>

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

在……上 *产品促销* 页面，在 *健康* 列下，选择 *错误* 或 *警告* 以查看更多有关该错误的信息，例如错误类型或错误消息。参见 [管理您的商品促销文件](/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.