> 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" %} ``` 活动名称,方法,活动 ID,供应商 ID,内部活动 ID,资金来源,资格类型,合作伙伴 ID,合作伙伴组 ID,预算,强制预算,草稿,开始日期,结束日期,事件类型 ID,结算类型,结算值,优先级,规则 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. 用您自己的活动详情替换示例行，并为每个要创建的活动填写一行。 * 确保 *活动 ID* 字段为空，因为系统会为每个新活动自动分配一个。 * 要向单个活动添加多个结算组规则，请参阅 [批量上传多个 Product Boost 结算规则](/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" %} ``` 活动名称,方法,活动 ID,供应商 ID,内部活动 ID,资金来源,资格类型,合作伙伴 ID,合作伙伴组 ID,预算,强制预算,草稿,开始日期,结束日期,事件类型 ID,结算类型,结算值,优先级,规则 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. 用活动的新详情替换示例行，并为每个要编辑的活动填写一行。 * 确保 *方法* 字段表示您正尝试 *修改* 一个活动。 * 确保 *活动 ID* 字段表示您要编辑的是哪个活动。 * 活动的结算组只能作为一个完整集合进行替换。要向单个活动添加多个结算组规则，请参阅 [批量上传多个 Product Boost 结算规则](/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 %} 也可以在单个文件上传中创建新活动并修改现有活动。您在每一行的 *方法* 字段值将指示您是在创建活动还是在编辑现有活动。 {% 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) **\[Engage]** → **活动管理** → [**Product Boost**](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) 以了解如何处理每个错误的指导。 * 当所有行都没有问题并在第一列显示 *确定* 时，您的活动即可等待批准。
{% 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否整数供应商的 ID（如适用）。可从您的 我的供应商 页面获取。
内部活动 ID否字符串您为此活动自定义的可选标识符。
资金来源否字符串该活动的资金详情。
资格类型是字符串指定将自动被招募的符合资格的合作伙伴。对于组或特定合作伙伴，请添加其 ID 并用逗号分隔。允许的值： JOINED_PARTNERS, PARTNER_GROUPS, INDIVIDUAL_PARTNERS
合作伙伴 ID否CSV 字符串以逗号分隔的合作伙伴 ID。以下情况必填：资格类型为 INDIVIDUAL_PARTNERS.
合作伙伴组 ID否CSV 字符串以逗号分隔的合作伙伴组 ID。以下情况必填：资格类型为 PARTNER_GROUPS.
预算是Decimal(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).
结算值是Decimal(8,2)此事件类型的结算金额。必须大于零。
优先级是整数活动优先级从 1（最高）到 10（最低）。
规则是字符串
可修改字段参考 对于活动修改，请注意以下事项： * 只填写您想更改的字段；空白字段将保留当前值。 * 修改活动规则时，所有现有规则和事件类型都会被上传文件替换。 * 活动状态会限制可应用的修改。已完成的活动无法修改，且活跃活动无法恢复为草稿状态。
列名可修改？说明
活动名称是输入活动的新名称。
方法否，但必填回车 修改 以表明您要编辑现有活动。
活动 ID否，但必填使用此字段指明您要修改哪个现有活动。
供应商 ID仅在活动上线前如适用，请输入您的 我的供应商 页面中的供应商新 ID。活动上线后不能更改供应商；对于正式由供应商资助的活动，则完全不能更改供应商。
内部活动 ID是输入您为此活动设定的新标识符。
资金来源是输入活动的新资金详情。
资格类型是指明新的、将自动被招募的符合资格合作伙伴。允许的值： JOINED_PARTNERS, PARTNER_GROUPS, INDIVIDUAL_PARTNERS
合作伙伴 ID仅当资格类型为指明任何新的符合资格合作伙伴的 ID。以下情况必填：资格类型 = INDIVIDUAL_PARTNERS.
合作伙伴组 ID仅当资格类型为指明任何新的符合资格合作伙伴组的 ID。以下情况必填：资格类型 = PARTNER_GROUPS.
预算是输入活动的新总预算。
强制预算是回车 是 / true （当预算完全花完时自动结束活动）或 no / false （不强制）。如果不想强制，请留空。
草稿否留空。
开始日期仅在未开始时以 ISO8601 格式输入新的开始日期。示例： 2013-06-30T00:00:00-07:00
结束日期仅在未结束时以 ISO8601 格式输入新的结束日期。示例： 2013-06-30T00:00:00-07:00
事件类型 ID仅与续行一起使用请参阅 批量上传多个 Product Boost 结算规则.
结算类型仅与续行一起使用请参阅 批量上传多个 Product Boost 结算规则.
结算值仅与续行一起使用请参阅 批量上传多个 Product Boost 结算规则.
优先级仅与续行一起使用请参阅 批量上传多个 Product Boost 结算规则.
规则是
  • 回车 一 资格条件，格式为 [变量 运算符 值] 例如， [ITEM_SKU IS HYD-2000]，或了解如何 设置结算规则.
  • 要向单个活动添加多个结算规则，请按照以下流程操作： 批量上传多个 Product Boost 结算规则.
  • 修改此字段将清除并替换该活动的任何现有规则和事件类型。

风险： 您未包含在修改文件中的任何现有规则或事件类型都可能被删除。如果活动有多个事件类型，请将您想保留的每一种添加为一条 续行.

有关字段格式和允许值，请使用上面的 [文件格式参考](#file-format-reference) 上述内容。
验证错误参考 如果您上传的数据包含验证错误，请在下方找到错误信息，以查看可能的原因及修复方法。 | 错误信息 | 如何修复 | | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 限时开始日期无效 | 请检查您的 `开始日期` 有值，早于 `结束日期`，并采用 ISO8601 格式（例如 `2026-08-01T00:00:00-07:00`). | | 限时结束日期无效 | 请检查您的 `结束日期` 有值，晚于 `开始日期`，并采用 ISO8601 格式（例如， `2026-08-30T00:00:00-07:00`). | | 草稿为必填项 | 回车 `是`/`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). | | 规则列包含无效的规则表达式。请使用格式 \[变量 运算符 值]，并使用 AND 串联多个规则。 | | | 当方法为修改时，必须填写活动 ID | 将 `活动 ID` 您要编辑的活动的 `修改` 行中。 | | 活动 ID 不存在于此项目中 | 请检查 `活动 ID` 是否与您项目中现有的 Product Boost 活动相匹配。 | | 此文件中有重复的活动 ID | 每个活动在每个文件中只能出现一次。请将该活动的更改合并到一条 `修改` 行中。 | | 当活动处于已完成状态时，无法编辑 \[字段]。 | 移除 `修改` 已完成活动的行，或使用 `方法` = `添加`. | | 一个或多个合作伙伴组 ID 不属于此项目。 | 请检查 `合作伙伴组 ID` 中的每个 ID 是否与 [合作伙伴组](/brand/zh/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-groups/create-and-manage-partner-groups.md) 您项目中的内容相匹配。 | | 当资格类型为时，必须填写合作伙伴组 ID `PARTNER_GROUPS` | 请在 `合作伙伴组 ID` 列中添加一个或多个合作伙伴组 ID，并用逗号分隔，或者更改 `资格类型` 进行 `JOINED_PARTNERS` 或 `INDIVIDUAL_PARTNERS`. | | 合作伙伴组 ID 必须是由整数构成的逗号分隔列表。 | 仅在 `合作伙伴组 ID`中输入整数，并用逗号分隔——例如， `1024,1099,2001`。删除任何空格、字母、小数或其他字符。 | | 活动开始后，开始日期无法编辑。 | 该 `开始日期` 活跃活动的 `开始日期` 在 `修改` 行留空以保留当前值，或仅编辑尚未开始的活动。 | | 只有在活动处于草稿状态时，才能更改 \[字段]。 | 活动一旦生效，此字段即锁定。请留空以保留当前值，或使用 `方法` = `添加`. | | 供应商 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-3-connect-with-vendors) ，然后才能通过其为活动提供资金。 | | 点击事件类型不支持 Product Boost 活动。 | 输入一个 `事件类型 ID` ，用于非点击事件类型（例如销售）。了解如何 [查找您的事件类型 ID](/brand/zh/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md). |
--- # 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=&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.