Panoramica

L’integrazione consiste nell’inclusione di un tag Javascript che consente di acquisire le intenzioni dell’utente durante la navigazione del sito web. Lo snippet è composto da due parti:

  • Il loader, una libreria di Javascript che deve essere dichiarata in ogni pagina e si occupa della costruzione e dell’invocazione delle chiamate ai server Transactionale.

  • Il tracker ci consente di acquisire gli eventi di navigazione dei visitatori del sito web (prodotti visti e acquistati), che quindi utilizziamo per determinare le raccomandazioni pertinenti e personalizzate.

Implementare il tracker è rapido, semplice ed invisibile per gli utenti. La qualità delle raccomandazioni dipende in modo diretto dalla qualità dell’implementazione del tracker, inclusi i tag installati in tutte le pagine, il trasferimento dei parametri corretti, etc.

Lo snippet:

  • Non altera dal punto di vista visivo il sito ed è completamente invisibile per gli utenti.
  • E’ asincrono e non rallenta il caricamento delle pagine.
  • Deve essere implementato nei punti corretti di ciascuna pagina del sito.
L’integrazione semplificata è sconsigliata per l’attività di publishing in quanto riduce quantità e qualità della profilazione automatica, e quindi riduce le performance di lead generation.

Inserisci il tag in tutte le pagine

Il tag va inserito idealmente prima del tag di chiusura </body>. Il tag include il loader, più l’evento viewPage:

<script>
    window._trx = window._trx || [];
    window._trx.push(
        { event: 'setAccount', account: '**API-KEY**', country: 'IT' },
        { event: 'viewPage' }
    );
</script>
<script src="https://static.transactionale.com/trx/v2/trx.js" async="true"></script>

Inserisci il tag trackTransaction nella pagina di conferma ordine

Puoi inserire questo prima del tag di chiusura </body>, e in ogni caso dopo il loader, cioè lo snippet che va inserito in ogni pagina mostrato nel paragrafo precedente. Dovrai riempire tutti i campi disponibili con i valori effettivi relativi all’ordine appena concluso.

ATTENZIONE: I valori d’esempio (‘xxxx’) vanno sostituiti con le relative variabili, potete eliminare i campi di cui non tracciate il loro valore. 
<script>
window._trx.push(
    {
        event: 'trackTransaction',
        transaction: {
            id: 'xxxxx', // Codice ordine
            total: xxx.xx, // Required
            currency: 'EUR' // EUR by default
        },
        // E' possibile omettere interamente l'oggetto customer se il sito non dispone di un opt-in dedicato alla cessione del dato a terzi
        customer: {
            firstName: 'nome', // Facoltativo
            lastName: 'cognome', // Facoltativo
            email: 'indirizzo@email.com', // Facoltativo
            optin: false // Facoltativo - se false i dati passati verranno scartati
        },
        // touchpointId: 123, // Mostra sempre il touchpoint indicato
        touchpointType: 'auto' // auto, web, mail
    }
);
</script>

<!-- Solo per i publisher - Indica il punto in cui mostrare il banner o gli annunci -->
<div id="tr_touchpoint_container"></div>

Utilizzando mail come touchpointType, invieremo una mail contenente le offerte selezionate solo se il campo customer.optin è impostato a true.

Selezione automatica touchpoint

Inserendo auto come touchpointType, verrà attivato automaticamente il touchpoint di tipo mail o web in base ai valori forniti. Nel caso in cui venga attivato il touchpoint di tipo web e non è stato inserito il touchpointId, il sistema utilizzerà quello di default.

Touchpoint web o auto

Se utilizzi il touchpoint web dovrai specificare dove vuoi che vengano mostrate le offerte nella tua pagina perciò dovrai inserire un <div id="tr_touchpoint_container"></div> nel punto desiderato.

Nel caso si utilizzi un touchpoint web in versione banner, è possibile scegliere due layout: orizzontale (default) oppure verticale.

Aggiungendo la classe tr-touchpoint-layout-vertical nel <div> in questo modo:
<div id="tr_touchpoint_container" class="tr-touchpoint-layout-vertical"></div>
il banner avrà layout verticale:

Verifica integrazione e webhook

Puoi verificare il corretto funzionamento dell’integrazione tecnologica e del webhook url tramite queste semplici istruzioni:

Verifica integrazione
Verifica webhook