Publisher Transaction Queries IT
From Wiki
Contents |
Introduzione
Una richiesta di transazione è una transazione che viene aggiunta manualmente al sistema da parte di un publisher. Questo può avvenire quando credi ci siano vendite non tracciate, una commissione errata, o quando decidi di contestare una transazione rifiutata.
Esempi aggiuntivi:
- Non tracciato
Questa situazione può verificarsi per una serie di ragioni: la funzione di tracking potrebbe non essere attiva sulla pagina di conferma, oppure un utente potrebbe avere bloccato i cookie di terzi.
- Errato
Un publisher decide di contestare l'importo della commissione di una transazione.
- Rifiutato
Un publisher chiede che una transazione venga nuovamente convalidata, in quanto pensa che sia una transazione valida.
Questa guida fornisce indicazioni su come inviare richieste di transazione agli advertiser tramite FTP o caricamento manuale.
Accertati di indicare le informazioni corrette, o l'advertiser potrebbe non convalidare la transazione.
Come funziona
Quando aggiungi una richiesta di transazione nel sistema, questa passerà all'interno del sistema dell'advertiser account. La maggior parte degli advertiser Awin hanno 75 giorni per rivedere/correggere una richiesta di transazione. Dopo questo termine, la transazione viene approvata automaticamente.
Modalità
Ci sono due modalità con cui inviare la richiesta di transazione: in maniera automatica tramite ftp, o con caricamento manuale tramite il tuo account.
Caricamento tramite FTP
Per automatizzare il processo tramite FTP è necessario essere in possesso di un proprio account FTP; in alternativa, contatta la nostra assistenza e richiedi un account FTP Awin. Una volta in possesso di nome utente e password FTP, fai clic su Richiesta di transazione (nel menu laterale a destra nell'area utente), quindi su Caricamento dati automatico.
Ora potrai inserire il nome utente e la password assieme al tipo di file e al programma, e potrai indicare se desideri ricevere per e-mail i report relativi al risultato del processo.
Quindi, connettiti al tuo account FTP e crea una cartella nominandola "transaction_queries" nella directory principale (/uploads/transaction_queries/).
Apri questa directory e carica il tuo file CSV o XML, rinominandolo data.csv (oppure data.xml) Se hai deciso di ricevere i report sullo stato di elaborazione del tuo file (impostazione consigliata), riceverai una e-mail al termine dell'elaborazione.
Nota: aggiorniamo solo i file nuovi. Pertanto, se hai indicato l'opzione giornaliera, ma carichi un nuovo file solo una volta alla settimana, il sistema riconosce questa condizione in automatico ed elabora i file solo quando sono effettivamente aggiornati.
Caricamento manuale
Una volta eseguito il login nel proprio account publisher, fai click sulla voce Assistenza > Richiesta di transazione dal menu di navigazione. Dalle opzioni disponibili su questa pagina seleziona 'Caricamento manuale dei dati'. Sarà quindi necessario selezionare un file XML o CSV conforme alle specifiche; quindi, fai click sul pulsante di caricamento.
Riceverai un messaggio che ti informa su quali righe sono/non sono state caricate e perché.
Specifiche del file di dati
Il file di dati deve essere conforme alla struttura illustrata sotto, prima di essere caricato nel proprio account.
Tabella delle specifiche
Nome del campo | Tipologia | Descrizione | Esempio |
enquiry_id | Integer, Max: 10 char. | ID unico della query nel nostro sistema | 123456371 |
type | enumeration | Lo stato può essere"rifiutato", "errato" o "non tracciato" | untracked |
click_ref | Alpha numeric - Max: 50 char | Identifica la vendita in maniera univoca per il publisher | clickref12345 |
merchant_id | Integer, Max: 8 char. | Identifica in maniera univoca nel nostro sistema il merchant/advertiser al quale si riferisce la richiesta di transazione. | 1234 |
date | Date time | Data e ora dell'ordine (yyyy-mm-dd HH:ii:ss) | 2012-04-25 23.11.26 |
amount | decimal(7,2) | Valore di vendita senza il simbolo della valuta | 5,00 |
commission | decimal(7,2) | Valore della commissione senza il simbolo della valuta | 1,00 |
reference | Text Max 16,777,215 char | ID transazione, o qualsiasi dato che consente di identificare in maniera univoca la transazione. | La commissione ricevuta era 4,54EUR, mentre avrebbe dovuto essere 5,54EUR |
customer_reference | Text Max 16,777,215 char | dati inseriti dal publisher per identificarsi come cliente dell'advertiser | customerrefSD2343 |
Description | Text Max 16,777,215 char | Qualsiasi informazione aggiuntiva per l'advertiser che si riferisce alla transazione. | La commissione ricevuta era 0,80EUR, mentre avrebbe dovuto essere 1,00EUR |
Currency | Text | dati inseriti dal publisher per identificare la valuta utilizzata per la transazione | EUR |
Timezone | Text | dati inseriti dal publisher per identificare il fuso orario della transazione | Europa/Dublino |
Esempio di richiesta di transazione:
enquiry_id | merchant_id | type | click_ref | amount | commission | date | customer_reference | reference | description |
---|---|---|---|---|---|---|---|---|---|
3825 | 3 | untracked | CR1 (or 0) | 650.99 | 23.44 | YYYY-MM-DD 00:00:00 | 111111-000216 | order-ref123 | john@gmail.com |
CSV
I valori di tutti i file CSV (http://en.wikipedia.org/wiki/Comma-separated_values) devono essere compresi tra virgolette e devono essere separati da virgole. Ogni riga deve essere separata da una riga vuota. La prima riga del file CSV deve contenere le intestazioni di campo corrette.
Esempio CSV
enquiry_id,merchant_id,type,click_ref,amount,commission,date,customer_reference,reference,description,currency,timezone 123456371,3727,untracked,clickref12345,5.00,1.00,2012-04-25 23:11:00,customerrefSD2343,orderref123447,sale untracked,EUR,Europe/Dublin
XML
Tutti i file XML (http://en.wikipedia.org/wiki/Xml) devono essere formattati in maniera corretta.
Esempio XML
<?xml version="1.0" encoding="ISO-8859-1"?> <enquiries> <enquiry> <enquiry_id>101</enquiry_id> <type>rifiutato</type> <click_ref>25</click_ref> <merchant_id>1001</merchant_id> <date>2008-03-20 23:40:09</date> <amount>4,50</amount> <commission>1,00</commission> <reference>7723123</reference> <customer_reference>email@indirizzo.com</customer_reference> <description>questo acquisto è stato rifiutato, perché?</description> <currency>EUR</currency> <timezone>Europa/Dublino</timezone> </enquiry> <enquiry> <enquiry_id>102</enquiry_id> <type>errato</type> <click_ref>27</click_ref> <merchant_id>1001</merchant_id> <date>2008-03-22 01:22:24</date> <amount>312,50</amount> <commission>6,55</commission> <reference>order # 554212</reference> <customer_reference>554212</customer_reference> <description>L'importo dell'acquisto era di 75,28EUR ma sono stati tracciati solo 68,10EUR</description> </enquiry> <enquiry> <enquiry_id>103</enquiry_id> <type>non tracciato</type> <click_ref>28</click_ref> <merchant_id>1001</merchant_id> <date>2007-04-01 02:21:09</date> <amount>61,90</amount> <commission>4,02</commission> <reference>J55432-1212</reference> <customer_reference>email@indirizzo.com</customer_reference> <description>Numero carta vantaggi: 77712312</description> </enquiry> </enquiries>
Pianificazione FTP
La nostra elaborazione FTP consente di scegliere tra un'elaborazione giornaliera o settimanale. L'elaborazione settimanale avviene ogni domenica alle 0200. L'elaborazione giornaliera avviene alle 0200.
Report delle richieste di transazione
Per visualizzare le richieste di transazione, inclusi gli stati correnti, seleziona "Report delle richieste di transazione".
Potrai affinare la ricerca per nome advertiser/ID stato e data. Il report può essere scaricato in formato CSV.
Controllo della transazione
Verifica se la transazione verrà accettata nel sistema. È possibile eseguire la ricerca inserendo l'ID dell'ordine, l'ID advertiser e la data, come illustrato di seguito.