> 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 %} ## 准备你的文件 1. 将此模板文件复制或下载到你的设备： {% code overflow="wrap" %} ``` 活动名称,供应商 ID,内部活动 ID,资金,资格类型,合作伙伴 ID,合作伙伴组 ID,预算,强制预算,草稿,开始日期,结束日期,事件类型 ID,支付类型,支付金额,优先级,规则 冬季靴子促销,,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. 用你自己的活动详情替换示例行，并为你要创建的每个活动填写一行。 * 请将你的值与 [文件格式参考](#file-format-reference) 下方内容进行对照，确保你输入的数据正确且格式符合要求。 * 要向单个活动添加多个支付组规则，请参阅 [支付组部分](#add-multiple-payout-groups) 如下。 3. 将文件中的编辑内容保存为合适的名称，例如 `Product_Boost_Bulk_Upload`。请确保文件保存为 `.csv` 或 `.xlsx` 格式。 {% 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) **\[Engage]** → **活动管理器** → [**Product Boost**](https://app.impact.com/secure/advertiser/engage/campaigns/manage-rate-boost-campaigns-flow.ihtml?execution=e3s1#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) 下方指导来处理这些错误。 * 当所有行都没有错误并且第一列显示 *确定* 时，你的活动就可以创建了。
{% endstep %} {% step %} ## 批准创建活动 1. 选择 **接受并创建活动**. * 你上传的新活动将显示在你的活动列表中。 2. 接下来，了解每种 Product Boost 活动状态的含义，以及如何 [管理它们](/brand/zh/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/manage-product-boost-campaigns.md). {% endstep %} {% endstepper %} ## 参考资料
文件格式参考 在将文件中的占位数据替换为你自己的活动详情时，请将此参考作为指南。 | 列名 | 类型 | 必填 | 说明 | | -------- | --------- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 活动名称 | 字符串 | 是 | 活动的名称 | | 供应商 ID | 整数 | 否 | 供应商的 ID（如果适用）。这可以从你的 [*我的供应商*](/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) 页面 | | 内部活动 ID | 字符串 | 否 | 此活动的你自己的可选标识符 | | 资金 | 字符串 | 否 | 活动的资金详情 | | 资格类型 | 字符串 | 是 | 识别将自动雇用的符合资格的合作伙伴。对于组或特定合作伙伴，请添加 ID 并用逗号分隔。允许的值： `JOINED_PARTNERS`, `PARTNER_GROUPS`, `INDIVIDUAL_PARTNERS` | | 合作伙伴 ID | CSV 字符串 | 否 | 以逗号分隔的合作伙伴 ID。当资格类型为 `INDIVIDUAL_PARTNERS`. | | 合作伙伴组 ID | CSV 字符串 | 否 | 以逗号分隔的合作伙伴组 ID。当资格类型为 `PARTNER_GROUPS`. | | 预算 | 十进制数(8,2) | 是 | 活动总预算 | | 强制预算 | 布尔值 | 否 | 如果不想强制执行，请留空。可接受的值： `是`, `true` （当预算全部花完时自动结束活动）或 `no`, `false` （不强制执行）。 | | 草稿 | 布尔值 | 是 | 是否将活动保存为草稿。可接受的值： `是`, `true` （保存为草稿）或 `no`, `false` （立即生效）。 | | 开始日期 | 日期 | 是 | ISO8601 日期。示例： `2013-06-30T00:00:00-07:00` | | 结束日期 | 日期 | 是 | ISO8601 日期。示例： `2013-06-30T00:00:00-07:00` | | 事件类型 ID | 整数 | 是 | 此活动主要支付跟踪器的数值事件类型 ID。 | | 支付类型 | 字符串 | 是 | 此事件的支付类型（例如 `PERCENTAGE` 或 `FIXED`). | | 支付金额 | 十进制数(8,2) | 是 | 此事件类型的支付金额。必须大于零。 | | 优先级 | 整数 | 是 | 活动优先级从 1（最高）到 10（最低）。 | | 规则 | 字符串 | 是 | 一条符合资格条件，格式为 `[VARIABLE] [OPERATOR] [VALUE]` 例如： `ITEM_SKU IS HYD-2000`。了解如何 [设置支付组规则](/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md). |
验证错误参考 如果你上传的数据包含验证错误，请在下方找到错误消息，查看最可能的原因以及修复方法。 | 错误消息 | 如何修复 | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 限时开始日期无效 | 请检查你的 `开始日期` 有值，且早于 `结束日期`，并且采用 ISO8601 格式（例如 `2026-08-01T00:00:00-07:00`). | | 限时结束日期无效 | 请检查你的 `结束日期` 有值，且晚于 `开始日期`，并且采用 ISO8601 格式（例如， `2026-08-30T00:00:00-07:00`). | | 必须填写草稿 | Enter `是`/`true` 或 `no`/`false` 在 `草稿` 列，以指示活动应保存为草稿还是立即生效。 | | 必须填写资格类型 | 在 `资格类型` 列中输入三个可接受值之一： `JOINED_PARTNERS`, `PARTNER_GROUPS`，或 `INDIVIDUAL_PARTNERS`. | | 必须填写优先级 | 在 `优先级` 列。 | | 开始日期不能是过去日期 | 更新 `开始日期` 设置为未来日期，格式为 ISO8601（例如， `2026-08-01T00:00:00-07:00`). | | 事件类型 ID 不属于此项目 | 该 `事件类型 ID` 你输入的值与实际链接到你的项目的任何事件类型都不匹配。了解如何 [查找你的事件类型 ID](/brand/zh/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md). | | 规则列包含无效的规则表达式。请使用格式 \[Variable Operator Value]，并用 AND 连接多个规则。 |

每行使用一个条件，格式为 变量 运算符 值 例如： ITEM\_SKU IS HYD-2000.

不要使用括号或 AND。另外还要检查 值 是否存在于你的产品目录中。参见 添加多个支付组规则 以了解更多信息。

|
## 添加多个支付组规则 你可以添加多个 [支付组规则](/brand/zh/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md) 到单个活动中，只需在活动行之后添加一条 *续行* 到你的文件中。在续行中，将 *活动名称* 留空。这就是你的文件上传在验证期间的显示方式：
重复相同的 `事件类型 ID` 作为主行可让系统将你的续行读取为同一事件类型的附加支付规则。要了解续行需要填写哪些列，请参阅下方参考。
支付规则行指南 为活动添加多个支付组规则时，请将这些指南应用于任何续行。 | 列名 | 类型 | 必填 | 说明 | | ------- | --------- | -- | ------------------------------------------------------------------------------------------------------- | | 活动名称 | 字符串 | 否 | 留空，以将其标记为附加到上方所定义活动的续行。 | | 事件类型 ID | 整数 | 是 | 此支付组的事件类型 ID。 | | 支付类型 | 字符串 | 是 | 此附加事件类型的支付类型（例如 `PERCENTAGE` 或 `FIXED`). | | 支付金额 | 十进制数(8,2) | 是 | 此附加事件类型的支付金额。必须大于零。 | | 规则 | 字符串 | 是 | 一条符合资格条件，格式为 `变量 运算符 值` — 例如， `ITEM_SKU IS HYD-2000`。参见 [验证错误参考](#validation-error-reference) 如果它未通过验证。 |
{% hint style="success" %} **注意：** 单个活动也可以跟踪多个事件类型。在续行中，输入一个不同的 `事件类型 ID` 而不是重复主行中的值。要了解续行需要填写哪些列，请参阅上方参考。 {% endhint %} ### 带有续行的示例文件 {% code overflow="wrap" %} ``` 活动名称,供应商 ID,内部活动 ID,资金,资格类型,合作伙伴 ID,合作伙伴组 ID,预算,强制预算,草稿,开始日期,结束日期,事件类型 ID,支付类型,支付金额,优先级,规则 冬季靴子促销,,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 ,,,,,,,,,,,,17897,FIXED,3.00,,ITEM_SKU IS BOOT456 ``` {% endcode %} --- # 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/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md?ask=&goal= ``` `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.