Visão Geral do Processamento em Lote de Reversões via API (Web Services)

Faça o curso PXA

Se algo sobre 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. Neste artigo, mostramos como modificar e reverter uma ação com chamadas cURL para a Brand API da impact.com.

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 reverter uma ação, você precisará do seu ActionId valor. A chamada abaixo recuperará todas as ações para um(a) Programa (ou seja, Campanha) — você pode usar isso para encontrar a ação que deseja modificar.

• 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 se aplicam.

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

Referência de parâmetros

Parâmetro	Descrição
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.
CampaignId	O valor de ID do programa (campanha) sob o qual a ação foi rastreada.

Exemplo de chamada

curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -d 'CampaignId={CampaignId}'

Resposta de exemplo

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.

Enviar qualquer um desses valores como motivo reverterá o item (ou a ação):

Código	Descrição
CONS_FRAUD	Fraude do consumidor
CONS_ERROR	Erro do consumidor
ITEM_RETURNED	Item devolvido
ORDER_ERROR	Erro de pedido
ORDER_UPDATE	Pedido foi atualizado
PUB_ACT_DISPUTE	Disputa de atividade do parceiro
ADV_ACT_DISPUTE	disputa de atividade do anunciante
NOT_COMPLIANCE_TERMS	Não está em conformidade com os termos
ITEM_OUT_OF_STOCK	Item está fora de estoque
TEST_ACTION	Ação de teste
PARTNER_NOT_ACTIVE	Conta do parceiro desativada
CREDITED_DIFFERENT_MP	Creditado para outro parceiro
OTHER	Outro motivo
ITEM_CANCELLED	Item no pedido foi cancelado

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

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

curl 'https://api.impact.com/Advertisers/{AccountSID}/ActionUpdates/{ActionUpdatesId}' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \

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