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.
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:
- Le informazioni sul carrello della spesa (dati del Tag "Stato attuale del carrello della spesa").
- Le informazioni del contatto attuale (dati del Tag "Informazioni del contatto").
- Le informazioni sull'abbonamento alle notifiche Web Push (maggiori informazioni in Funzioni Web Push).
- I contenitori disponibili per il posizionamento dei banner (dati del Tag "Banner").
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"). |
| 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"). |
| 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"). |
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:
- Notificare evento di pagina visitata.
- Notificare evento di prodotto visitato.
- Notificare evento di acquisto effettuato.
- Notificare informazioni del carrello.
- Notificare informazioni del contatto.
- Notificare evento di ricerca.
- Notificare evento di iscrizione alla newsletter.
- Notificare evento di login.
- Notificare evento di registrazione.
- Notificare evento personalizzato.
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:
- Aggiungere il JavaScript di Connectif al tuo sito web, per inserire il codice e iniziare a raccogliere informazioni sulle visite al tuo sito.
- Integrazione tramite tag, per conoscere tutte le notifiche che puoi inviare dal tuo eCommerce a Connectif e il loro funzionamento.
- Integrazione con Connectif via API, per sincronizzare contatti, prodotti, acquisti e coupon.
- Verificare l'integrazione con l'eCommerce, per assicurarti che tutti i dati vengano sincronizzati correttamente nel tuo account Connectif.