Transaction Notification IT
From Wiki
Contents |
Notifica di transazione
Offriamo ai nostri publisher una funzionalità di reporting quasi in tempo reale che assicura che, ogni volta che una transazione viene registrata, viene mandata una notifica al sistema del publisher, insieme a tutti i dettagli relativi alla transazione.
Per ottenere l'accesso a questa funzionalità è necessario prima di tutto attivarla, inviando un ticket dall'interfaccia publisher e descrivendo la richiesta.
Impostazioni
- Alla voce Avanzate troverai un link di notifica, una volta attivata questa funzionalità
- Come descritto sotto, ci sono quattro impostazioni da prendere in considerazione:
URL callback: questo è il percorso per lo script al quale vengono inviati i dati rilevanti. Da qui, il tuo file dovrà eseguire una gestione personalizzata dei dati ed analizzarli nei componenti del tuo sistema che ritieni necessari. Si potrebbe trattare ad esempio di un file PHP sul tuo dominio, ma la nostra notifica di transazione non si limita al PHP. Le porte supportate sono la 80 e la 443.
Metodo di callback: da qui puoi decidere in quale modo fornire i dati. Per altri esempi sui vari metodi, vedi sotto.
Dati prodotto: spunta la casella se desideri visualizzare i dati relativi ai prodotti effettivamente acquistati. Questo dipende dal fatto che l'advertiser implementi il Product Level Tracking e condivida in maniera attiva i dati con i publisher, cosa che non sempre avviene. (In caso di dubbio, ti preghiamo di contattare l'Account del programma.)
Fai clic sui dati sorgente: sono i dati relativi al primo link cliccato che ha portato poi all'avvenuta transazione.
- Una volta inseriti i dati corretti, fai clic su Invia. Dovresti poi visualizzare un messaggio che indica che le modifiche sono state salvate con successo.
Tipo di richieste
Richiesta GET
I dati di transazione verranno inviati sotto forma di richiesta GET all'URL specificato ed è possibile utilizzare le macro per modificare il percorso o richiedere parte dell'URL per rendere la richiesta dinamica.
Macro
| Macro | Descrizione | Esempio |
!!!affiliateId!!!
|
ID del publisher associato alla transazione | 45628 |
!!!bannerId!!!
|
ID Creatività collegata al click di conversione | 291555 |
!!!clickRef!!!
|
Click/View identificatore/riferimento specificato dal publisher. Consultare Click Reference | LINKCMP2013-06 |
!!!clickRef2!!!
|
Click/View identificatore/riferimento specificato dal publisher. Consultare Click Reference | LINKCMP2013-06 |
!!!clickRef3!!!
|
Click/View identificatore/riferimento specificato dal publisher. Consultare Click Reference | LINKCMP2013-06 |
!!!clickRef4!!!
|
Click/View identificatore/riferimento specificato dal publisher. Consultare Click Reference | LINKCMP2013-06 |
!!!clickRef5!!!
|
Click/View identificatore/riferimento specificato dal publisher. Consultare Click Reference | LINKCMP2013-06 |
!!!clickRef6!!!
|
Click/View identificatore/riferimento specificato dal publisher. Consultare Click Reference | LINKCMP2013-06 |
!!!clickThroughTime!!!
|
Click data nel formato %Y-%m-%d %H:%i:%s (fuso orario: UTC)
|
2013-06-13 12:00:00 |
!!!clickTime!!!
|
Click data nel formato %Y-%m-%d %H:%i:%s (fuso orario: UTC)
|
2013-06-13 12:00:00 |
!!!commission!!!
|
Importo commissione assegnato per la transazione | 1.64 |
!!!commissionGroups!!!
|
Errore del gruppo commissione associato alla transazione (in formato JSON) | See below under POST Request (JSON) / Example Data |
!!!groupId!!!
|
Gruppo Creatività collegato al click di conversione | 137726 |
!!!merchantId!!!
|
ID del programma advertiser a cui appartiene la transazione | 3661 |
!!!phrase!!!
|
Frase motore di ricerca | Musica elettronica |
!!!products!!!
|
Errore del prodotto associato alla transazione (in formato JSON) | Vedi sotto alla voce Richiesta POST (JSON) / Dati di esempio |
!!!searchEngine!!!
|
Nome motore di ricerca | Ricerca MSN Live |
!!!transactionAmount!!!
|
Importo totale delle vendite nella valuta del programma advertiser(!!!transactionCurrency!!!) | 26.09 |
!!!transactionDate!!!
|
Data della transazione nel formato %Y-%m-%d %H:%i:%s (fuso orario: UTC)
|
2013-06-13 12:05:00 |
!!!transactionId!!!
|
Il nostro ID transazione univoco | 105956531 |
!!!url!!!
|
Riferimento click URL | http://www.publisher-domain.com/advertiser/product/ |
!!!transactionCurrency!!!
|
Valuta del programma dell'advertiser. Questa è la valuta della transazione affiliata (!!!transactionAmount!!! e !!!commission!!!). Questo è il codice della valuta in maiuscolo a 3 cifre | EUR |
!!!trackedCurrency!!!
|
Valuta originale in cui è stato effettuato l'acquisto. È disponibile esclusivamente se si tratta di una valuta diversa rispetto alla valuta usata all'interno del programma. Questo è il codice della valuta in maiuscolo a 3 cifre | EUR |
!!!trackedAmount!!!
|
Importo totale nella valuta originale di acquisto (!!!trackedCurrency!!!) | 20.04 |
URL di esempio
http://www.publisher-domain.com/!!!merchantId!!!/pixel.php?clk=!!!clickRef!!!&cnv=!!!transactionId!!!&com=!!!commission!!!
Richiesta POST (JSON)
I dati di transazione verranno forniti sotto forma di pacchetto JSON utilizzando una richiesta POST con il nome AwinTransactionPush all'URL specificato. Non tutte le chiavi sono disponibili e vengono inviate per tutte le transazioni (ad esempio clickRef2 è disponibile solo per la transazione se questa è stata trasmessa nel click vincente).
Dati di esempio
echo $_POST["AwinTransactionPush"];
=
Commission {"transactionId":"105956531","transactionDate":"2013-06-13 12:05:00","transactionCurrency":"GBP","transactionAmount":"26.09","affiliateId":"45628","merchantId":"3661","groupId":"0","bannerId":"0","clickRef":"LINKCMP2013-06","clickThroughTime":"2013-06-13 12:00:00","ip":"127.0.0.1"," ":"1.64","clickTime":"2013-06-13 12:00:00","url":"http:\/\/www.publisher-domain.com\/advertiser\/product\/","phrase":"Musica elettronica","searchEngine":"MSN Live Search","commissionGroups":[{"id":"47963","name":"CD","code":"CD","description":"CD"},{"id":"47965","name":"DVD","code":"DVD","description":"DVD"}],"products":[{"productName":"The Knife \u2013 Silent Shout","unitPrice":"5.55","skuType":"","skuCode":"B000EMSUQA","quantity":"2","category":"Musica elettronica","cgId":"47963"},{"productName":"Sigur Ros - Heima","unitPrice":"14.99","skuType":"","skuCode":"B000EMSUQA","quantity":"1","category":"Music DVD","cgId":"47965"}]}
Dati di esempio decodificati JSON
var_dump(json_decode($_POST["AwinTransactionPush"], true));
=
array(17) {
["transactionId"]=>
string(9) "105956531"
["transactionDate"]=>
string(19) "2013-06-13 12.05.00"
["transactionCurrency"]=>
string(3) "GBP"
["transactionAmount"]=>
string(5) "26.09"
["trackedCurrency"]=>
string(3) "EUR"
["trackedAmount"]=>
string(5) "34,04"
["affiliateId"]=>
string(6) "45628"
["merchantId"]=>
string(4) "3661"
["groupId"]=>
string(1) "0"
["bannerId"]=>
string(1) "0"
["clickRef"]=>
string(14) "LINKCMP2013-06"
["clickRef4"]=>
string(12) "User82828211"
["clickThroughTime"]=>
string(19) "2013-06-13 12:00:00"
["commission"]=>
string(4) "1.64"
["clickTime"]=>
string(19) "2013-06-13 12:00:00"
["url"]=>
string(55) "http://www.publisher-domain.com/advertiser/product/"
["phrase"]=>
string(16) "Musica elettronica"
["searchEngine"]=>
string(15) "MSN Live Search"
["commissionGroups"]=>
array(2) {
[0]=>
array(4) {
["id"]=>
string(5) "47963"
["name"]=>
string(2) "CD"
["code"]=>
string(2) "CD"
["description"]=>
string(2) "CD"
}
[1]=>
array(4) {
["id"]=>
string(5) "47965"
["name"]=>
string(3) "DVD"
["code"]=>
string(3) "DVD"
["description"]=>
string(3) "DVD"
}
}
["products"]=>
array(2) {
[0]=>
array(7) {
["productName"]=>
string(26) "The Knife – Silent Shout"
["unitPrice"]=>
string(4) "5.55"
["skuType"]=>
string(0) ""
["skuCode"]=>
string(10) "B000EMSUQA"
["quantity"]=>
string(1) "2"
["category"]=>
string(16) "Musica elettronica"
["cgId"]=>
string(5) "47963"
}
[1]=>
array(7) {
["productName"]=>
string(17) "Sigur Ros - Heima"
["unitPrice"]=>
string(5) "14.99"
["skuType"]=>
string(0) ""
["skuCode"]=>
string(10) "B000EMSUQA"
["quantity"]=>
string(1) "1"
["category"]=>
string(9) "DVD Musica"
["cgId"]=>
string(5) "47965"
}
}
}
Se hai dei dubbi o delle domande sulla performace di questa funzionalità, ti preghiamo di contattare l'Assistenza tecnica.