Modificar em lote ou reverter via API

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

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

Se você quiser...	Use este método...
Envie um arquivo manual e ú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 baixar arquivo via FTP

Opções de reversão da API:

• Modifique ou reverta um ou mais itens em uma ação via API
• Reverta uma ação inteira via API

Pré-requisito: Recupere o ActionId valor

Para modificar os 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 exibirá por padrão os últimos 30 dias de ações.
• Limites de taxa se aplicam.
• Veja a tabela de referência de Liste todas as ações Consulte a 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 tiver sido 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 por meio do 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 suportados:

Código	Descrição
CONS_FRAUD	Fraude do consumidor
CONS_ERROR	Erro do consumidor
ITEM_RETURNED	O item foi devolvido
APPROVED	A ação está 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 os atualizações da 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 as atualizações de uma ação.