通过 API 批量修改或反向处理

参加 PXA 课程

如果某项行动的任何内容发生变化（例如，订单被取消、商品被退回等），您可以使用 API 对其进行修改（或撤销），从而更改该行动的佣金金额。

哪种提交方式适合您？

API 撤销选项：

• 通过 API 修改或撤销一个行动中的一项或多项商品

• 通过 API 撤销整个行动

前提条件：检索 ActionId 值

要通过 API 修改行动数据，您需要其 ActionId 值。然后，您可以使用它通过 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 默认接受的预定义代码，而 处置代码 是您可以配置的自定义原因。 了解有关处置代码的更多信息.

支持的原因代码：

如何查看对行动应用修改/撤销的时间？

您可以使用 行动更新 端点以查看某个行动最后一次更新的时间以及其当前状态。

注意： 一个 ActionUpdatesID 值与 ActionId 值不同——您必须使用 ActionUpdatesID 值来检索某个行动的更新。