Concetto
Tracciamento degli eventi
Registra ciò che le persone fanno nella tua app e sul tuo sito come eventi di workspace o personalizzati, collegali ai contatti e ricevili nei webhook.
Il tracciamento degli eventi ti permette di registrare ciò che le persone fanno nel tuo prodotto: un ordine, un cambio di piano, una registrazione, la visualizzazione di un prodotto. Invii gli eventi dal tuo sito web con lo script di tracciamento o dai tuoi server con l’API. Emailit li salva accanto agli eventi che registra da sé, li collega ai contatti e può inviarli ai tuoi webhook.
Il tracciamento degli eventi è incluso nei piani Pro, Business e Custom. Con Pay as you go, l’invio di eventi e la definizione di eventi di workspace restituiscono 403 con "error": "plan_required", e le richieste dello script di tracciamento vengono rifiutate.
Tre ambiti di eventi
Ogni evento ha un tipo, e il suo prefisso ne indica l’ambito:
| Ambito | Tipo | Chi lo definisce | Esempio |
|---|---|---|---|
| Sistema | <name> |
Emailit. Questi eventi registrano ciò che succede alle email, ai contatti e alle altre risorse. Non puoi inviarli. | email.delivered |
| Workspace | w:<name> |
Il tuo workspace. Prima dichiari l’evento e il tipo di ogni proprietà, ed Emailit rifiuta gli eventi che non corrispondono. | w:customer.type |
| Personalizzato | c:<name> |
Nessuno. Qualsiasi nome, con qualsiasi oggetto JSON come proprietà. | c:order.completed |
Usa un evento di workspace quando più sistemi inviano lo stesso evento e vuoi che restino coerenti, o quando le persone del tuo team si basano sui suoi campi. Usa un evento personalizzato quando vuoi mantenere la tua struttura dei dati, ad esempio il formato degli ordini del tuo negozio, senza dichiararla prima. Puoi iniziare con un evento personalizzato e definirlo in seguito come evento di workspace; i due sono tipi distinti, quindi c:order.completed e w:order.completed non si mescolano.
Nomi degli eventi
I nomi hanno da 1 a 100 caratteri tra lettere, cifre, punti, trattini e trattini bassi, e iniziano con una lettera o una cifra: customer.type, order-completed, cart_updated. I nomi distinguono tra maiuscole e minuscole.
I nomi delle proprietà degli eventi di workspace seguono le stesse regole, ma senza punti, perché i filtri dei webhook e i template usano i punti per raggiungere i valori annidati.
Come inviare gli eventi
| Da | Come | Credenziali |
|---|---|---|
| Il tuo sito web | Lo script di tracciamento | Una chiave di tracciamento pubblica, limitata ai tuoi siti |
| I tuoi server | Invia un evento o Invia eventi in batch | Una chiave API con Full Access o Events Only. Vedi Invia eventi dal tuo backend. |
| Il pannello | Send event in Email APIEvents | Il tuo account. Serve a testare un webhook o un’integrazione. |
Gli eventi che riguardano denaro, come ordini e pagamenti, è meglio inviarli dai tuoi server. Gli eventi del browser possono essere bloccati, e chiunque può inviare eventi con una chiave pubblica.
Eventi e contatti
Un evento può indicare la persona a cui si riferisce, con email o con contact_id.
- I contatti vengono cercati, mai creati. Se nessun contatto ha quell’email, l’indirizzo viene comunque salvato e l’evento compare nell’attività del contatto quando lo crei.
- Un
contact_iddeve appartenere a un contatto del workspace. - Gli eventi senza una persona possono contenere un
anonymous_id. Lo script di tracciamento ne aggiunge uno a ogni evento che invia.
Gli eventi collegati a un contatto compaiono nella sezione Activity log del contatto, accanto alle email che ha ricevuto. Lì gli eventi di workspace con un titolo mostrano il titolo.
Dove finiscono gli eventi
- Il log degli eventi. Email APIEvents elenca ogni evento nella scheda Log. Filtra per Scope per vedere solo gli eventi di sistema, di workspace o personalizzati. Con l’API, usa il parametro
scopedi Elenca gli eventi. - Webhook. Un webhook può sottoscrivere un tipo come
c:order.completed, oppure tutti gli eventi di workspace o personalizzati conw:*ec:*. Un webhook con All events attivo non li riceve, a meno che tu non scelga anche questi. Vedi Tipi di evento. - Contatti. Vedi Eventi e contatti.
- Automazioni. Un trigger Custom event avvia un’esecuzione per il contatto dell’evento, facoltativamente solo quando le sue proprietà corrispondono. Gli stessi eventi possono terminare le esecuzioni, soddisfare obiettivi e far riprendere i passaggi Wait until. Lo fanno solo gli eventi che invii dal tuo server con l’API degli eventi: chiunque abbia la tua chiave di tracciamento pubblica può attribuire a un visitatore l’identità che vuole, quindi gli eventi dello script di tracciamento vengono registrati e arrivano ai webhook, ma non avviano, non terminano e non fanno avanzare le esecuzioni. Il trigger Custom event è incluso nei piani Business e Custom, mentre le condizioni di uscita, gli obiettivi e le attese su questi eventi sono inclusi nei piani Pro, Business e Custom. Vedi Condizioni di uscita e obiettivi.
Conservazione
Gli eventi rientrano nei Logs del workspace, quindi vengono conservati per il periodo di conservazione dei log del piano, poi eliminati. Vedi Conservazione dei dati. Conserva nei tuoi sistemi gli ordini e gli altri dati che ti servono più a lungo.
Limiti
| Pay as you go | Pro | Business | Custom | |
|---|---|---|---|---|
| Tipi di eventi di workspace e personalizzati | — | 100 | 1000 | Illimitati |
| Script di tracciamento del sito web | — | Incluso | Incluso | Incluso |
- I tipi di evento sono i tipi distinti di eventi di workspace e personalizzati che un workspace invia, come
c:order.completedew:customer.type. I tipi già inviati in precedenza continuano a funzionare. Quando il workspace ha usato il numero di tipi previsto dal piano, gli eventi di un nuovo tipo vengono rifiutati con422. - Eventi di workspace: tanti quanti i tipi di evento del piano, ciascuno con un massimo di 50 proprietà.
- Proprietà degli eventi personalizzati fino a 32 KB di JSON, annidate fino a 8 livelli.
- Fino a 100 eventi per richiesta batch.
- 25 chiavi di tracciamento per workspace.
Per gli altri limiti, vedi Limiti e quote.