Modificar ou Reverter Itens em uma Ação via API

Além de modificar e reverter ações, a impact.com permite que você modifique e reverta os detalhes de itens em nível de item de uma ação.

Observação: A impact.com permite no máximo 1000 modificações por ação. Se você precisar fazer mais modificações depois disso, entre em contato com o suporte.

Modificar itens em uma ação via API

Se você estiver rastreando no nível de item (ou seja, enviando dados dos itens ao reportar conversões), pode usar a API para modificar a quantidade ou o valor de receita reportado dos itens dentro de uma ação.

Para modificar itens em uma ação, você precisará:

O ActionId da ação.
O Motivo para atualizar a ação (ao modificar itens em uma ação, sempre envie ORDER_UPDATE).
O Sku do(s) item(ns) a ser(em) modificado(s) (pode ser encontrado ao recuperar uma ação via API).
O novo Quantity valor para o item.
O novo valor de Amount para o item — inclua isso na chamada somente se esse valor estiver mudando (por exemplo, o valor de receita reportado do item foi informado incorretamente).

Depois de ter todos esses valores, veja os exemplos de chamadas abaixo para aprender como modificar um item dentro de uma ação.

Chamadas de exemplo e resposta

Nova quantidade do item

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' \

Novo valor de receita do item

  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' \

Resposta de exemplo

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

Referência de parâmetros

AccountId

O valor do ID da conta de API da sua conta impact.com. Saiba como encontrar esse valor.

AuthToken

O valor do token de autorização da API da sua conta impact.com. Saiba como encontrar esse valor.

ActionId

O valor de ID da ação a ser modificada.

Sku

O valor do código de identificação do produto (SKU) do item — isso pode ser encontrado ao recuperar uma ação via API.

Quantity

O novo valor de quantidade para o item.

Motivo

Ao reverter ou modificar um item, sempre envie ORDER_UPDATE como motivo.

Amount

O novo valor do valor de receita para o item.

Reverter itens em uma ação via API

Se você estiver rastreando no nível de item (ou seja, enviando dados dos itens ao reportar conversões), pode usar a API para reverter um ou mais itens definindo Quantity para 0.

Para reverter itens em uma ação, você precisará:

O ActionId da ação.
O Motivo para atualizar a ação (ao reverter itens em uma ação, sempre envie ORDER_UPDATE).
O Sku do(s) item(ns) a ser(em) revertido(s) (pode ser encontrado ao recuperar uma ação via API).
O novo Quantity valor para o item — neste caso, 0

Depois de ter todos esses valores, veja a chamada de exemplo abaixo para aprender como reverter itens em uma ação.

Chamada de exemplo e resposta

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'