Invia modifiche e annullamenti in batch

Quando un partner genera una conversione—come una vendita—e il periodo di blocco per quell'azione non è ancora scaduto, puoi modificare qualsiasi dato azione errato inviando una modifica o una revoca. Ciò garantisce che il partner venga pagato correttamente al termine del periodo di blocco.

Le azioni vengono normalmente modificate o revocate quando i clienti restituiscono ordini, commettono errori durante il checkout o quando gli articoli sono esauriti.

Puoi inviare modifiche e revoche in blocco sia tramite API, sia tramite un server FTP/SMTP come descritto di seguito. Il modello di cui hai bisogno per le submission FTP/SMTP dipende dal fatto che tu stia tracciando a livello di ordine o di articolo, poiché ciascuno richiede campi diversi. Se non sei sicuro di quale file utilizzare, chiedi al tuo CSM o contatta il supporto.

Cose da tenere a mente

• Usa formati di file supportati — Il file che invii deve essere in formato .CSV o .XML.

• Non aggiungere nuovi punti dati — Non puoi aggiungere nuovi campi a una transazione, puoi solo aggiornare quelli esistenti.

• Comprendi la gestione della deduplicazione — Quando più azioni condividono lo stesso Oid/OrderId, impact.com applica gli aggiornamenti al più recente ActionId. Per forzare un override, specifica il ActionId.

• Usa Importo correttamente per le revoche — Per revocare un'azione, puoi impostare Importo = 0. Tuttavia, se l'originale Importo = 0, lasciarlo a 0 verrà registrato come una modifica e l'azione non sarà revocata.

Passo 1: Prepara il tuo file di dati

Per un elenco dei campi comunemente usati nell'elaborazione batch FTP/SMTP, vedi Riferimento Modifiche e Revoche in Batch. In alternativa, vedi Riferimenti dati azione e conversione di impact.com per un elenco completo dei campi supportati.

1. Identifica il file modello pertinente al tuo caso d'uso.

   • Vedi Riferimento Modifiche e Revoche in Batch per i file modello con dati di esempio.

2. Incolla il contenuto del modello in un'applicazione di foglio di calcolo (es., Microsoft Excel) o in un editor di testo (es., Notepad).

3. Sotto la riga dell'intestazione, inizia ad aggiungere i dati azione modificati.

   • Se usi un editor di testo, usa le virgole per separare ogni punto dati.

   • Se usi un editor di fogli di calcolo, aggiungi ogni punto dati in una cella separata.

   Importante: Assicurati di modificare le celle del foglio di calcolo in formato "Testo semplice" o "Testo" in modo che i valori non vengano accidentalmente omessi.

4. Salva il file con un nome identificabile, ad esempio: Batch_Mods/Reversals_2025_02_12.csv

Passo 2: Invia il tuo file di dati

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

1. Dalla barra di navigazione superiore, seleziona [Profilo utente] → Impostazioni.

2. A destra, sotto Tracciamento, seleziona Tipi di evento.

3. Seleziona il nome del Tipo di Evento per il quale desideri inviare modifiche in batch.

4. Accanto a Elaborazione resi, seleziona [Modifica].

5. Seleziona Automatizza l'elaborazione dei resi (avanzato).

   • Scegli uno dei seguenti metodi relativi a FTP o SMTP per inviare il tuo file:

Carica il file sul server FTP del sistema

1. Seleziona Carica il file sul server FTP del sistema.

2. Seleziona Salva.

3. Una volta ricevute le tue credenziali FTP via email, usa un client FTP per connetterti a impact.com con le seguenti informazioni:

   
4. Una volta connesso, carica il tuo file nella directory principale del server.

   • Se non hai ricevuto l'email con le credenziali FTP, contatta la persona che ha creato il tuo account impact.com. In alternativa, contatta il supporto.

Preleva il file dal tuo server FTP

1. Seleziona Preleva il file dal tuo server FTP.

2. Inserisci il URL del server, Porta, e Directory percorso del file di modifiche batch sul tuo server FTP. Inserisci il Nome utente e Password che impact.com userà per connettersi al tuo server FTP.

3. Seleziona Salva e continua.

4. Carica il tuo file di modifiche batch nella directory che hai specificato sopra.

   • impact.com tenta di connettersi e scaricare i file dal tuo server FTP ogni 24 ore, quindi il tuo file potrebbe impiegare fino a 24 ore per essere elaborato dopo il caricamento.

Invia il file via email al server SMTP del sistema

1. Seleziona Invia il file via email al server SMTP del sistema, quindi copia il tuo indirizzo email univoco.

2. Usando qualsiasi client di posta elettronica, invia un'email all'indirizzo univoco con il tuo file di modifiche batch in allegato.

   • Includi solo l'indirizzo email univoco per il tipo di evento nel A: campo. Se devi inviare questo file ad altri, includili nel CC: campo.

3. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio.

Passo 3: Revisiona l'invio del file

Una volta inviato il tuo file .CSV o .XML a impact.com, puoi verificare lo stato per vedere se è stato elaborato.

1. Dalla barra di navigazione superiore, seleziona [Profilo utente] → Impostazioni.

2. Nella colonna di sinistra, scorri fino alla Tecnico sezione e seleziona Invii file.

3. Usa la tabella per rivedere gli invii di file recenti che impact.com ha ricevuto, incluso lo stato di elaborazione attuale.

   • I file inviati appariranno entro 10-15 minuti dall'invio, mentre gli aggiornamenti di reportistica generale possono richiedere 2+ ore.

   • Di seguito sono riportati vari problemi che potresti incontrare durante la revisione degli invii dei file e le azioni che puoi intraprendere per risolverli.

   Problema	Azione da intraprendere
   La colonna Record mostra 0	Assicurati che l'estensione del file sia .CSV o .XML.
   NO_CHANGE	Non è stata effettuata alcuna modifica all'azione. Assicurati di inserire l'importo finale nella Importo colonna (es., inserisci 0 se vuoi revocare le azioni).
   BAD_DISPOSITION	Il codice motivo che hai fornito non è valido. Utilizza uno dei codici motivo. In alternativa, puoi impostare un codice di disposizione personalizzato.
   ALREADY_LOCKED	Il periodo di blocco dell'azione è già scaduto. L'azione non può più essere modificata o revocata.
   ActionTrackerId: il valore ActionTrackerId non è valido	Questo dovrebbe corrispondere all' ID del Tipo di Evento inserito.
   ACTION_NOT_FOUND	L' OID che hai fornito è errato. Fornisci un OID.
   ALREADY_REVERSED	L'azione è già stata revocata.
   ALREADY_APPROVED	L'azione è già stata approvata.