Publisher Transaction Queries IT

From Wiki

Jump to: navigation, search

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.

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.

Privacy

Due to new European legislation regarding how websites store information about you, AWIN is updating its privacy policy. You can see the new version of our policy here. If you would like to see the information we capture on this website, please click here for further details. In order to accept cookies on this site please click the 'I ACCEPT' button