通过 API 批量修改或撤销

参加 PXA 课程

如果某个操作的任何内容发生变化（例如，订单被取消、商品被退回等），你可以使用 API 来修改（或撤销）它，并更改该操作的佣金金额。

哪种提交方式适合你？

如果你想要……	使用此方法……
无需编码，手动提交一次性文件	​电子邮件 批量处理或 通过 FTP 上传文件
设置自动转化报告	​转化 / 操作 API， 通过 FTP 推送文件，或 通过 FTP 拉取文件

API 撤销选项：

• 通过 API 修改或撤销操作中的一个或多个商品
• 通过 API 撤销整个操作

前提条件：获取该 行动 ID 值

要通过 API 修改操作数据，你需要其 行动 ID 值。然后你可以用它通过 API 找到要修改的操作。

• 你可以在调用中指定日期范围——否则，端点默认显示最近 30 天的操作。
• 速率限制 适用。
• 查看 列出所有操作 API 端点文档以了解更多信息。

常见问题

如何重置对某个操作（或操作项）所做的修改/撤销？

如果某个操作在锁定日期之前已被修改或撤销，你可以提交 RESET 作为原因，将该操作更新回其默认状态：

curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \\
  -X PUT \\
  -u '{AccountSID}:{AuthToken}' \\
  -H 'Accept: application/json' \\
  -H 'Content-Type: application/x-www-form-urlencoded' \\
  -d 'ActionId={ActionId}' \\
  -d 'Reason=RESET'

通过 RESET 代码重置的操作可能不会在报表中正确显示（例如，收入值可能计算错误）。

处置代码和原因之间有什么区别？

二者 处置代码 和 原因 都用于相同的上下文中—— 原因 是 API 默认接受的预定义代码，而 处置代码 是你可以配置的自定义原因。 了解更多有关处置代码的信息.

支持的原因代码：

代码	说明
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	已记入另一位合作伙伴
其他	其他原因

我如何查看修改/撤销何时应用于某个操作？

你可以使用 操作更新 端点，以查看某个操作上次更新的时间以及其当前状态。

注意： 一个 ActionUpdatesID 值不同于一个 行动 ID 值——你必须使用该 ActionUpdatesID 值来检索某个操作的更新。