Modificar ou reverter em lote via API

Faça o curso PXA

Se qualquer coisa 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 da ação.

Qual método de envio é o certo para você?

Se você quiser...	Use este método...
Enviar um arquivo manual, único, sem programação	​E-mail processamento em lote ou enviar arquivo via FTP
Configurar relatórios automatizados de conversões	​Conversões / Ações API, enviar arquivo via FTP, ou receber arquivo via FTP

Opções de reversão da API:

• 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 dados da ação via API, você precisará do seu ActionId valor. Em seguida, você pode usá-lo 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 usa como padrão mostrar os últimos 30 dias de ações.
• Limites de taxa se aplicam.
• Veja a 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 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, os valores de receita podem ser calculados incorretamente).

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

Ambos Códigos de disposição e 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 compatíveis:

Código	Descrição
CONS_FRAUD	Fraude do consumidor
CONS_ERROR	Erro do consumidor
ITEM_RETURNED	O item foi devolvido
APPROVED	A ação foi aprovada Observação: Se você estiver tentando aprovar ações, Aprovar precisa ser configurado como um código de disposição personalizado.
ORDER_ERROR	Erro do pedido
ORDER_UPDATE	O pedido foi atualizado
PUB_ACT_DISPUTE	Disputa de atividade do parceiro
ADV_ACT_DISPUTE	Disputa de atividade da marca
NOT_COMPLIANCE_TERMS	Não está em conformidade com os termos
ITEM_OUT_OF_STOCK	O 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
OUTRO	Outro motivo

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 o valor é diferente de um ActionId valor — você deve usar o ActionUpdatesID valor para recuperar as atualizações de uma ação.