Panoramica dell'elaborazione in batch di inversioni via API (Web Services)

Segui il corso PXA

Se qualcosa riguardo 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. In questo articolo mostreremo come modificare e annullare un'azione con chiamate cURL all'API Brand di impact.com.

Opzioni di annullamento in batch:

• Modificare o annullare uno o più articoli in un'azione tramite API

• Annullare un'intera azione tramite API

Prerequisito: Recuperare il ActionId valore

Per annullare un'azione, ti servirà il suo ActionId valore. La chiamata qui sotto recupererà tutte le azioni per un Programma (cioè, Campaign) — puoi usarlo per trovare l'azione che vuoi modificare.

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

• Si applicano limiti di velocità .

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

Riferimento dei parametri

Parametro	Descrizione
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.
CampaignId	Il valore ID del programma (campagna) sotto il quale l'azione è stata tracciata.

Esempio di chiamata

curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -d 'CampaignId={CampaignId}'

Esempio di risposta

FAQ

Come faccio a reimpostare una modifica / 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 di ricavo potrebbero essere calcolati in modo errato).

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

Sia i Codici di Disposizione che i Motivi vengono usati nello stesso contesto — I Motivi sono codici predefiniti che l'API accetterà di default, mentre I Codici di Disposizione sono motivi personalizzati che puoi configurare. Per saperne di più sui Codici di Disposizione.

L'invio di uno qualsiasi di questi valori come motivo annullerà l'articolo (o l'azione):

Codice	Descrizione
CONS_FRAUD	Frode del consumatore
CONS_ERROR	Errore del consumatore
ITEM_RETURNED	Articolo restituito
ORDER_ERROR	Errore d'ordine
ORDER_UPDATE	L'ordine è stato aggiornato
PUB_ACT_DISPUTE	Controversia sull'attività del partner
ADV_ACT_DISPUTE	Controversia sull'attività dell'inserzionista
NOT_COMPLIANCE_TERMS	Non conforme ai termini
ITEM_OUT_OF_STOCK	Articolo esaurito
TEST_ACTION	Azione di test
PARTNER_NOT_ACTIVE	Account partner disattivato
CREDITED_DIFFERENT_MP	Accreditato a un altro partner
OTHER	Altro motivo
ITEM_CANCELLED	Articolo nell'ordine è stato annullato

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.

curl 'https://api.impact.com/Advertisers/{AccountSID}/ActionUpdates/{ActionUpdatesId}' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \

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