Modifica o annulla voci in un'azione tramite API

Oltre a modificare e annullare le azioni, impact.com ti consente di modificare e annullare i dettagli a livello di articolo di un'azione.

Nota: impact.com consente un massimo di 1000 modifiche per azione. Se hai bisogno di effettuare ulteriori modifiche successivamente, contatta il supporto.

Modificare gli articoli in un'azione tramite API

Se stai monitorando a livello di articolo (cioè passando i dati degli articoli quando segnali le conversioni), puoi utilizzare l'API per modificare la quantità o l'importo di ricavo riportato degli articoli all'interno di un'azione.

Per modificare gli articoli in un'azione, ti serviranno:

L' ActionId dell'azione.
L' Motivo dell'aggiornamento dell'azione (quando si modificano gli articoli in un'azione, invia sempre ORDER_UPDATE).
L' Sku degli articolo/i da modificare (può essere trovato recuperando un'azione tramite API).
Il nuovo Quantity valore per l'articolo.
Il nuovo ricavo Amount valore per l'articolo — includi questo campo nella chiamata solo se questo valore cambia (ad es. l'importo di ricavo dell'articolo è stato segnalato in modo errato).

Una volta che avrai tutti questi valori, vedi gli esempi di chiamate qui sotto per imparare come modificare un articolo all'interno di un'azione.

Esempi di chiamate e risposta

Nuova quantità dell'articolo

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 'Sku={Sku}' \
  -d 'Quantity={Quantity}' \
  -d 'Reason=ORDER_UPDATE' \

Nuovo importo di ricavo dell'articolo

  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 'Sku={Sku}' \
    -d 'Amount={Amount}' \
    -d 'Reason=ORDER_UPDATE' \

Esempio di risposta

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}

Riferimento parametri

AccountId

Il valore ID dell'account API del tuo account impact.com. Scopri come trovare questo valore.

AuthToken

Il valore del token di autorizzazione API del tuo account impact.com. Scopri come trovare questo valore.

ActionId

Il valore ID dell'azione da modificare.

Sku

Il valore SKU (unità di gestione del magazzino) dell'articolo — questo può essere trovato recuperando un'azione tramite API.

Quantity

Il nuovo valore di quantità per l'articolo.

Motivo

Quando annulli o modifichi un articolo, invia sempre ORDER_UPDATE come motivo.

Amount

Il nuovo valore dell'importo di ricavo per l'articolo.

Annullare gli articoli in un'azione tramite API

Se stai monitorando a livello di articolo (cioè passando i dati degli articoli quando segnali le conversioni), puoi utilizzare l'API per annullare uno o più articoli impostando Quantity a 0.

Per annullare gli articoli in un'azione, ti serviranno:

L' ActionId dell'azione.
L' Motivo per l'aggiornamento dell'azione (quando si annullano articoli in un'azione, invia sempre ORDER_UPDATE).
L' Sku degli articolo/i da annullare (può essere trovato recuperando un'azione tramite API).
Il nuovo Quantity valore per l'articolo — in questo caso, 0

Una volta che avrai tutti questi valori, vedi l'esempio di chiamata qui sotto per imparare come annullare gli articoli in un'azione.

Esempio di chiamata e risposta

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 'Sku={Sku}' \
  -d 'Quantity=0' \
  -d 'Reason=ORDER_UPDATE'