1. Centro assistenza
  2. Integra il tuo Negozio
  3. Integrazione personalizzata
  4. Tramite eventi JavaScript
  5. Aggiungere e configurare il JavaScript di Connectif

Invia un elenco di eventi utilizzando connectif.managed.sendEvents.

Creato
Aggiornato
Segui

La funzione "connectif.managed.sendEvents" serve per inviare a Connectif un elenco di eventi, insieme al resto delle informazioni aggiuntive che potrebbero essere presenti sulla pagina. Grazie a questa funzione, è possibile notificare tramite JavaScript qualsiasi tipo di evento senza la necessità di implementare i tag. 

È consigliabile, quando possibile, utilizzare managed.sendEvents raggruppando tutti gli eventi concorrenti in un unico invio. Questo consente di: 

  • Semplificare l'integrazione effettuando meno chiamate. 

  • Tutti gli eventi sono registrati in modo realmente simultaneo, evitando incoerenze nel tracciamento. 

  • Ridurre, in determinate circostanze, il consumo di attività dell’account. 

  

Questo articolo fa parte della guida per creare un'integrazione su misura.
Se la tua integrazione avviene tramite modulo, questa funzione verrà inserita automaticamente nel tuo eCommerce.

 

Come si usa

La funzione "connectif.managed.sendEvents" invia automaticamente i seguenti dati:

  

Questa funzione può ricevere, opzionalmente, un array di oggetti di tipo "evento". Se non viene specificato alcun evento, verranno inviati a Connectif i dati dell'elenco precedente senza un evento specifico. Questo può risultare utile per risincronizzare il carrello della spesa o l'email senza dover ricaricare completamente la pagina.

Requisiti

È importante che l'uso di questa funzione avvenga quando Connectif è stato inizializzato. 

const isConnectifInitialized = window.connectif?.managed?.isInitialized();

Nel caso in cui non lo sia, sarà necessario attendere l'evento "connectif.managed.initialized".

Di seguito un esempio di come inviare eventi assicurandosi che Connectif sia inizializzato:

function trackPageVisit() {
    window.connectif.managed.sendEvents([{ type: 'page-visit' }]);
}

if (window.connectif && 
    window.connectif.managed &&
    window.connectif.managed.isInitialized()) {
    trackPageVisit();
} else {
    document.addEventListener("connectif.managed.initialized", function onConnectifInitialized() {
        trackPageVisit();
    },
    { once: true });
}

 

Inviare informazioni dell'oggetto "options"

La funzione può anche ricevere opzionalmente un secondo oggetto "options", che può contenere alcuni dei seguenti campi:

Nome Obbligatorio Tipo Descrizione
options.onResponded No function Callback che verrà chiamato una volta che gli eventi saranno stati inviati a Connectif.
options.cart No object Indica l'oggetto di tipo Carrello della Spesa che verrà inviato a Connectif (invece di prendere il carrello dal Tag "Stato attuale del carrello della spesa").
Maggiori informazioni in Notificare informazioni del carrello.
options.entityInfo No object Indica l'oggetto con le informazioni del Contatto che verrà inviato a Connectif (invece di prenderlo dal Tag "Informazioni del contatto").
Maggiori informazioni in Notificare informazioni del contatto.
options.pageInfo No object Indica l'oggetto con le informazioni della pagina che arricchisce l'evento di pagina visitata (invece di prenderlo dai metadati della pagina e dai tag Tag "Categoria della pagina" e Tag "Etichetta della pagina").
Maggiori informazioni in Notificare evento di pagina visitata.
  

Dopo aver ricevuto una risposta da Connectif, la funzione si occuperà di attivare le azioni che potrebbero essere state definite dai flussi di Workflows, come mostrare un contenuto inline, un popup, ecc.

 

Esempi

Di seguito un esempio di come utilizzare questa funzione per monitorare i diversi eventi:

 

 

Congratulazioni!
Hai raggiunto la fine della lezione.

  

Hai ancora dubbi irrisolti?
Ricorda che hai a disposizione i nostri specialisti in Connectif. Per contattarli, ti basterà aprire un ticket di Supporto cliccando sul pulsante blu "Aiuto" nella tua dashboard.

Continua a imparare!

Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di proseguire con i seguenti articoli: