Una volta impostate le regole trigger, tutto ciò che riguarda la loro esecuzione risiede nella scheda Delivery. Questo articolo tratta la pianificazione giornaliera, le esecuzioni manuali e i test su singolo membro, le protezioni delle ore di silenzio e dei limiti di frequenza, il funzionamento di Preview e il riferimento completo del log di esecuzione, incluse colonne, valori di stato e motivi di skip del backend.
Contenuti
- Pianificazione ed esecuzione
- Ore di silenzio e limiti di frequenza
- La catena completa di idoneità
- Preview
- Riferimento del log di esecuzione
- Colonne
- Valori di stato
- Motivi di skip del backend
Pianificazione ed esecuzione
Tutto ciò che riguarda l'esecuzione dei trigger risiede nella scheda Delivery: la pianificazione giornaliera, le ore di silenzio, i limiti di frequenza e il pannello Execute Triggers. Alcuni elementi all'interno della scheda mantengono la dicitura Execution (per esempio Execution Results, Execution Run ed Executed At).
La scheda Delivery: pianificazione giornaliera, ore di silenzio, limiti di frequenza ed esecuzioni manuali in un unico posto.
Pianificazione giornaliera
- Imposti un orario e un fuso orario sulla configurazione e attivi o disattivi la pianificazione.
- La pianificazione è condivisa da tutti gli studi che utilizzano la configurazione.
- Lo scheduler verifica ogni minuto se ci sono configurazioni in scadenza ed esegue tutte le regole attive per tutti gli studi collegati.
- Una regola non viene eseguita due volte nello stesso giorno di calendario (nel fuso orario locale dello studio). Se una regola è già stata eseguita oggi, in modo automatico o manuale, non viene eseguita di nuovo.
Esecuzione manuale ("Run now")
- Esegue immediatamente la regola per lo studio corrente. Questo invia messaggi reali. Non è possibile annullare un messaggio inviato.
- Un'esecuzione manuale è a sé stante: non effettua la deduplicazione rispetto alle altre regole dell'esecuzione giornaliera.
- Se la regola è già stata eseguita oggi (automaticamente o manualmente), l'esecuzione manuale viene bloccata per evitare doppi messaggi.
Test con singolo membro
- Esegue la regola su un membro specifico da Lei scelto.
- Sceglie il membro tramite il suo customer ID, non il numero membro. Lo copi dal profilo del membro: apra il profilo e prenda il numero nell'URL della pagina — per esempio
.../#/customermanagement/1562839240/overviewsignifica customer ID 1562839240. - Ignora la corrispondenza delle condizioni: il membro viene elaborato indipendentemente dal fatto che corrisponda o meno alle condizioni.
- Invia sempre come Group A, senza bloccare il membro in un bucket di controllo, così il test non finisce mai silenziosamente nel gruppo di controllo.
- La usi per verificare la configurazione del canale e i modelli dall'inizio alla fine prima di attivare una regola.
Ore di silenzio e limiti di frequenza
Due delle protezioni di messaggistica sono impostazioni globali, configurate sulla scheda Delivery e condivise da tutti gli studi collegati alla configurazione. (Le altre due protezioni, il cooldown per regola e la deduplicazione delle corrispondenze multiple, sono trattate in Creare e modificare le regole trigger.)
Ore di silenzio. Imposti un orario di inizio e di fine nel fuso orario dello studio. Gli intervalli notturni funzionano (dalle 22:00 alle 07:00 attraversa la mezzanotte). Le ore di silenzio sono disattivate se è impostato solo uno dei due orari, oppure se inizio e fine sono identici.
Cosa succede durante le ore di silenzio. I messaggi che diventano esigibili mentre la finestra è aperta non vengono scartati: vengono messi in coda e inviati non appena la finestra delle ore di silenzio si apre all'invio (cioè una volta che la finestra termina). L'editor del trigger La avvisa quando un orario di esecuzione configurato ricade in una finestra di ore di silenzio attiva, e il pannello della pianificazione giornaliera mostra lo stesso avviso per l'esecuzione giornaliera. I trigger sui lead basati su eventi (il New-Lead welcome) non sono soggetti alle ore di silenzio e vengono inviati immediatamente.
Ordine delle protezioni. Per ogni esecuzione le protezioni vengono valutate in un ordine fisso: ore di silenzio, poi il limite giornaliero, poi il limite settimanale, poi il cooldown per regola.
Limiti di frequenza giornalieri e settimanali. Limiti mobili per membro: un numero massimo di messaggi di Engage al giorno (finestra mobile di 24 ore) e a settimana (finestra mobile di 7 giorni). Ogni limite ha il proprio interruttore di attivazione/disattivazione sulla scheda Delivery. Se un membro ha già raggiunto un limite, gli ulteriori messaggi vengono saltati.
I limiti sono globali per membro su tutti i trigger di Engage, non conteggiati per singolo trigger, quindi un membro che ha già ricevuto un messaggio da un'altra regola in precedenza nella finestra può essere escluso da questa. Un'esecuzione conta come un messaggio anche quando esce su più canali. Le finestre sono mobili (le ultime 24 ore e gli ultimi 7 giorni), non giorni o settimane di calendario.
Vedere anche: Creare e modificare le regole trigger (Protezioni di messaggistica, Priorità e risoluzione delle corrispondenze multiple).
La catena completa di idoneità
Un membro può corrispondere a ogni condizione che Lei ha scritto e comunque non ricevere nulla, perché le condizioni sono solo un passaggio. Per ogni esecuzione, Engage applica questa catena in ordine:
- Audience (pubblico) — membro attivo, ex membro o lead.
- Communication stop (interruzione della comunicazione) — i membri che hanno rifiutato (nessun consenso alla Newsletter) vengono rimossi.
- Contract type (tipo di contratto) — il filtro include/exclude sul tipo di contratto della regola.
- Le Sue condizioni — i campi delle condizioni sulla regola.
- Raggiungibilità sul canale selezionato — WhatsApp e SMS necessitano di un numero di telefono, Email necessita di un indirizzo email.
La mancanza di dati di contatto sul canale selezionato è il motivo più comune per cui un membro corrispondente non riceve nulla. Un avvertimento sul passaggio delle condizioni: una condizione corrisponde solo ai membri che hanno effettivamente un valore per quel campo. Un membro senza valore è escluso da ogni operatore, comprese le negazioni, quindi un membro senza metodo di pagamento non corrisponde a "payment method is not Direct Debit" (metodo di pagamento diverso da addebito diretto). Per raggiungere i membri senza valore, usi una condizione esplicita "is empty" (è vuoto) dove il campo la offre.
Preview
Preview verifica la portata di una regola prima che invii qualcosa.
- Preview valuta la bozza corrente della regola così com'è nell'editor, non l'ultima versione salvata.
- Restituisce il conteggio totale dei membri corrispondenti e un elenco di esempio con nome, fascia di rischio abbandono e metriche chiave di visita.
- Preview è uno snapshot in tempo reale: mostra solo chi corrisponde alle condizioni in questo momento, in base allo snapshot dei dati del giorno corrente (le metriche dei membri si aggiornano una volta al giorno).
- Può caricare l'elenco completo paginato dei membri corrispondenti, il che è utile negli studi di grandi dimensioni.
Un conteggio pari a 0 non è un problema. Preview che mostra 0 membri significa solo che oggi nessuno corrisponde. Non significa che la regola sia difettosa o che nessuno corrisponderà domani: i membri entrano ed escono dalle condizioni al variare dei loro dati, per esempio quando una soglia di scadenza del contratto viene superata durante la notte oppure quando un membro supera la soglia di dormancy.
Usi Preview per regolare le soglie prima di attivare. Se una regola Dormancy corrisponde a metà dello studio, la soglia è probabilmente troppo stretta per una campagna utile; aumenti il valore dei giorni dall'ultima visita ed esegua di nuovo l'anteprima.
Preview mostra chi corrisponde alle condizioni. Non simula le protezioni, quindi il numero effettivo di messaggi inviati in un'esecuzione può essere inferiore una volta applicati cooldown, limiti di frequenza, ore di silenzio, deduplicazione e il gruppo di controllo A/B. Consideri l'anteprima come "chi è idoneo", non "chi verrà contattato".
Riferimento del log di esecuzione
Ogni membro valutato ottiene una riga, così Lei può sempre ricostruire perché qualcuno è stato o non è stato contattato. La scheda Delivery mostra schede riepilogative (Total matched, Group A, Group B) e una tabella dei risultati per singolo membro. I risultati possono essere filtrati per intervallo di date, esecuzione, trigger, canale e gruppo A/B, ed esportati in CSV.
Risultati di Delivery: una riga per ciascun membro valutato, con Path (One-way o Agent), canale, gruppo A/B ed esito.
Colonne
| Colonna | Cosa mostra |
|---|---|
| Member | Nome del membro, registrato come snapshot al momento dell'invio. I log storici restano leggibili anche se i dati del membro cambiano in seguito. |
| Trigger | La regola trigger che ha valutato questo membro. |
| Path | Percorso di recapito: One-way (inviato direttamente) o Agent (recapitato tramite l'agente MagicAI Chat). Vuoto per i membri saltati. |
| Channel | Il canale su cui il messaggio è stato inviato (o tentato). Vuoto per i membri saltati prima della selezione del canale, come il gruppo di controllo. |
| Group | A (trattamento, contattato) o B (controllo, non contattato). |
| Churn risk | La fascia di rischio abbandono del membro al momento dell'esecuzione (da Very Low a Very High). Utile per esaminare chi è stato preso di mira. |
| Status | L'esito di questo tentativo di invio. Veda il riferimento degli stati qui sotto. |
| Date/time | Quando è stata creata questa voce di log. |
Valori di stato
Ogni tentativo di invio termina esattamente in uno degli esiti qui sotto, mostrato nella colonna Status. La colonna Path accanto mostra Agent (recapitato tramite l'agente MagicAI Chat) o Solo andata (inviato direttamente), ed è vuota per le righe saltate e di controllo.
| Stato | Cosa è successo |
|---|---|
| Sent | Il messaggio è stato consegnato e confermato come inviato dal backend. La conferma di recapito effettiva dipende dal provider a valle (per esempio, WhatsApp o il gateway SMS). |
| Failed | L'invio è fallito a causa di un errore in fase di esecuzione. |
| Control (no message) | Il membro è nel gruppo di controllo B e non è stato contattato intenzionalmente, così il gruppo di trattamento può essere confrontato con una base di riferimento pulita in Impact Analysis. Viene registrata una riga per membro, senza canale. |
| Skipped (quiet hours) | Lo studio si trova all'interno della sua finestra di ore di silenzio configurata. Il messaggio non viene scartato: viene messo in coda e inviato una volta che la finestra si apre. |
| Skipped (cooldown) | La finestra di cooldown della regola non è ancora trascorsa per questo membro. |
| Skipped (already contacted) | Un trigger a contatto singolo ha già inviato a questo membro un messaggio in un'esecuzione precedente. |
| Skipped (daily frequency cap) | È stato raggiunto il limite mobile di messaggi di 24 ore dello studio. |
| Skipped (weekly frequency cap) | È stato raggiunto il limite mobile di messaggi di 7 giorni dello studio. |
| Skipped (higher-priority trigger) | Una regola a priorità più alta ha già rivendicato questo membro nella stessa passata dello scheduler (veda Priorità e risoluzione delle corrispondenze multiple in Creare e modificare le regole trigger). |
| Skipped (no channel) | Il membro non è raggiungibile sul canale (nessun numero di telefono per WhatsApp o SMS, nessun indirizzo email per Email). |
| Skipped (not allowlisted) | Il membro non è presente nell'elenco di invio consentito (allowlist) configurato. |
| Skipped (backend) | Il backend ha trattenuto deliberatamente il messaggio. Il campo del motivo mostra la causa specifica (veda Motivi di skip del backend qui sotto). |
Questi sono gli stati del log di recapito confermati dal reparto tecnico (l'insieme di stati dei messaggi di ml-backend). Ogni membro valutato produce una riga per esecuzione con il suo esito. Lo stato "Skipped (backend)" porta con sé un campo motivo di secondo livello che nomina la causa precisa (veda Motivi di skip del backend qui sotto). Report di recapito per singolo invio più dettagliati (uno stato Succeeded, Failed o Pending per messaggio con il motivo del fallimento) sono previsti per una release successiva, non per il rilascio iniziale. La formulazione esatta a schermo per gli stati meno comuni è confermata rispetto all'interfaccia GA.
Motivi di skip del backend
Quando lo stato è "Skipped (backend)", il campo del motivo spiega perché il sistema di recapito ha trattenuto il messaggio:
| Motivo | Cosa controllare |
|---|---|
| Engage disabled | La funzione Engage è disattivata a livello di piattaforma. |
| No channel handler | Nessun gestore di recapito è registrato per questo canale. Contatti il supporto. |
| Channel disabled | Il canale è disattivato per questo studio. |
| Studio mismatch | Il contesto dello studio non corrispondeva. Contatti il supporto. |
| Template not found | Il modello assegnato a questo canale non esiste più. Riassegni un modello. |
| Template archived | Il modello è stato archiviato dopo la configurazione della regola. Riassegni un modello attivo. |
| Template wrong channel | Il modello è stato creato per un canale diverso. Assegni un modello corrispondente. |
| App not activated | Canale push: la MySports App non è attivata per questo studio. |
| No default locale | Non è impostata alcuna lingua predefinita per il membro. |
| No phone number | Canale SMS: il membro non ha un numero di telefono in archivio. |
| No chatbot configuration | Percorso di recapito con chat: non esiste alcuna configurazione MagicAI Chat. Ne configuri una oppure rimuova l'agente dal canale. |
| MySports unavailable | Canale push: MySports non era disponibile al momento dell'invio. |
| No WhatsApp Business Account | Canale WhatsApp: nessun Meta WhatsApp Business Account è collegato a questo studio. Vedere anche: Configurare WhatsApp per Engage. |
| WhatsApp Business Account mismatch | Il Business Account approvato del modello differisce dall'account collegato allo studio. I modelli WhatsApp sono approvati per account; una mancata corrispondenza significa che Meta rifiuterebbe l'invio. Usi un modello approvato per l'account collegato allo studio. |
Vedere anche: Configurare WhatsApp per Engage. Vedere anche: Impact Analysis.