Modifica in batch o annulla tramite API

Segui il corso PXA

Se qualcosa relativo a un'azione cambia (ad es., un ordine è stato annullato, un articolo è stato restituito, ecc.), puoi usare l'API per modificarla (o annullarla), cambiando l'importo della commissione per l'azione.

Quale metodo di invio è giusto per te?

Se vuoi...	Usa questo metodo...
Invia un file manuale, una tantum, senza codice	​Email elaborazione batch o carica il file tramite FTP
Configura report automatici delle conversioni	​Conversioni / Azioni API, invia il file tramite FTP, o preleva il file tramite FTP

Opzioni di annullamento via API:

• Modifica o annulla uno o più articoli in un'azione tramite API
• Annulla un'intera azione tramite API

Prerequisito: recupera il ActionId valore

Per modificare i dati dell'azione tramite API, ti servirà il suo ActionId valore. Potrai quindi usarlo per trovare l'azione che desideri modificare tramite API.

• Puoi specificare un intervallo di date nella tua chiamata; in caso contrario, l'endpoint mostra per impostazione predefinita le azioni degli ultimi 30 giorni.
• I limiti di frequenza si applicano.
• Visualizza Elenca tutte le azioni documentazione dell'endpoint API per saperne di più.

FAQ

Come posso reimpostare una modifica / un annullamento effettuato su un'azione (o sugli articoli dell'azione)?

Se un'azione è stata modificata o annullata prima della sua data di blocco, puoi inviare RESET come motivo per riportare l'azione al suo stato predefinito:

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'

Le azioni che sono state reimpostate tramite il RESET codice potrebbero non apparire correttamente nei report (ad es., i valori dei ricavi potrebbero essere calcolati in modo errato).

Qual è la differenza tra un codice di disposizione e un motivo?

Entrambi Codici di disposizione e Motivi sono utilizzati nello stesso contesto — Motivi sono codici predefiniti che l'API accetterà per impostazione predefinita, mentre Codici di disposizione sono motivi personalizzati che puoi configurare. Scopri di più sui codici di disposizione.

Codici motivo supportati:

Codice	Descrizione
CONS_FRAUD	Frode del consumatore
CONS_ERROR	Errore del consumatore
ITEM_RETURNED	L'articolo è stato restituito
APPROVED	L'azione è approvata Nota: Se stai cercando di approvare le azioni, Approva deve essere impostato come un codice di disposizione personalizzato.
ORDER_ERROR	Errore dell'ordine
ORDER_UPDATE	L'ordine è stato aggiornato
PUB_ACT_DISPUTE	Contestazione dell'attività del partner
ADV_ACT_DISPUTE	Contestazione dell'attività del brand
NOT_COMPLIANCE_TERMS	Non conforme ai termini
ITEM_OUT_OF_STOCK	L'articolo non è disponibile
TEST_ACTION	Azione di test
PARTNER_NOT_ACTIVE	Account del partner disattivato
CREDITED_DIFFERENT_MP	Accreditato a un altro partner
ALTRO	Altro motivo

Come posso vedere quando le modifiche / gli annullamenti vengono applicati a un'azione?

Puoi usare i aggiornamenti dell'azione endpoint per vedere quando un'azione è stata aggiornata l'ultima volta e qual è il suo stato attuale.

Nota: Una ActionUpdatesID valore è diverso da un ActionId valore — devi usare il ActionUpdatesID valore per recuperare gli aggiornamenti di un'azione.