Supponiamo di voler integrare il nostro sito Ecommerce con il sistema di tracciamento ordini messo a disposizione da trovaprezzi.it.

Dando un’occhiata alla relativa documentazione messa a disposizione da trovaprezzi.it troveremo immediatamente che le operazioni da eseguire per abilitare questo tipo di tracciamento sono sostanzialmente due:

• Reperire la propria chiave merchant comunicando a trovaprezzi.it l’indirizzo della pagina del sito cui viene ricondotto l’utente dopo aver completato un acquisto

(es. http://www.urlsito.it/store/cart/checkout/success)

• Inserire nella sezione < head > della pagina di cui al punto precedente il seguente codice di monitoraggio inserendo al posto dei parametri indicati tra /* */ il valore della propria chiave merchant e ovviamente i dati dell’ordine che si intende tracciare (quindi l’email del cliente che ha effettuato l’ordine, i codici dei prodotti in ordine, il totale del carrello ecc…)

<script type="text/javascript" src="https://tracking.trovaprezzi.it/javascripts/tracking.min.js" async="true"></script>

<script type="text/javascript">

window._tt = window._tt || [];

window._tt.push({ event: "setAccount", id: /* chiavemerchant */ });

window._tt.push({ event: "setOrderId", order_id: /* idordine */ });

window._tt.push({ event: "setEmail", email: /* emailcliente */ });

window._tt.push({ event: "addItem", sku: /* sku */, product_name: /* nomeprodotto */ });

window._tt.push({ event: "setAmount", amount: /* totalecarrello */ });

window._tt.push({ event: "orderSubmit"});

</script>

Ora per quel che riguarda il secondo punto, il codice di monitoraggio sopra indicato andrà inserito nella sezione “Documento” all’interno della voce di menu “Ordini – Gestione Ordini – Configurazione Ordini”

Per quel che riguarda lo script, il parametro /* chiavemerchant */ andrà sostituito con la chiave fornita da trovaprezzi.it una volta comunicatogli l’indirizzo della pagina del proprio sito cui viene ricondotto un utente dopo aver completato l’ordine.

Per le altre variabili, Passweb viene incontro allo sviluppatore mettendogli a disposizione alcune variabili in grado di popolare correttamente le variabili da passare allo script di Trovaprezzi.

Nello specifico le variabili sono:

• $texts_documentid$ (Identificativo Passweb) – Restituisce l’id dell’ordine
• $billing_email$ (Email) – Restituisce l’email associata all’ordine
• $documentItems (CICLO Articoli documento) – Restituisce un array contenente gli articoli dell’ordine. Gli elementi di questo array saranno:

• Sku – il codice dell’articolo viene popolato dalla variabile $it.entryCode$ (Codice)
• product_name – il nome dell’articolo $it.entryTitle$ (Titolo)
• $totalamount$ (Totale documento numerico)– Restituisce il totale dell’ordine

Tenendo conto di quanto detto, il codice da incollare nella sezione “Documento”, al fine di poter integrare il proprio sito con il sistema di tracciamento offerto da trovaprezzi.it sarà:

<script type="text/javascript" src="https://tracking.trovaprezzi.it/javascripts/tracking.min.js" async="true"></script>

<script type="text/javascript">

window._tt = window._tt || [];

window._tt.push({ event: "setAccount", id: 'CHIAVE MERCHANT' });

window._tt.push({ event: "setOrderId", order_id: '$texts_documentid$' });

window._tt.push({ event: "setEmail", email: '$billing_email$' });

$documentItems:{

window._tt.push({ event: "addItem", sku: '$it.entryCode$', product_name: '$it.entryTitle$' });

}$;

window._tt.push({ event: 'setAmount', amount: '$totalamount$' });

window._tt.push({ event: "orderSubmit"});

</script>

dove, ovviamente, dovremo preoccuparci soltanto di inserire la nostra specifica chiave merchant.