> 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/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md).

# 批量上传产品提升活动

您可以使用批量上传工具一次创建或修改多个 Product Boost 活动，而不必逐个操作。您可以使用 CSV 或 Excel 文件提供相关字段的详细信息，而这些字段原本需要您手动填写。

{% stepper %}
{% step %}

## 准备文件

{% tabs %}
{% tab title="批量创建活动" %}

1. 将此模板文件复制到您的设备：

{% code overflow="wrap" %}

```
Campaign Name,Method,Campaign ID,Vendor ID,Internal Campaign ID,Funding,Eligibility Type,Partner IDs,Partner Group IDs,Budget,Enforced Budget,Draft,Start Date,End Date,Event Type ID,Payout Type,Payout Value,Precedence,Rules
Winter Boot Promo,Add,,,EXAMPLE-001,,JOINED_PARTNERS,,,1000.00,no,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,[ITEM_SKU IS BOOT123]
```

{% endcode %}

2. 用您自己的活动详细信息替换示例行，并为要创建的每个活动填写一行。
   * 确保 *Campaign ID* 字段为空，因为系统会为每个新活动自动分配一个 ID。
   * 如需为单个活动添加多条付款组规则，请参阅 [批量上传多条 Product Boost 付款规则](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md).
3. 请对照下方的 [文件格式参考](#file-format-reference) 检查字段，确保输入的数据正确且符合所需格式。
4. 以合适的名称保存编辑后的文件，例如： `Product_Boost_Bulk_Create`。确保文件以 `.csv` 或 `.xlsx` 格式保存。
   {% endtab %}

{% tab title="批量编辑活动" %}

1. 将此模板文件复制到您的设备：

{% code overflow="wrap" %}

```
Campaign Name,Method,Campaign ID,Vendor ID,Internal Campaign ID,Funding,Eligibility Type,Partner IDs,Partner Group IDs,Budget,Enforced Budget,Draft,Start Date,End Date,Event Type ID,Payout Type,Payout Value,Precedence,Rules
Summer Sandal Promo,Modify,1234,,EXAMPLE-002,,PARTNER_GROUPS,,,1234.00,yes,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,[ITEM_SKU IS BOOT123]
```

{% endcode %}

2. 用活动的新详细信息替换示例行，并为要编辑的每个活动填写一行。
   * 确保 *Method* 字段表明您要 *修改* 活动。
   * 确保 *Campaign ID* 字段指明您要编辑的活动。
   * 活动的付款组只能作为完整集合替换。如需为单个活动添加多条付款组规则，请参阅 [批量上传多条 Product Boost 付款规则](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md).
3. 请对照下方的 [可修改字段参考](#modifiable-fields-reference) 检查字段，确保只编辑受支持的字段，并使用所需格式。
4. 以合适的名称保存编辑后的文件，例如： `Product_Boost_Bulk_Edit`。确保文件以 `.csv` 或 `.xlsx` 格式保存。
   {% endtab %}
   {% endtabs %}

您也可以在同一个文件中创建新活动并修改现有活动。每行中 *Method* 字段的值会指明您要创建活动还是编辑现有活动。

{% hint style="success" %}
**注意：** 上传文件最多只能包含 1,000 行。
{% 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) **\[营销互动]** → **营销活动管理器** → [**商品推广**](https://app.impact.com/secure/advertiser/engage/campaigns/manage-rate-boost-campaigns-flow.ihtml#sortBy=dateOfEntry\&sortOrder=ASC).
2. 在屏幕右上角，选择 **批量上传**.
3. 选择 **选择文件** ，或将您准备上传的文件拖放到此处。
4. 选择 **下一步**.
   {% endstep %}

{% step %}

## 检查验证错误

1. 检查上传的数据是否存在错误。
   * 验证失败的内容会以红色突出显示，错误会列在第一列中，供您处理。
   * 每行代表一个营销活动。若要筛选出已通过验证的行，请选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[复选框] 仅显示错误**.
2. 如果文件中有错误，请选择 **返回** 以返回上传步骤。请参阅下方的 [验证错误参考](#validation-error-reference) ，了解如何处理各项错误。
   * 所有行均无错误，且第一列显示 *正常* 后，即可批准您的营销活动。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F4oJ2tv4RiFlATHGkCSPL%2FScreenshot_2026-07-23_at_10_04_30%E2%80%AFAM.png?alt=media&amp;token=d21d2c4e-1dfe-423c-943d-4aad68135dd6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

## 批准您的上传内容

1. 选择 **接受**.
   * 您上传的新营销活动将显示在营销活动列表中。
2. 接下来，了解商品推广营销活动的各项状态含义，以及如何 [管理](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/manage-product-boost-campaigns.md).
   {% endstep %}
   {% endstepper %}

## 参考资料

更新文件中的占位行并填写您自己的营销活动详情时，请参考以下内容。

<details>

<summary>文件格式参考</summary>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>列名称</th><th>必填</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td>营销活动名称</td><td>是</td><td>字符串</td><td>营销活动的名称。</td></tr><tr><td>方法</td><td>否</td><td>字符串</td><td>选择 <code>Add</code> 新建营销活动，或 <code>Modify</code> 现有营销活动。留空时，默认使用 <code>Add</code>.</td></tr><tr><td>营销活动 ID</td><td>否</td><td>整数</td><td>系统分配给营销活动的标识符。创建营销活动时，请将此字段留空。</td></tr><tr><td>供应商 ID</td><td>否</td><td>整数</td><td>供应商的 ID（如适用）。您可以在 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-2-view-your-listed-vendors"><em>我的供应商</em></a> 页面中获取此 ID。</td></tr><tr><td>内部营销活动 ID</td><td>否</td><td>字符串</td><td>您为此营销活动设置的可选自定义标识符。</td></tr><tr><td>资金</td><td>否</td><td>字符串</td><td>此活动的资金详情。</td></tr><tr><td>资格类型</td><td>是</td><td>字符串</td><td>指定将自动加入的符合资格的合作伙伴。对于群组或特定合作伙伴，请添加 ID 并以逗号分隔。允许的值： <code>JOINED_PARTNERS</code>, <code>PARTNER_GROUPS</code>, <code>INDIVIDUAL_PARTNERS</code></td></tr><tr><td>合作伙伴 ID</td><td>否</td><td>CSV 字符串</td><td>以逗号分隔的合作伙伴 ID。当资格类型为 <code>INDIVIDUAL_PARTNERS</code>.</td></tr><tr><td>合作伙伴群组 ID</td><td>否</td><td>CSV 字符串</td><td>以逗号分隔的合作伙伴群组 ID。当资格类型为 <code>PARTNER_GROUPS</code>.</td></tr><tr><td>预算</td><td>是</td><td>Decimal(8,2)</td><td>活动的总预算。</td></tr><tr><td>强制执行预算</td><td>否</td><td>布尔值</td><td>可接受的值： <code>yes</code>, <code>true</code> （预算全部用完时自动结束活动），或 <code>no</code>, <code>false</code> （不强制执行）。如果不需要强制执行，请留空。</td></tr><tr><td>草稿</td><td>是</td><td>布尔值</td><td>是否将活动保存为草稿。可接受的值： <code>yes</code>, <code>true</code> （保存为草稿），或 <code>no</code>, <code>false</code> （立即启用）。</td></tr><tr><td>开始日期</td><td>是</td><td>日期</td><td>活动开始日期，采用 ISO8601 格式。示例： <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>结束日期</td><td>是</td><td>日期</td><td>活动结束日期，采用 ISO8601 格式。示例： <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>事件类型 ID</td><td>是</td><td>整数</td><td>此活动主要付款跟踪器的数字事件类型 ID。</td></tr><tr><td>付款类型</td><td>是</td><td>字符串</td><td>此事件的付款类型（即 <code>PERCENTAGE</code> 或 <code>FIXED</code>).</td></tr><tr><td>付款值</td><td>是</td><td>Decimal(8,2)</td><td>此事件类型的付款金额。必须大于零。</td></tr><tr><td>优先级</td><td>是</td><td>整数</td><td>活动优先级，1（最高）至 10（最低）。</td></tr><tr><td>规则</td><td>是</td><td>字符串</td><td><ul><li><strong>一个</strong> 资格条件，格式为 <code>[VARIABLE OPERATOR VALUE]</code> 例如， <code>[ITEM_SKU IS HYD-2000]</code>。了解如何 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md">设置收益分配规则</a>.</li><li>要为单个营销活动添加多条收益分配规则，请按照以下流程操作： <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">批量上传多条商品推广收益分配规则</a>.</li></ul></td></tr></tbody></table>

</details>

<details>

<summary>可修改字段参考</summary>

修改营销活动时，请注意以下事项：

* 只填写需要更改的字段；留空的字段将保持当前值。
* 修改营销活动规则时，上传文件会替换所有现有规则和事件类型。
* 营销活动的状态会限制可生效的修改。已完成的营销活动无法修改，且无法将进行中的营销活动恢复为草稿状态。

<table data-header-hidden="false" data-header-sticky><thead><tr><th>列名称</th><th>可修改？</th><th>说明</th></tr></thead><tbody><tr><td>营销活动名称</td><td>是</td><td>输入营销活动的新名称。</td></tr><tr><td>方法</td><td>否，但必填</td><td>输入 <code>Modify</code> 以表示您要编辑现有营销活动。</td></tr><tr><td>营销活动 ID</td><td>否，但必填</td><td>使用此字段指定您要修改的现有营销活动。</td></tr><tr><td>供应商 ID</td><td>仅限营销活动开始前</td><td>如果符合条件，请输入来自您的 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-2-view-your-listed-vendors"><em>我的供应商</em></a> 页面的新供应商 ID。营销活动开始后，无法更改供应商；对于正式由供应商出资的营销活动，则完全无法更改供应商。</td></tr><tr><td>内部营销活动 ID</td><td>是</td><td>输入您为此营销活动指定的新标识符。</td></tr><tr><td>资金</td><td>是</td><td>输入营销活动的新资助详情。</td></tr><tr><td>资格类型</td><td>是</td><td>指定将自动受聘的新符合条件的合作伙伴。允许的值： <code>JOINED_PARTNERS</code>, <code>PARTNER_GROUPS</code>, <code>INDIVIDUAL_PARTNERS</code></td></tr><tr><td>合作伙伴 ID</td><td>仅适用于以下资格类型</td><td>指定任何新符合条件的合作伙伴 ID。资格类型为以下值时必填： <code>INDIVIDUAL_PARTNERS</code>.</td></tr><tr><td>合作伙伴群组 ID</td><td>仅适用于以下资格类型</td><td>指定任何新符合条件的合作伙伴组 ID。资格类型为以下值时必填： <code>PARTNER_GROUPS</code>.</td></tr><tr><td>预算</td><td>是</td><td>输入营销活动的新总预算。</td></tr><tr><td>强制执行预算</td><td>是</td><td>输入 <code>yes</code> / <code>true</code> （预算全部用完时自动结束营销活动）或 <code>no</code> / <code>false</code> （不强制执行）。如果不需要强制执行，请留空。</td></tr><tr><td>草稿</td><td>否</td><td>留空。</td></tr><tr><td>开始日期</td><td>仅限尚未开始时</td><td>输入新的开始日期，格式为 ISO8601。例如： <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>结束日期</td><td>仅限尚未结束时</td><td>输入新的结束日期，格式为 ISO8601。例如： <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>事件类型 ID</td><td>仅限续行</td><td>请参阅 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">批量上传多条商品推广奖励规则</a>.</td></tr><tr><td>付款类型</td><td>仅限续行</td><td>请参阅 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">批量上传多条商品推广奖励规则</a>.</td></tr><tr><td>付款值</td><td>仅限续行</td><td>请参阅 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">批量上传多条商品推广奖励规则</a>.</td></tr><tr><td>优先级</td><td>仅限续行</td><td>请参阅 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">批量上传多条商品推广奖励规则</a>.</td></tr><tr><td>规则</td><td>是</td><td><ul><li>输入 <strong>一个</strong> 符合条件的条件，格式为 <code>[VARIABLE OPERATOR VALUE]</code> 例如， <code>[ITEM_SKU IS HYD-2000]</code>，或了解如何 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md">设置奖励规则</a>.</li><li>要为单个营销活动添加多条收益分配规则，请按照以下流程操作： <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">批量上传多条商品推广收益分配规则</a>.</li><li>修改此字段将清除并替换此营销活动的所有现有规则和事件类型。</li></ul><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>风险：</strong> 您未在修改文件中包含的任何现有规则或事件类型都可能被删除。如果营销活动包含多个事件类型，请将每个要保留的事件类型都添加为 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">续行</a>.</p></div></td></tr></tbody></table>

有关字段格式和允许值，请参阅上方的 [文件格式参考](#file-format-reference) 。

</details>

<details>

<summary>验证错误参考</summary>

如果上传的数据包含验证错误，请在下方找到相应的错误消息，了解可能的原因及解决方法。

| 错误消息                                                 | 解决方法                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 限时开始日期无效                                             | 请检查您的 `Start Date` 是否有值、是否早于 `End Date`，以及是否采用 ISO8601 格式（例如， `2026-08-01T00:00:00-07:00`).                                                                                                                                                                                                                                                  |
| 限时结束日期无效                                             | 请检查您的 `End Date` 是否有值、是否晚于 `Start Date`，以及是否采用 ISO8601 格式（例如， `2026-08-30T00:00:00-07:00`).                                                                                                                                                                                                                                                  |
| 必须指定草稿状态                                             | 在 `yes`/`true` 或 `no`/`false` 中输入 `Draft` 列，以指明该营销活动应保存为草稿还是立即启用。                                                                                                                                                                                                                                                                            |
| 必须指定符合条件的类型                                          | 在 `Eligibility Type` 列中输入三个允许值之一： `JOINED_PARTNERS`, `PARTNER_GROUPS`，或 `INDIVIDUAL_PARTNERS`.                                                                                                                                                                                                                                               |
| 必须填写优先级                                              | 在 `Precedence` 列中输入 1（最高优先级）到 10（最低优先级）之间的整数。                                                                                                                                                                                                                                                                                                |
| 开始日期不能是过去的日期                                         | 将 `Start Date` 更新为未来的日期，并采用 ISO8601 格式（例如， `2026-08-01T00:00:00-07:00`).                                                                                                                                                                                                                                                                     |
| 事件类型 ID 不属于此计划                                       | 您输入的 `Event Type ID` 与任何实际关联到您计划的事件类型都不匹配。了解如何 [查找事件类型 ID](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md).                                                                                                                                            |
| Rules 列包含无效的规则表达式。请使用 \[变量 运算符 值] 格式；多个规则之间用 AND 连接。 | <ul><li>每行使用一个条件，格式如下： <code>\[VARIABLE OPERATOR VALUE]</code> 例如： <code>\[ITEM\_SKU IS HYD-2000]</code>.</li><li>详情请参阅 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">批量上传多个产品加推奖励规则</a> 。</li></ul> |
| 当 Method 为 Modify 时，必须填写 Campaign ID                 | 在每个 `Campaign ID` 中添加您要编辑的营销活动的 `Modify` 行。                                                                                                                                                                                                                                                                                                  |
| 此计划中不存在该 Campaign ID                                 | 请检查 `Campaign ID` 是否与您计划中现有的产品加推营销活动匹配。                                                                                                                                                                                                                                                                                                      |
| 此文件中存在重复的 Campaign ID                                | 每个营销活动在每个文件中只能出现一次。请将该营销活动的所有更改合并到同一个 `Modify` 行中。                                                                                                                                                                                                                                                                                           |
| 当营销活动处于 Completed 状态时，无法编辑 \[Field]。                 | 请移除已完成营销活动对应的 `Modify` 行，或使用 `Method` = `Add`.                                                                                                                                                                                                                                                                                               |
| 一个或多个 Partner Group ID 不属于此计划。                       | 请检查 `Partner Group IDs` 中的每个 ID 是否与一个 [合作伙伴群组](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-groups/create-and-manage-partner-groups.md) 在您的程序中。                                                                                                                       |
| 当资格类型为 `PARTNER_GROUPS`                              | 时，必须填写合作伙伴群组 ID。在 `Partner Group IDs` 列中添加一个或多个合作伙伴群组 ID，并以逗号分隔；或者将 `Eligibility Type` 更改为 `JOINED_PARTNERS` 或 `INDIVIDUAL_PARTNERS`.                                                                                                                                                                                                        |
| 合作伙伴群组 ID 必须是以逗号分隔的整数列表。                             | 在 `Partner Group IDs`中仅输入整数，并以逗号分隔，例如 `1024,1099,2001`。请删除所有空格、字母、小数或其他字符。                                                                                                                                                                                                                                                                   |
| 营销活动开始后，无法再编辑开始日期。                                   | 已启动的营销活动的 `Start Date` 已锁定。在 `Start Date` Modify `行中留空` 以保留当前值，或仅编辑尚未开始的营销活动。                                                                                                                                                                                                                                                                |
| 只有在营销活动处于草稿状态时，才能更改 \[Field]。                        | 营销活动启动后，此字段将被锁定。留空以保留当前值，或创建一个新的营销活动并设置 `Method` = `。`.                                                                                                                                                                                                                                                                                      |
| 供应商 ID 不存在，或未与此程序关联。                                 | 请确认 `Vendor ID` 与您 *我的供应商* 页面上列出的供应商相符。如果列表中没有该供应商，您需要先 [与其建立连接](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-3-connect-with-vendors) 才能通过该供应商为营销活动注资。                                                        |
| 产品推广营销活动不支持点击事件类型。                                   | 请输入非点击事件类型（例如销售）的 `Event Type ID` 。了解如何 [查找事件类型 ID](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md).                                                                                                                                                   |

</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/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.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.
