Modificar ou Reverter em Lote via API (Serviços Web)

Faça o curso PXA

Se algo em uma ação mudar (por exemplo, um pedido foi cancelado, um item foi devolvido, etc.), você pode usar a API para modificá-la (ou revertê-la), alterando o valor da comissão pela ação.

Opções de reversão em lote:

• Modificar ou reverter um ou mais itens em uma ação via API

• Reverter uma ação inteira via API

Pré-requisito: Recupere o ActionId valor

Para modificar os dados da ação, você precisará do seu ActionId valor. Você pode então usar isso para encontrar a ação que deseja modificar via API.

• Você pode especificar um intervalo de datas na sua chamada — caso contrário, o endpoint mostra por padrão os últimos 30 dias de ações.

• Limites de taxa aplicam-se.

• Veja o Listar todas as ações documentação do endpoint da API para saber mais.

Perguntas frequentes

Como faço para redefinir uma modificação / reversão feita em uma ação (ou itens da ação)?

Se uma ação foi modificada ou revertida antes da sua data de bloqueio, você pode enviar RESET como motivo para atualizar a ação de volta ao seu estado padrão:

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'

Ações que foram redefinidas via o RESET código podem não aparecer corretamente nos relatórios (por exemplo, valores de receita podem ser calculados incorretamente).

Qual é a diferença entre um código de disposição e um motivo?

Tanto Códigos de Disposição quanto Motivos são usados no mesmo contexto — Motivos são códigos predefinidos que a API aceitará por padrão, enquanto Códigos de Disposição são motivos personalizados que você pode configurar. Saiba mais sobre Códigos de Disposição.

Códigos de motivo suportados:

Como posso ver quando modificações / reversões são aplicadas a uma ação?

Você pode usar o atualizações de ação endpoint para ver quando uma ação foi atualizada pela última vez e qual é seu estado atual.

Observação: Um ActionUpdatesID valor é diferente de um ActionId valor — você deve usar o ActionUpdatesID valor para recuperar atualizações de uma ação.