Modifica in blocco o annulla tramite API

Segui il corso PXA

Se qualsiasi aspetto di un'azione cambia (ad es., un ordine è stato annullato, un articolo è stato restituito, ecc.), puoi usare l'API per modificarla (o invertirla), modificando l'importo della commissione per l'azione.

Qual è il metodo di invio giusto per te?

Opzioni di inversione via API:

• Modifica o inverti uno o più elementi in un'azione tramite API

• Inverti un'intera azione tramite API

Prerequisito: recupera il ActionId valore

Per modificare i dati dell'azione tramite API, avrai bisogno del suo ActionId valore. Potrai quindi usarlo per trovare l'azione che desideri modificare tramite API.

• Puoi specificare un intervallo di date nella tua chiamata — altrimenti, l'endpoint mostra per impostazione predefinita le azioni degli ultimi 30 giorni.

• Si applicano limiti di velocità.

• Visualizza la documentazione dell'endpoint API Elenca tutte le azioni per saperne di più.

Domande frequenti

Come posso reimpostare una modifica / inversione apportata a un'azione (o agli elementi dell'azione)?

Se un'azione è stata modificata o invertita prima della 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 usati 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:

Come posso vedere quando le modifiche / inversioni vengono applicate a un'azione?

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

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