> 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/promo-codes/bulk-upload-promo-codes.md).

# 批量上传促销代码

如果您想创建多个促销代码，请使用 **批量上传** 功能，上传包含促销代码数据的 CSV、XLS 或 XLSX 文件。

请参阅下方第 3 步中的 *促销代码批量上传参考表* ，了解如何构建此文件。为确保上传成功，请将 XLS/XLSX 文件大小控制在 1MB 以下，CSV 文件大小控制在 5MB 以下。验证严格依据文件大小进行，因此行数没有具体限制。

{% hint style="warning" %}
**警告：** 确保 CSV/XLS 文件中的列标题与下方列名完全一致（区分大小写和空格），否则文件可能会被拒绝上传。
{% endhint %}

{% hint style="info" %}
**示例：** 以下示例展示了一个示例促销代码 `10PEROFF`.

```programlisting
Promo Code,Program Id,Media Id,Type,Credit Rule,Match Mode,Deal Id,Active Start Date,Active End Date
10PEROFF,4321,1299679,TRACKING,ALWAYS,LI,,2026-10-01T00:00:00-07:00,2026-12-31T23:59:59-07:00
```

{% endhint %}

#### 批量上传跟踪促销代码

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/view-adv-promo-codes-flow.ihtml).
2. 在 *促销代码* 页面中，选择 **批量上传**.
3. 选择 **选择文件** 然后找到并选择包含要上传的促销代码的 Excel 或 CSV 文件。

{% hint style="success" %}
**注意：** 确保文件采用下表所示的必需列格式。
{% endhint %}

4. 选择 **下一步**.
5. 检查要上传的促销代码列表。如果详细信息正确，请选择 **接受并创建促销代码**.
6. 如果上传成功，新的 *跟踪促销代码* 将会创建，并显示在 *促销代码* 页面上。

| 列          | 类型  | 必填 | 说明                                                                                                                                                          |
| ---------- | --- | -- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 促销代码       | 字符串 | 是  | 要分配的唯一促销代码。                                                                                                                                                 |
| Program Id | 整数  | 是  | 促销代码所属的唯一 impact.com Program Id。                                                                                                                            |
| Media Id   | 整数  | 是  | <p>要分配促销代码的 impact.com Media Id。可以是 Partner Id 或 Media Source Id。</p><p>每个上传的跟踪促销码只能通过此字段分配给 1 个合作伙伴或媒体来源。如果其他合作伙伴推广该代码，impact.com 会将由此产生的转化标记为无效转化并撤销。</p> |
| 类型         | 字符串 | 是  | <p>促销码类型。允许的值：</p><p><code>TRACKING</code></p>                                                                                                              |
| 归因规则       | 字符串 | 是  | <p>促销码归因规则。允许的值：</p><p><code>ALWAYS</code></p><p><code>INVOLVED</code></p><p><code>WINNER</code></p>                                                        |
| 匹配模式       | 字符串 | 是  | <p>促销码匹配模式。允许的值：</p><p><code>LI</code> （精确/字面匹配）</p><p><code>RE</code> （正则表达式）</p>                                                                          |
| 优惠活动 ID    | 整数  | 否  | 此促销码应关联的优惠活动唯一 ID。该优惠活动必须已存在于您的项目中。                                                                                                                         |
| 生效开始日期     | 日期  | 是  | 可用于安排此促销码的可用时间。这是一个 [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) 日期。示例格式： `2013-06-30T00:00:00-07:00`                                                  |
| 生效结束日期     | 日期  | 是  | 这是一个 ISO8601 日期。示例格式： `2013-06-30T00:00:00-07:00`                                                                                                           |
| 时区         | 字符串 | 否  | 时区根据开始日期推断；如果要指定其他时区，请在此处输入完整名称，例如： `America/New_York`.                                                                                                     |


---

# 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/promo-codes/bulk-upload-promo-codes.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.
