批量修改和撤销参考

在批量修改或冲销操作数据时，请先下载 impact.com 提供的模板文件之一，并将示例数据替换为你自己的数据。在添加你自己的数据时，请务必遵循相关参考表中的指南，以确保你提交的文件格式正确。提交文件准备就绪后，即可继续提交你的批量修改/冲销文件。

本文参考文章包含批量修改和冲销中最常用的字段。要查看包含字段说明的完整详细参考，请参阅 Action & Conversion 字段参考.

请参阅以下参考，以：

• 了解在 FTP/SMTP 批量修改或冲销中应使用哪些字段
• 下载带有占位示例数据的模板文件
• 了解应使用哪些原因代码以及何时使用

订单级修改

当你希望在订单级而非商品级批量更新操作数据时使用，例如，批量更改多个订单的金额。

可接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	当去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用时需要提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用时需要提供此标识符 OrderId/Oid.
金额	可选	可编辑	设置订单的新总金额。
currencyCode	可选	可编辑	设置该操作的收入货币。如果未提供，则默认为你的 impact.com 账户货币。
CustomerStatus	可选	可编辑	设置转化发生时客户的状态，例如 NEW / EXISTING。
备注	可选	可编辑	用于事件级报告的通用字段。如果原始转化中为空，提交值后会进行插入。每个操作仅接受一次——请在同一请求中提交任何其他字段更改。
LocationId	可选	可编辑	主要用于住宿场景，这是此转化中指定地点的唯一标识符。如果原始转化中为空，提交值后会进行插入。
LocationName	可选	可编辑	主要用于住宿场景，这是此转化中指定地点的名称。如果原始转化中为空，提交值后会进行插入。
GiftPurchase	可选	可编辑	设为 true 可将订单标记为礼品购买，设为 false 可取消标记。如果原始转化中为空，提交值后会进行插入。
Text1–Text50	可选	可编辑	通用文本字段，可接受你希望发送的任意文本数据字符串（Text1 到 Text50）。如果原始转化中为空，提交值后会进行插入。每个操作仅接受一次——请在同一请求中提交任何其他字段更改。
原因	必填	可编辑	请为此次修改提供有效的原因代码。

*至少必须提供一条标识符路径，即以下任一项 ActionId 或 （*OrderId/Oid *+ ActionTrackerId)

模板文件

• 订单级修改模板
• 订单级审批模板

订单级冲销

当你希望在订单级而非商品级批量冲销合作伙伴驱动的操作时使用，例如，批量冲销多个订单。

可接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	当去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用时需要提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用时需要提供此标识符 OrderId/Oid.
金额	有条件必填**	可编辑	设为 0 以冲销订单，除非原始金额 = 0**
原因	必填	可编辑	请为此次冲销提供有效的原因代码。

*至少必须提供一条标识符路径，即以下任一项 ActionId 或 (OrderId/Oid + ActionTrackerId)

**如果原始 金额 = 0，请保持 金额 不变，以避免被误判为修改。

模板文件

• 订单级冲销模板

商品级修改

当你希望在商品级而非订单级批量更新操作数据时使用，例如，批量更改订单中多个商品的金额。

可接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	当去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用时需要提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用时需要提供此标识符 OrderId/Oid.
SKU**	必填	不可编辑	请提供你要修改的商品的 SKU 值。
金额**	有条件必填	可编辑	设置新的商品金额，即 price*quantity。如果你修改了数量，此字段也需要同时修改。
数量**	可选	可编辑	设置订单中商品的新数量。
类别**	可选	可编辑	设置商品的类别。
原因**	必填	可编辑	请为此次冲销提供有效的原因代码。

*至少必须提供一条标识符路径，即以下任一项 ActionId 或 (OrderId/Oid + ActionTrackerId)

**你修改的每个商品都必须包含这些字段。标识符字段每个订单只包含一次。

模板文件

• 商品级修改模板
• 商品级审批模板

商品级冲销

当你希望在商品级而非订单级批量冲销操作数据时使用，例如，批量冲销订单中的多个商品。

可接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	当去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用时需要提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用时需要提供此标识符 OrderId/Oid.
SKU**	必填	不可编辑	请提供你要修改的商品的 SKU 值。
金额**	有条件必填	可编辑	设置新的商品金额，即 price*quantity。如果你修改了数量，此字段也需要同时修改。
数量**	可选	可编辑	设置订单中商品的新数量。
原因**	必填	可编辑	请为此次修改提供有效的原因代码。

*至少必须提供一条标识符路径，即以下任一项 ActionId 或 (OrderId/Oid + ActionTrackerId)

**你修改的每个商品都必须包含这些字段。标识符字段每个订单只包含一次。

模板文件

• 商品级冲销模板

在此示例中，SKU O7427540 出现两次，因为一行是在冲销（Amount=0），另一行是在修改（Amount=15）。

备注： 如果你预期会有重复的 OrderIds 并选择使用以下组合： OrderId + ActionTrackerId，impact.com 会默认将更新应用到最新的 ActionId 。如果你希望将更新应用到较旧的 ActionId ，请使用旧的 ActionId.

原因代码

每次修改或冲销操作数据时，你都必须提供原因。请使用下方相关的原因代码来说明该操作为什么需要更新。

警告： 传入不被接受的值将导致该条目不会被处理，并返回错误。如果你需要自定义原因代码，请联系你的 CSM 或 联系支持 以讨论处置代码.

代码	说明
CONS_FRAUD	消费者欺诈
CONS_ERROR	消费者错误
ITEM_RETURNED	商品已退回
APPROVED	操作已批准 注意： 如果您正在尝试批准操作， 批准 需要设置为 自定义处理代码.
ORDER_ERROR	订单错误
ORDER_UPDATE	订单已更新
PUB_ACT_DISPUTE	合作伙伴活动争议
ADV_ACT_DISPUTE	品牌活动争议
NOT_COMPLIANCE_TERMS	不符合条款
ITEM_OUT_OF_STOCK	商品缺货
TEST_ACTION	测试操作
PARTNER_NOT_ACTIVE	合作伙伴账户已停用
CREDITED_DIFFERENT_MP	已记入另一位合作伙伴
其他	其他原因