Lo scambio di informazioni tra il sito e-commerce del cliente e la piattaforma Blendee avviene attraverso script di tracking asincroni non-bloccanti da installare sul sito e-commerce stesso.

Affinché tale scambio possa avvenire correttamente, occorre inserire in ogni pagina del sito web il seguente script (preferibilmente nella sezione head):

<!-- Codice Blendee INIZIO --> <script type="text/javascript">
var _sbnaq = _sbnaq || []; 
_sbnaq.push(["setDocumentTitle", {titolo}]); 
_sbnaq.push(["setLanguage", {lingua}]); 
_sbnaq.push(["setSiteId", {Id sito}]); 
_sbnaq.push(["setCatalogId", {Id catalogo}]); 
_sbnaq.push(["setSiteUserId", {Id utente}]); 
_sbnaq.push(["setPageType", {Id page type}]); 
_sbnaq.push(["{action_name}", {parameters}]);
(function() {
var u=(("https:" == document.location.protocol) ? "https" : "http") +
"://{url_tracking}/";
_sbnaq.push(["setTrackerUrl", u]);
var d=document, g=d.createElement("script"),
s=d.getElementsByTagName("script")[0]; g.type="text/javascript"; g.defer=true; g.async=true; g.src=u+"sbn.js";
s.parentNode.insertBefore(g,s); })();
</script>
<!-- Codice Blendee FINE -->

I valori scritti in corsivo tra parentesi graffe rappresentano segnaposto da impostare come indicato di seguito (i valori inseriti dovranno produrre codice javascript valido):

Ogni tipo diverso di evento da tracciare ha dei parametri specifici e soprattutto deve essere utilizzato nel giusto contesto, per fare in modo che i dati che giungono ad Blendee siano utilizzabili in maniera efficace per il cliente.

Nel caso in cui un evento non preveda parametri, è possibile specificare il parametro 0 oppure non indicare alcun parametro dopo il nome dell’evento stesso. Ad esempio le due istruzioni javascript sono equivalenti:

_sbnaq.push(["trkPageView", 0]) 
_sbnaq.push(["trkPageView"])

Gli eventi da tracciare possono essere forniti anche tramite chiamata diretta Javascript invocando il nome dell’evento sull’oggetto Sbntrk. Si veda ad esempio il seguente codice:

if (Sbntrk) {
Sbntrk.trkProductSale(
'GRP005', '2', '', '50.00', '60.00', '5.00', 'EUR', 0, 1, '2015-10-12T10:20:20'
); }

Tale codice è comunque equivalente al seguente, che rimane sempre utilizzabile:

_sbnaq.push(["trkProductSale",'GRP005','2','','50.00','60.00','5.00','EUR ',0,1,'2015-10-12T10:20:20']);

Segue l’elenco degli eventi utilizzabili (l’ordine dei parametri va rispettato):

Nome evento	Contesto	Parametri	Descrizione parametri
trkPageView	Evento generico per tracciare la view di una pagina	–	–
trkCategoryView	Evento da inserire nella pagina dedicata ad una categoria merceologica	categoryId	Identificativo della Categoria corrente (deve corrispondere al dato fornito sui flussi CSV).
trkProductView	Evento da fornire nella pagina di dettaglio di un prodotto.	productId [, categoryId, brand]	Identificativo del prodotto visualizzato (deve corrispondere al dato fornito sui flussi CSV). Opzionali: categoryId: categoria del prodottobrand: nome del brand del prodotto
trkProductBasketAdd	Evento da fornire quando l’utente aggiunge un prodotto al carrello.	productId	Identificativo del prodotto aggiunto al carrello (deve corrispondere al dato fornito sui flussi CSV).
		[cartId]	Identificativo del carrello corrente. Opzionale.
trkProductBasketRemove	Evento da fornire quando l’utente rimuove un prodotto dal carrello.	productId	Identificativo del prodotto rimosso dal carrello (deve corrispondere al dato fornito sui flussi CSV).
		[cartId]	Identificativo del carrello corrente. Opzionale.
trkProductSale	Evento da fornire quando l’utente effettua un ordine di acquisto di uno o più prodotti	groupNumber	Identificativo alfanumerico dell’ordine effettuato. Questo dato è l’elemento che raggruppa più prodotti acquistati in uno stesso momento.
		productId	Identificativo del prodotto aggiunto al carrello (deve corrispondere al dato fornito sui flussi CSV).
		quantity	Quantità acquistata (valore intero maggiore o uguale a 1).
		coupon	Codice di un eventuale coupon utilizzato dall’utente. Nel caso di più prodotti nello stesso ordine, può essere fornito una sola volta.
		price	Importo del prodotto acquistato, senza iva o tasse equivalenti.
		priceWithTax	Importo del prodotto con iva o tasse equivalenti.
		deliveryPrice	Spese di spedizione. Nel caso di più prodotti nello stesso ordine, può essere fornito una sola volta.
		currency	Valuta (Standard ISO 4217 (http://it.wikipedia.org/wiki/ISO_4217)).
		ts	Timestamp dell’acquisto nel formato YYYY-MM-DDTHH:mm:SS
		expiration	Data di scadenza dell’articolo acquistato. Opzionale. Se fornito deve avere il formato YYYY-MM-DD
trkProductsSale	Evento alternativo a trkProductSale che permette di registrare l’acquisto di più prodotti in un’unica chiamata	productsArray	Array di oggetti contenenti i campi utilizzati nella chiamata trkProductSale. es: [[‘GRP005’, ‘2’, ‘1’, ”, ‘50.00’, ‘60.00’, ‘5.00’, ‘EUR’, ‘2015-10-12T10:20:20’],    [‘GRP005’, ‘4’, ‘2’, ”, ‘30.00’, ‘60.00’, ‘0.00’, ‘EUR’, ‘2015-10-12T10:20:20’]]
trkProductLocalSearch	Ricerca effettuata nel sito del cliente da un utente	kw	Keyword utilizzata dell’utente.
trkUserRegistration	Registrazione di un nuovo utente	userId	Identificativo dell’utente registrato sul sito. Questo valore dovrà essere corrispondente a quello fornito sul flusso CSV degli utenti.
		[email]	Indirizzo email dell’utente che sta effettuando la registrazione.Opzionale.
trkNewsletterSubscription	Registrazione newsletter di un nuovo utente	[Email]*	stringa, campo obbligatorio,
		[Nome]	stringa, campo NON obbligatori
		[Cognome]	stringa, campo NON obbligatorio
		[f_ricevi_newsletter]*	boleano, campo obbligatorio
		[f_ricevi_comunicazioni_commerciali]*	boleano, campo obbligatorio
		[Lista_email]	stringa, campo NON obbligatorio, Codice Lista email, da valorizzare se si vuole iscrivere un utente ad una lista mail
		[double_optin]	boleano, campo obbligatorio, da mettere sempre a 1 per garantire l’invio delle del double optin
trkNewsletterUnsubscribe	Disiscrizione di un utente dalla newsletter	[email]*	stringa, campo obbligatorio.