Le regole trigger sono il cuore di MagicAI Engage: decidono chi viene contattato, su quali canali e come viene misurato il contatto. Questo articolo tratta le nove regole predefinite, come creare e modificare una regola, i campi delle condizioni e gli operatori, i canali di recapito e i percorsi, il test A/B, il salvataggio e l'attivazione, le protezioni di messaggistica e come la priorità risolve i membri che corrispondono a più regole contemporaneamente.
Contenuti
- Le nove regole trigger predefinite
- Creare e modificare una regola trigger
- Condizioni: chi viene preso di mira
- Riferimento dei campi delle condizioni
- Operatori
- Filtro per tipo di contratto
- Canali: come vengono raggiunti i membri
- Percorso di recapito: diretto o tramite l'agente AI
- Test A/B
- Protezioni di messaggistica
- Salvare e attivare
- Priorità e risoluzione delle corrispondenze multiple
- Integrazione con MagicAI Chat
Le nove regole trigger predefinite
Nove regole predefinite vengono create automaticamente quando Lei crea una configurazione, ordinate per priorità (la posizione 0 viene eseguita per prima). Partono tutte inattive.
| Priorità | Regola | Categoria | Condizione predefinita | Cooldown |
|---|---|---|---|---|
| 0 | Churn Risk | Churn Risk | Churn risk band ≥ High | 30 giorni |
| 1 | New Joiner Churn 3M | New Joiner Churn | New joiner churn band 3M ≥ High | 30 giorni |
| 2 | New Joiner Churn 6M | New Joiner Churn | New joiner churn band 6M ≥ High | 30 giorni |
| 3 | New Joiner Churn 12M | New Joiner Churn | New joiner churn band 12M ≥ High | 30 giorni |
| 4 | Dormancy | Dormancy | Days since last visit > 15 | 30 giorni |
| 5 | Attendance Drop | Attendance Drop | Sta sbandando = Yes | 14 giorni |
| 6 | Contract Expiry | Contract Expiry | Days until contract end ≤ 30 | 14 giorni |
| 7 | New Member | New Member | Days since contract start < 14 | 7 giorni |
| 8 | Custom | Custom | Nessuna (ne aggiunga una propria) | 7 giorni |
Nella build attuale, le regole da 0 a 3 sono di tipo AI Model; le regole da 4 a 8 sono di tipo Custom Rule. Queste impostazioni predefinite sono punti di partenza. Può modificare liberamente condizioni, canali, cooldown e priorità.
Al momento del rilascio è presente una regola Custom integrata (priorità 8, regola n. 9), che Lei configura come qualsiasi altra regola. In una release successiva, gli operatori potranno inoltre creare le proprie regole personalizzate, fino a 5 per pubblico Members, come trigger a messaggio singolo (non come flussi di follow-up dinamici).
Le nove regole precedenti appartengono tutte al pubblico Members. Altri due trigger vengono eseguiti su pubblici propri basati su eventi. Sul pubblico Leads, un trigger New-Lead welcome (benvenuto nuovo lead) si attiva alla creazione di un nuovo lead e lo contatta una volta. Sul pubblico Former Members, un trigger win-back (riconquista) contatta un membro che ha disdetto, una sola volta, alla data di disdetta più un numero configurabile di giorni (impostazione predefinita 30), e mai più di una volta per membro. Entrambi sono basati su eventi anziché pianificati nel batch giornaliero, ed entrambi restano al di fuori della suddivisione A/B.
Cosa significano le categorie:
- Churn Risk: membri con una fascia di rischio abbandono generale elevata. È la regola di fidelizzazione più ampia.
- New Joiner Churn: membri nel loro primo anno il cui comportamento iniziale suggerisce un rischio abbandono elevato. Valutati da modelli dedicati 42 giorni (6 settimane) dopo l'inizio del contratto, su tre orizzonti di disdetta (3, 6 e 12 mesi). Vedere anche: Il segnale di rischio abbandono (churn risk).
- Dormancy: membri che hanno smesso del tutto di frequentare. La soglia predefinita è 15 giorni dall'ultima visita. È la Sua regola "ci manchi".
- Attendance Drop: membri che frequentano ancora ma sensibilmente meno spesso. Distinta dalla dormancy: il membro è attivo ma in calo, il che è spesso il segnale più precoce e più utile su cui agire.
- Contract Expiry: membri il cui contratto termina a breve. La usi per riattivare l'interesse prima che venga presa una decisione di disdetta. Un contratto nel suo periodo di preavviso di disdetta è ancora attivo fino alla data di fine.
- New Member: membri che si sono appena iscritti. La usi per dare loro il benvenuto e guidarli nell'onboarding durante le prime due settimane, che sono cruciali.
- Custom: nessuna condizione predefinita. Costruisca qualsiasi logica di targeting a partire dai campi delle condizioni disponibili.
Creare e modificare una regola trigger
Espanda la riga di una regola nella scheda Configuration per modificarla. L'editor è organizzato in WHO (condizioni di targeting), HOW (canali di recapito), WHEN (cooldown del trigger) e A/B testing. Un banner riepilogativo in alto traduce la regola in linguaggio semplice, la scheda Rule Info mostra tipo, categoria, priorità e numero di canali, e la scheda Audience mostra quanti membri corrispondono attualmente.
L'editor della regola (Churn Risk): condizioni WHO, canali HOW, cooldown WHEN e test A/B in un unico posto, con un conteggio del pubblico in tempo reale.
Condizioni: chi viene preso di mira
Aggiunga almeno una condizione. Quando una regola ha più condizioni, un membro deve corrispondere a tutte. Le condizioni vengono valutate su uno snapshot dei dati dei membri che si aggiorna una volta al giorno, quindi una regola vede sempre lo stato di ciascun membro all'ultimo aggiornamento.
Riferimento dei campi delle condizioni
I campi delle condizioni qui sotto possono essere combinati in qualsiasi regola; i campi non sono limitati per categoria e compaiono come un unico elenco piatto nel menu a discesa. La condizione che definisce una regola predefinita è modificabile ed eliminabile, non bloccata.
| Campo | Cosa contiene e come viene calcolato |
|---|---|
| Churn risk | La fascia di rischio abbandono generale: Very Low, Low, Medium, High o Very High. Vuota quando il membro non ha alcuna fascia (nessun consenso al marketing, nessun contratto attivo, minore di 18 anni o dati insufficienti). I confronti sono ordinati, quindi "≥ High" corrisponde a High e Very High. |
| New joiner churn risk (3M) | Fascia di rischio dal modello dedicato ai nuovi iscritti sull'orizzonte di disdetta di 3 mesi, usando le stesse cinque fasce. Disponibile una volta che il membro è stato valutato; vuota prima di allora. |
| New joiner churn risk (6M) | Fascia di rischio dal modello per nuovi iscritti sull'orizzonte di disdetta di 6 mesi, usando le stesse cinque fasce. |
| New joiner churn risk (12M) | Fascia di rischio dal modello per nuovi iscritti sull'orizzonte di disdetta di 12 mesi, usando le stesse cinque fasce. |
| Days Until Contract End | Giorni interi tra oggi e la data di fine prevista del contratto. Vuoto per i contratti a tempo indeterminato. La regola predefinita Contract Expiry usa "≤ 30". |
| Days Since Last Visit | Giorni interi dall'ultimo check-in del membro. 0 significa che ha visitato oggi. Vuoto se il membro non ha visitato negli ultimi 12 mesi. La regola predefinita Dormancy usa "> 15". |
| Days Since Contract Start | Giorni interi tra la data di inizio del contratto e oggi. La regola predefinita New Member usa "< 14". |
| Days Since Cancellation | Giorni interi da quando è stata registrata la disdetta. Solo i contratti disdetti hanno un valore. |
| Visits (Last 14 Days) | Numero di check-in nella finestra mobile di 14 giorni che termina oggi. |
| Visits (Last 60 Days) | Numero di check-in nella finestra mobile di 60 giorni che termina oggi. |
| Contract Type | Il tipo del contratto di abbonamento principale del membro. Funziona con =, ≠ e contains. È disponibile anche come filtro sul tipo di contratto (include/exclude) valido per l'intera regola. |
| Contract price | Prezzo addebitato per l'attuale periodo di pagamento del contratto. |
| Payment frequency | Con quale frequenza viene fatturato il contratto, ad esempio mensile, trimestrale o annuale. |
| Contract extension | Modello di rinnovo del contratto, ad esempio a tempo determinato o con rinnovo automatico. |
| Payment method | Il metodo di pagamento configurato del membro, ad esempio addebito diretto, carta o contanti. |
| Payment type | Tipo di modalità di pagamento associata al contratto. |
| Payment interval unit | Unità di tempo usata per la fatturazione, ad esempio giorno, settimana, mese o anno. |
| Payment interval length | Numero di unità di intervallo di pagamento tra gli addebiti. Per esempio, 3 mesi indica una fatturazione trimestrale. |
| Pre-use type | Configurazione per il periodo precedente all'utilizzo del contratto. |
| Contract term | Durata del contratto in mesi. I termini memorizzati in settimane o giorni vengono convertiti usando una durata media del mese. |
| Days since contract created | Giorni interi da quando l'attuale contratto è stato creato nel sistema, che può differire dalla data di inizio del contratto. |
| Days since last collection | Numero di giorni dall'ultima data di incasso del pagamento. |
| Last payment amount | Importo totale previsto dell'ultimo incasso del pagamento. |
| Last payment paid amount | Importo effettivamente pagato per l'ultimo incasso dopo le rettifiche. |
| Attendance trend | Direzione recente della frequenza. I valori includono very high increase, slight increase, normal, slight decrease, very high decrease e no data. |
| Is drifting | Se il membro sta perdendo l'abitudine all'allenamento: Yes quando ha avuto 3 o più check-in nelle due settimane precedenti l'ultima (giorni 15-28) e solo 1 o 2 check-in nell'ultima quindicina (giorni 1-14), altrimenti No. La regola predefinita Attendance Drop usa "= Yes". |
| Origin type | La fonte di acquisizione che ha creato il lead, ad esempio una landing page, una pagina offerta personalizzata o MySports. Usi contains MySports per coprire in un'unica regola MySports, MySports App e MySports Web; is MySports non include i valori App e Web. Utilizzato principalmente dai trigger sui lead; veda Configurare il trigger New lead in Engage. |
I campi delle condizioni WHO offerti nel menu a discesa.
Operatori
Quali operatori vengono offerti dipende dal tipo di campo. Un campo di tipo risk-band (fascia di rischio) ne offre quattro (≥, ≤, =, ≠). Un campo numerico ne offre cinque (>, ≥, <, ≤, =, senza ≠). Il campo contract type (tipo di contratto) offre =, ≠ e contains.
| Operatore | Funziona con | Significato |
|---|---|---|
| > | Campi numerici | Il valore del membro è strettamente maggiore della soglia |
| ≥ | Campi numerici, fasce di rischio | Il valore del membro è maggiore o uguale alla soglia |
| < | Campi numerici | Il valore del membro è strettamente minore della soglia |
| ≤ | Campi numerici, fasce di rischio | Il valore del membro è minore o uguale alla soglia |
| = | Campi numerici, fasce di rischio, tipo di contratto | Il valore del membro è esattamente uguale alla soglia |
| ≠ | Fasce di rischio, tipo di contratto | Il valore del membro non è uguale alla soglia |
| contains | Tipo di contratto | Il valore del membro contiene la soglia come sottostringa (senza distinzione tra maiuscole e minuscole) |
Le fasce di rischio si confrontano in questo ordine: Very Low < Low < Medium < High < Very High.
Filtro per tipo di contratto
Indipendentemente dalle condizioni, può includere o escludere tipi di contratto specifici per l'intera regola. La usi, ad esempio, per tenere i contratti di prova o aziendali fuori dalle campagne di fidelizzazione.
Canali: come vengono raggiunti i membri
Aggiunga almeno un canale. Ogni canale richiede un modello di messaggio (creato nella scheda Templates). Solo WhatsApp offre un percorso con agente AI; Email, SMS e la push della MySports App sono invii diretti e unidirezionali.
| Canale | Modello | Agente |
|---|---|---|
| Obbligatorio ("WhatsApp requires a template"). Usa la connessione Meta e un modello approvato da Meta. Vedere anche: Configurare WhatsApp per Engage. | AI Chatbot (bidirezionale). Recapitato tramite l'agente MagicAI Chat, così il membro può rispondere. | |
| Obbligatorio. Inviato all'indirizzo email del membro presente in archivio; i membri senza indirizzo vengono saltati per questo canale. | Nessuno (diretto) | |
| SMS | Obbligatorio. Inviato al numero di cellulare del membro presente in archivio; i membri senza numero vengono saltati per questo canale. | Nessuno (diretto) |
| MySports App | Obbligatorio. Notifica push tramite la MySports App; richiede che l'app sia attivata per lo studio. | Nessuno (diretto) |
I canali e il percorso dell'agente nel passaggio HOW: solo WhatsApp può essere supportato dall'agente (tramite l'agente AI MagicAI Chat); Email, SMS e la push della MySports App sono unidirezionali.
Un modello predefinito è fornito per ciascun trigger e per ciascun canale, così ogni regola ha qualcosa da inviare fin dall'inizio. Modifichi questi modelli oppure ne crei di propri nella scheda Templates.
Percorso di recapito: diretto o tramite l'agente AI
Ogni recapito viene registrato con uno di due percorsi, mostrato nella colonna Path della scheda Delivery:
- One-way (unidirezionale): il messaggio va direttamente al membro tramite il provider del canale (provider email, gateway SMS e così via).
- Agent (agente): il messaggio viene recapitato tramite l'agente MagicAI Chat. Il contatto arriva come conversazione di chat, il membro può rispondere e l'agente AI gestisce il follow-up.
Il percorso non si sceglie con un selettore separato. È determinato dal fatto che Lei configuri o meno un agente sul canale nell'editor della regola: se il canale WhatsApp di una regola ha un agente configurato, il recapito usa il percorso Agent; altrimenti è One-way.
Prerequisito: il recapito tramite l'agente AI richiede una configurazione MagicAI Chat attiva. Senza di essa, il messaggio esce come normale invio unidirezionale. La push della MySports App è sempre una notifica unidirezionale.
Test A/B
Il test A/B si configura una sola volta, globalmente, per il pubblico Members, in cima alla scheda Configuration. È facoltativo e disattivato per impostazione predefinita; finché è disattivato, tutti i membri corrispondenti ricevono i messaggi.
- Quando è attivo, Lei imposta la suddivisione tra il gruppo di trattamento (Group A, contattato) e il gruppo di controllo (Group B, trattenuto). Vengono offerti tre preset: 90/10, 80/20 e 50/50. 80/20 è una buona impostazione predefinita per la maggior parte degli studi.
- La suddivisione è globale per il pubblico Members: ogni membro mantiene lo stesso gruppo per ogni trigger e ogni esecuzione. Un membro nel gruppo di controllo non riceve messaggi da alcun trigger Members e compare nel log di recapito come controllo (non contattato).
- Un'unica suddivisione globale, anziché una suddivisione separata per ogni trigger, mantiene pulita la misurazione. Una suddivisione per trigger potrebbe collocare lo stesso membro nel trattamento sotto un trigger e nel controllo sotto un altro, il che annullerebbe il valore dell'analisi dell'impatto.
- Leads e Former Members restano al di fuori della suddivisione: i loro trigger basati su eventi inviano sempre a chiunque corrisponda.
Il compromesso è deliberato: il gruppo di controllo non riceve alcun contatto, quindi Lei rinuncia a un po' di copertura a breve termine in cambio del sapere se il contatto funziona. Vedere anche: Impact Analysis.
Test A/B globale, solo Members, con i preset 90/10, 80/20 e 50/50 e i conteggi in tempo reale di trattamento/controllo.
Protezioni di messaggistica
Engage dispone di una protezione integrata contro l'eccesso di messaggi. Due protezioni sono configurate su ciascuna regola trigger e tramite la priorità; altre due sono impostazioni globali sulla scheda Delivery.
- Cooldown per regola. Configurato in giorni su ciascuna regola trigger. Se un membro ha ricevuto un messaggio inviato da questa specifica regola negli ultimi N giorni, viene saltato. Impostazioni predefinite: 30 giorni per Churn Risk, New Joiner Churn e Dormancy; 14 giorni per Attendance Drop e Contract Expiry; 7 giorni per New Member e Custom. Impostare il cooldown a 0 lo disattiva per quella regola.
- Deduplicazione delle corrispondenze multiple. Nell'ambito di una singola esecuzione giornaliera, un membro può essere contattato da una sola regola (veda Priorità e risoluzione delle corrispondenze multiple, qui sotto).
- Le ore di silenzio (quiet hours) e i limiti di frequenza giornalieri e settimanali sono impostazioni globali configurate sulla scheda Delivery e condivise da tutti gli studi collegati alla configurazione. Vedere anche: Esecuzione dei trigger (pianificazione, anteprima e log di esecuzione) per come vengono configurate e come si comportano.
Salvare e attivare
- Al salvataggio, ogni regola deve avere almeno una condizione e un canale, e ogni condizione deve avere un valore. La regola Custom viene fornita senza condizione, quindi deve aggiungerne una prima di poterla attivare.
- Imposti ogni regola su active (attiva) o inactive (inattiva). Solo le regole attive vengono eseguite nel batch giornaliero.
- Imposti la priorità spostando le regole in alto o in basso nell'elenco. La priorità determina quale regola prevale quando un membro corrisponde a più di una (veda sotto).
Priorità e risoluzione delle corrispondenze multiple
Un membro può facilmente corrispondere a più regole contemporaneamente: qualcuno con un rischio abbandono elevato che non frequenta da tre settimane corrisponde sia alla regola Churn Risk sia alla regola Dormancy. Engage risolve la cosa con una regola semplice.
La prima rivendicazione vince. Se un membro corrisponde a più regole attive, la regola con la priorità più alta (numero di posizione più basso) lo contatta per prima. Le regole a priorità inferiore saltano quel membro per la stessa esecuzione giornaliera, così nessun membro riceve più di un messaggio per esecuzione giornaliera.
Come funziona in pratica:
- Le regole vengono eseguite in ordine di priorità, prima la posizione 0. Lei imposta l'ordine spostando le regole in alto o in basso nella scheda Configuration.
- Quando una regola contatta un membro, quel membro viene rivendicato per il resto dell'esecuzione giornaliera. Le regole a priorità inferiore registrano il membro come "Skipped (dedup)".
- La deduplicazione si applica all'interno di una singola esecuzione giornaliera di un singolo studio. Il giorno successivo, il membro può corrispondere di nuovo (nel rispetto dei cooldown e dei limiti di frequenza).
- Le esecuzioni manuali ("Run now") non effettuano la deduplicazione rispetto alle altre regole dell'esecuzione giornaliera; un'esecuzione manuale è a sé stante.
Metta in cima le Sue regole più importanti. Se la fidelizzazione è la Sua priorità, mantenga Churn Risk in posizione 0 così che i membri a rischio ricevano sempre il messaggio di fidelizzazione anziché uno generico.
Integrazione con MagicAI Chat
Quando un canale recapita tramite l'agente AI, il contatto arriva come conversazione di chat anziché come messaggio unidirezionale. Il membro può rispondere e l'agente MagicAI Chat prosegue la conversazione. Questo trasforma una sollecitazione di fidelizzazione in un dialogo: il membro può informarsi sugli orari dei corsi, prenotare una sessione o esporre una preoccupazione direttamente nel thread.
- Prerequisito: una configurazione MagicAI Chat attiva per l'organizzazione.
- Come attivarla: configuri un agente AI sul canale WhatsApp di una regola trigger. Non esiste una scheda MagicAI Chat separata in Engage; l'integrazione è semplicemente il percorso di recapito con agente di un canale.
- Senza una configurazione di chat: il messaggio esce come normale invio unidirezionale. I membri non possono rispondere all'interno di una conversazione.
Vedere anche: Configurare MagicAI Chat. Vedere anche: Configurare WhatsApp per Engage.