Transaction Notification IT

From Wiki

Jump to: navigation, search

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

  1. Alla voce Avanzate troverai un link di notifica, una volta attivata questa funzionalità


  2. 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.

  3. 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.

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