For the complete documentation index, see llms.txt. This page is also available as Markdown.

Riferimento per modifiche e storni in batch

Quando modifichi o annulli in blocco i dati delle azioni, inizia scaricando uno dei file modello forniti da impact.com e sostituendo i dati di esempio con i tuoi. Quando aggiungi i tuoi dati, assicurati di seguire le linee guida nella tabella di riferimento pertinente per garantire che l'invio del file sia formattato correttamente. Una volta che il file di invio è pronto, puoi riprendere con l'invio delle tue modifiche / annullamenti in batch del file.

Questo articolo di riferimento include i campi più comunemente utilizzati per le modifiche e gli annullamenti in batch. Per vedere un riferimento completo e dettagliato che includa le descrizioni dei campi, fai riferimento a Riferimenti dei campi di azione e conversione.

Consulta i riferimenti qui sotto per:

  • Scoprire quali campi usare in una modifica o annullamento in batch via FTP/SMTP

  • Scaricare file modello con dati di esempio segnaposto

  • Capire quali codici motivo applicare e quando

Modifiche a livello ordine

Questo serve quando vuoi aggiornare i dati delle azioni in blocco a livello di ordine invece che a livello di articolo, ad es. modificare l'importo dell'ordine per più ordini.

Parametri accettati
Campo
Obbligatorio?
Modificabile?
Nota

ActionID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è consigliato quando la finestra di deduplicazione è breve.

Oid / OrderId

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa ActionTrackerId.

ActionTrackerID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa OrderId/Oid.

Importo

Facoltativo

Modificabile

Imposta il nuovo importo totale dell'ordine.

currencyCode

Facoltativo

Modificabile

Imposta la valuta dei ricavi dell'azione. Per impostazione predefinita, se non viene fornita, usa la valuta del tuo account impact.com.

CustomerStatus

Facoltativo

Modificabile

Imposta lo stato del cliente al momento della conversione, ad es. NUOVO / ESISTENTE.

Motivo

Obbligatorio

Modificabile

Fornisci un codice motivo valido per la modifica.

*Deve essere fornito almeno un percorso di identificazione, cioè, sia ActionId o (*OrderId/Oid *+ ActionTrackerId)

File modello

Annullamenti a livello ordine

Questo serve quando vuoi annullare in blocco azioni guidate dal partner a livello di ordine invece che a livello di articolo, ad es. annullare più ordini.

Parametri accettati
Campo
Obbligatorio?
Modificabile?
Nota

ActionID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è consigliato quando la finestra di deduplicazione è breve.

Oid / OrderId

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa ActionTrackerId.

ActionTrackerID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa OrderId/Oid.

Importo

Richiesto in modo condizionale**

Modificabile

Imposta su 0 per annullare l'ordine, a meno che l'importo originale = 0**

Motivo

Obbligatorio

Modificabile

Fornisci un codice motivo valido per l'annullamento.

*Deve essere fornito almeno un percorso di identificazione, cioè, sia ActionId o (OrderId/Oid + ActionTrackerId)

**Se l'originale Amount = 0, lascia Importo invariato per evitare di classificarlo erroneamente come modifica.

File modello

Modifiche a livello articolo

Questo serve quando vuoi aggiornare i dati delle azioni in blocco a livello di articolo invece che a livello di ordine, ad es. modificare l'importo per più articoli in un ordine.

Parametri accettati
Campo
Obbligatorio?
Modificabile?
Nota

ActionID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è consigliato quando la finestra di deduplicazione è breve.

Oid / OrderId

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa ActionTrackerId.

ActionTrackerID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa OrderId/Oid.

SKU**

Obbligatorio

Non modificabile

Fornisci il valore SKU dell'articolo che desideri modificare.

Importo**

Richiesto in modo condizionale

Modificabile

Imposta il nuovo importo dell'articolo, cioè prezzo*quantità. Se modifichi la quantità, anche questo campo richiede una modifica.

Quantità**

Facoltativo

Modificabile

Imposta la nuova quantità di articoli nell'ordine.

Categoria**

Facoltativo

Modificabile

Imposta la categoria dell'articolo.

Motivo**

Obbligatorio

Modificabile

Fornisci un codice motivo valido per l'annullamento.

*Deve essere fornito almeno un percorso di identificazione, cioè, sia ActionId o (OrderId/Oid + ActionTrackerId)

**Questi campi devono essere inclusi per ogni articolo che modifichi. I campi identificativi sono inclusi una sola volta per ordine.

File modello

Annullamenti a livello articolo

Questo serve quando vuoi annullare in blocco i dati delle azioni a livello di articolo invece che a livello di ordine, ad es. annullare più articoli in un ordine.

Parametri accettati
Campo
Obbligatorio?
Modificabile?
Nota

ActionID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è consigliato quando la finestra di deduplicazione è breve.

Oid / OrderId

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa ActionTrackerId.

ActionTrackerID

Richiesto in modo condizionale*

Non modificabile

Fornire questo identificativo è richiesto quando si usa OrderId/Oid.

SKU**

Obbligatorio

Non modificabile

Fornisci il valore SKU dell'articolo che desideri modificare.

Importo**

Richiesto in modo condizionale

Modificabile

Imposta il nuovo importo dell'articolo, cioè prezzo*quantità. Se modifichi la quantità, anche questo campo richiede una modifica.

Quantità**

Facoltativo

Modificabile

Imposta la nuova quantità di articoli nell'ordine.

Motivo**

Obbligatorio

Modificabile

Fornisci un codice motivo valido per la modifica.

*Deve essere fornito almeno un percorso di identificazione, cioè, sia ActionId o (OrderId/Oid + ActionTrackerId)

**Questi campi devono essere inclusi per ogni articolo che modifichi. I campi identificativi sono inclusi una sola volta per ordine.

File modello

SKU O7427540 appare due volte in questo esempio perché una riga è un annullamento (Amount=0) e una è una modifica (Amount=15).

Nota: Se prevedi di avere OrderId duplicati OrderId e scegli di usare la combinazione di OrderId + ActionTrackerId, impact.com applica l'aggiornamento al più recente ActionId per impostazione predefinita. Usa il vecchio ActionId se vuoi applicare l'aggiornamento al più vecchio ActionId.

Codici motivo

Ogni volta che modifichi o annulli i dati di un'azione, devi fornire un motivo. Usa il relativo codice motivo qui sotto per spiegare perché l'azione viene aggiornata.

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

Ultimo aggiornamento

È stato utile?