If you're tracking at the item level (i.e., passing item data when reporting conversions), you can use the API to modify the quantity or reported revenue amount of item(s) within an action.
To modify items in an action, you'll need:
The
ActionIdof the action.The
Reasonfor updating the action (when modifying items in action, always submitORDER_UPDATE).The
Skuof the item(s) to be modified (can be found when retrieving an action via API).The new
Quantityvalue for the item.The new revenue
Amountvalue for the item — only include this in the call if this value is changing (e.g., the reported item revenue amount was reported incorrectly).
Once you have all of these values, use the call below to modify an item within an action.
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' \
|
Your impact.com account's API account ID value. Learn how to find this value. |
|
Your impact.com account's API authorization token value. Learn how to find this value. |
|
The ID value of the action to be modified. |
|
The stock-keeping unit value of the item — this can be found when retrieving an action via API. |
|
The new quantity value for the item. |
|
When reversing or modifying an item, always submit |
|
The new revenue amount value for the item. |
If you're tracking at the item-level (i.e., passing item data when reporting conversions), you can use the API to reverse one or more item by setting Quantity to 0.
To reverse items in an action, you'll need:
The
ActionIdof the action.The
Reasonfor updating the action (when reversing items in action, always submitORDER_UPDATE).The
Skuof the item(s) to be reversed (can be found when retrieving an action via API).The new
Quantityvalue for the item — in this case,0
Once you have all of these values, use the call below to reverse items in an action.
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=0' \
-d 'Reason=ORDER_UPDATE'
|
Your impact.com account's API account ID value. Learn how to find this value. |
|
Your impact.com account's API authorization token value. Learn how to find this value. |
|
The ID value of the action to be modified. |
|
The stock-keeping unit value of the item — this can be found when retrieving an action via API. |
|
The new quantity value for the item. |
|
When reversing or modifying an item, always submit |