通过 API 修改或撤销操作中的项目

除了修改和撤销操作外，impact.com 还允许您修改和撤销操作的项目级详细信息。

注意： impact.com 对每个操作允许最多 1000 次修改。如果您之后需要进行更多修改，联系支持.

通过 API 修改操作中的项目

如果您在项目级别跟踪（即在报告转化时传递项目数据），您可以使用 API 修改操作中项目的数量或报告的收入金额。

要修改操作中的项目，您将需要：

该 ActionId 操作的。
该 原因 用于更新该操作（当修改操作中的项目时，始终提交 ORDER_UPDATE).
该 Sku 要修改的项目的（可以在通过 API 检索操作时找到）。
新的 数量 项目的值。
新的收入 金额 项目的值——仅当此值发生更改时在调用中包含此项（例如，报告的项目收入金额被错误地报告）。

一旦您拥有所有这些值，请参阅下面的示例调用以了解如何修改操作中的项目。

示例调用与响应

新的项目数量

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 'Sku={Sku}' \
  -d 'Quantity={Quantity}' \
  -d 'Reason=ORDER_UPDATE' \

新的项目收入金额

  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 'Sku={Sku}' \
    -d 'Amount={Amount}' \
    -d 'Reason=ORDER_UPDATE' \

示例响应

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}

参数参考

AccountId

您在 impact.com 帐户的 API 帐户 ID 值。了解如何查找此值.

AuthToken

您在 impact.com 帐户的 API 授权令牌值。了解如何查找此值.

ActionId

要修改的操作的 ID 值。

Sku

项目的库存保有单位值（SKU）——可在通过 API 检索操作时找到。

数量

项目的新数量值。

原因

在撤销或修改项目时，始终提交 ORDER_UPDATE 作为原因。

金额

项目的新收入金额值。

通过 API 撤销操作中的项目

如果您在项目级别跟踪（即在报告转化时传递项目数据），您可以通过设置来撤销一个或多个项目， 数量 以 0.

要撤销操作中的项目，您将需要：

该 ActionId 操作的。
该 原因 用于更新该操作（当撤销操作中的项目时，始终提交 ORDER_UPDATE).
该 Sku 要撤销的项目的（可以在通过 API 检索操作时找到）。
新的 数量 项目的值——在这种情况下， 0

一旦您拥有所有这些值，请参阅下面的示例调用以了解如何在操作中撤销项目。