Il tuo report di attribuzione del canale GA4 presenta una lacuna. Gli invii push del mese scorso compaiono senza medium e senza sorgente, quindi sulla carta sembrano traffico diretto invece di entrate recuperate. Lo riconduci a un parametro UTM che non è mai stato compilato oltre il segnaposto impostato dal tuo team all'installazione. Questa guida alla configurazione delle impostazioni del sito PushEngage esiste perché correggere quel singolo campo oggi significa accedere alla dashboard, trovare la scheda giusta e reinserire tutti gli altri campi predefiniti contemporaneamente, poiché il modulo non consente di modificarne solo uno.
Questo è il costo effettivo delle impostazioni del sito PushEngage: non che una singola impostazione sia difficile da capire, ma che i dettagli del sito, le impostazioni predefinite delle campagne e la configurazione del service worker si trovino in posti separati, vengano toccati raramente al punto che nessuno ricorda dove, e richiedano un reinserimento completo del modulo per correggere un campo. Questa guida copre i tre gruppi di impostazioni che rivisiterai effettivamente — dettagli del sito, impostazioni predefinite delle campagne e impostazioni del service worker — e come modificarne uno qualsiasi con una richiesta in linguaggio naturale a un assistente AI connesso al server MCP di PushEngage, invece di una caccia alla scheda nella dashboard.
Perché la configurazione delle impostazioni del sito PushEngage si trasforma in un ticket di supporto invece che in una correzione di cinque minuti
Le impostazioni del sito non vengono configurate una volta e dimenticate. Vengono rivisitate ogni volta che l'attività cambia forma: un nuovo mercato significa un cambio di fuso orario, un nuovo requisito di attribuzione significa un aggiornamento del parametro UTM, un rebranding significa che l'interruttore "Powered By PushEngage" necessita di un secondo sguardo, una migrazione della piattaforma significa verificare se il file del service worker si trova ancora dove PushEngage se lo aspetta. Poiché ognuna di queste si trova in un angolo diverso della dashboard, l'attrito effettivo non è la modifica in sé. È ritrovare la scheda, quindi reinserire i campi che non intendevi toccare, in un'attività che rifarai tra tre mesi quando cambierà qualcos'altro.
Tre modalità di errore si presentano abbastanza spesso da essere significative, e nessuna di esse genera un errore quando si verificano:
- Una lacuna nei valori predefiniti UTM. Le impostazioni predefinite delle campagne vengono fornite con parametri UTM segnaposto o vuoti, quindi ogni invio push in quella finestra compare in GA4 senza medium o sorgente, invisibile in un report di attribuzione del canale.
- Una notifica di fallback mancante. Gli iscritti non segmentati, quelli che non corrispondono a nessuna regola di pubblico, non ricevono nulla, o una copia generica, invece di un valore predefinito deliberato scelto dal tuo team.
- Un percorso del service worker obsoleto dopo una migrazione del sito. Questo impedisce la consegna delle notifiche, senza produrre un messaggio di errore evidente che rimandi all'impostazione che l'ha causata.
Tutti e tre ti costano silenziosamente dati, copertura o consegna finché qualcuno non se ne accorge, di solito mentre guarda un report che non torna.
Questo è il caso per trattare le impostazioni del sito come un controllo ricorrente piuttosto che un passaggio di installazione una tantum, ed è il caso per cambiare il modo in cui le controlli.
Per iniziare: collega il server PushEngage MCP al tuo assistente
@pushengage/mcp è il server ufficiale del Model Context Protocol di PushEngage, e ogni strumento in questa guida lo utilizza. Aggiungilo alla configurazione MCP del tuo client — claude_desktop_config.json di Claude Desktop, ~/.cursor/mcp.json di Cursor, o la configurazione MCP di Claude Code — con il comando npx -y @pushengage/mcp. Non è richiesta alcuna installazione globale.
La prima volta che chiedi al tuo assistente di effettuare l'accesso, si apre una scheda del browser per autorizzare la connessione, quindi la tua password PushEngage non tocca mai l'assistente stesso, e il token risultante viene memorizzato localmente sul tuo computer. Da lì, chiedi di vedere i tuoi siti PushEngage e seleziona quello su cui vuoi lavorare; ogni strumento di impostazione sottostante utilizza per impostazione predefinita il sito attualmente selezionato. Per la guida completa, inclusa la risoluzione dei problemi di connessione, consulta la guida completa all'impostazione di PushEngage MCP.
Dettagli del sito: nome, URL, fuso orario, geolocalizzazione e l'interruttore del branding
pushengage_get_site_details legge la tua configurazione corrente; pushengage_update_site_details la modifica. Tra questi due, coprono i campi che la documentazione di onboarding di PushEngage chiama "Aggiungi dettagli del sito":
- Nome del sito
- URL del sito
- Fuso orario
- Tracciamento della geolocalizzazione
- L'interruttore del branding "Powered By PushEngage" sul tuo widget della dashboard
Se hai mai avuto bisogno di correggere uno qualsiasi di questi dettagli del sito pushengage dopo l'installazione iniziale, questa è la coppia di strumenti che raggiunge tutti e cinque i campi, ed è la stessa coppia di strumenti per leggerli prima di presumere che qualcosa sia configurato male.
Il fuso orario è più importante di quanto sembri. È il punto di riferimento per ogni invio programmato e ogni invio basato sul fuso orario dell'iscritto che esegui. Sbaglialo e un invio delle 9:00 atterra alle 2:00 per una parte della tua lista, il che viene interpretato come un fallimento del targeting quando la vera causa è un campo mal configurato.
La geolocalizzazione è disattivata per impostazione predefinita e deve essere esplicitamente attivata prima che PushEngage possa allegare dati di città, stato e paese a un record di iscritto, che è il fondamento su cui si basa il targeting basato sulla geolocalizzazione. Se i tuoi segmenti fanno riferimento alla posizione e i numeri sembrano bassi, vale la pena controllare prima di presumere che la tua base di iscritti non abbia la diffusione geografica che ti aspettavi.
L'interruttore del branding è più semplice: controlla se "Powered By PushEngage" viene visualizzato o meno sul tuo widget della dashboard, il che è più importante per i team che gestiscono un'esperienza di supporto o chat in white-label, dove ogni marchio visibile del fornitore viene esaminato attentamente.
Nessuno di questi richiede un ticket di supporto o una ricerca nei menu delle impostazioni nidificate. L'esempio della README è il modello da seguire: chiedi al tuo assistente, "Cambia il fuso orario del mio sito in Asia/Kolkata e attiva la geolocalizzazione", e entrambi i campi si aggiornano in una sola richiesta. La correzione dell'URL del tuo sito dopo una modifica del dominio, o del nome del tuo sito dopo un rebranding, segue lo schema identico.
Impostazioni predefinite della campagna: le impostazioni che controllano silenziosamente l'attribuzione e la copertura di ogni invio
pushengage_get_campaign_defaults e pushengage_update_campaign_defaults coprono quattro campi. Queste impostazioni predefinite della campagna di pushengage non sono cosmetiche. Sono le impostazioni che si trovano sotto ogni invio che esegui, indipendentemente dal fatto che qualcuno nel team ricordi che esistono, e sbagliare una qualsiasi di esse non fallisce abbastanza rumorosamente perché qualcuno se ne accorga subito.
- Parametri UTM: la tua base per tracciare le notifiche push con parametri UTM in GA4 o in qualsiasi stack di analisi a valle. Salta questa impostazione e ogni invio eredita un'attribuzione vuota: invii senza sorgente o mezzo, entrate non attribuibili, un vuoto che nessuno nota finché un report mensile non torna. Questo è il report di attribuzione del canale che ha aperto questo articolo.
- Notifica di fallback: cosa viene attivato per un abbonato che non corrisponde a nessuna regola del pubblico. Lascialo deselezionato e quegli abbonati non riceveranno nulla.
- Attributi di fallback: token di personalizzazione per lo stesso gruppo non segmentato, in modo che la loro copia appaia intenzionale piuttosto che rotta o generica. Un abbonato senza un attributo corrispondente non dovrebbe vedere uno spazio vuoto dove doveva andare il suo nome.
- Scadenza predefinita della notifica: per quanto tempo un invio non recapitato rimane in coda prima che PushEngage lo elimini. Un invio flash-sale con una scadenza di 7 giorni può ancora arrivare giorni dopo la fine della vendita, fuorviando un abbonato invece di fallire silenziosamente, il che è peggio per la relazione che l'invio non arrivi mai.
Impostare una scadenza predefinita di 7 giorni è una singola richiesta: "Imposta la mia scadenza predefinita della notifica a 7 giorni", direttamente dall'esempio della README. Lo stesso schema copre una notifica di fallback per gli abbonati non corrispondenti, gli attributi di fallback per la personalizzazione di quel gruppo, o un passaggio completo sui parametri UTM in modo che ogni invio attribuisca correttamente a GA4 in futuro. Rivedere le tue attuali impostazioni predefinite della campagna pushengage prima di una grande finestra di invio, piuttosto che dopo che è emerso un gap nei report, è la versione di questa abitudine che vale la pena costruire.
Impostazioni del service worker: registrazione, supporto sottocartelle e percorso del file worker
pushengage_get_service_worker_settings e pushengage_update_service_worker_settings coprono la registrazione, il supporto per le sottocartelle e il percorso del file worker: i meccanismi che consentono alle notifiche push di raggiungere effettivamente un browser in primo luogo. Sbagliare uno qualsiasi dei tre e la modalità di errore è la stessa. Le notifiche smettono silenziosamente di essere recapitate, senza errori evidenti che rimandino all'impostazione che l'ha causata, e il primo sintomo che chiunque nota è un calo nei numeri di invio senza una causa chiara.
Il supporto per le sottocartelle è quello che mette in difficoltà i siti con vincoli di piattaforma che non consentono un file worker a livello di root: un CMS, un'installazione in una sottodirectory, una configurazione multi-sito che condivide un dominio. Se il tuo file worker si trova altrove rispetto alla root, l'impostazione del percorso deve corrispondere a quella posizione esatta, sia la directory che il nome del file, altrimenti la registrazione fallisce silenziosamente.
Questa è la prima cosa che vale la pena controllare dopo una migrazione del sito o un cambio di piattaforma: chiedi al tuo assistente di recuperare le tue attuali impostazioni del service worker di pushengage e conferma che il percorso registrato corrisponda ancora a dove si trova effettivamente il file, lo stesso tipo di controllo che la configurazione del service worker di PushEngage per configurazioni con vincoli di piattaforma esiste per risolvere.
Anche la registrazione stessa merita uno sguardo periodico, in particolare dopo qualsiasi modifica al modo in cui il tuo sito carica gli script. Un aggiornamento della policy di sicurezza dei contenuti, un nuovo contenitore di tag manager o un livello di caching che rimuove gli header possono interferire con la registrazione in modi che non si manifestano se non in un silenzioso calo delle notifiche recapitate. Recuperare le impostazioni del service worker di pushengage insieme a un controllo del tasso di recapito è un'abitudine di cinque minuti che cattura il problema prima che ti costi un intero ciclo di reporting.
Modifiche parziali senza reinserire tutto: perché il comportamento di unione è importante
Ecco il dettaglio che rende la richiesta a un assistente AI più veloce della dashboard, non solo diversa: pushengage_update_campaign_defaults unisce la tua modifica ai valori correnti invece di sostituire l'intero record. Chiedi di modificare solo la scadenza predefinita della notifica, e i tuoi parametri UTM, la notifica di fallback e gli attributi di fallback rimangono esattamente come erano. Non devi specificare nuovamente i campi che non hai intenzione di toccare.
Confronta questo con un tipico modulo di impostazioni, dove la modifica di un campo in un blocco salvato spesso significa che l'intero modulo si ricarica con ogni campo modificabile, e uno scivolone su un campo non correlato sovrascrive silenziosamente qualcosa che funzionava correttamente. "Imposta la mia scadenza predefinita della notifica a 7 giorni" cambia esattamente una cosa e lascia invariati il resto delle tue impostazioni predefinite della campagna. Questa è la differenza tra una modifica mirata e un salvataggio completo ogni volta che una singola impostazione necessita di una piccola modifica, ed è la differenza che trasforma una revisione mensile delle impostazioni da un compito di quindici minuti alla richiesta di una sola frase che avrebbe dovuto essere fin dall'inizio.
Cosa proteggono le impostazioni accurate: recapito e attribuzione, non solo ordine
Niente di tutto ciò riguarda veramente l'ordine. Un fuso orario errato interrompe la pianificazione degli invii per una parte della tua lista. Un valore predefinito UTM mancante interrompe l'attribuzione per ogni invio finché qualcuno non se ne accorge. Un service worker non registrato interrompe la consegna del tutto, e lo fa silenziosamente. Ognuna di queste impostazioni si trova sotto ogni campagna gestita dal tuo team. La campagna non fallisce rumorosamente; il reporting su di essa semplicemente smette silenziosamente di corrispondere alla realtà.
Questo è il caso effettivo per trattare i dettagli del sito, i valori predefiniti della campagna e la configurazione del service worker come impostazioni di notifica push dell'assistente AI che controlli regolarmente, allo stesso modo in cui controlleresti una dashboard sul tasso di consegna, piuttosto che un passaggio di configurazione una tantum che configuri una volta e non rivisiti mai più. Inquadrare queste come impostazioni di notifica push dell'assistente AI piuttosto che una scheda della dashboard sepolta significa che il controllo stesso richiede quanto tempo ci vuole per digitare la richiesta. Catturare un valore predefinito UTM errato o un percorso worker obsoleto in una richiesta protegge gli stessi numeri di entrate recuperate su cui si basa il tuo reporting di fidelizzazione, senza attendere un ticket IT o una chiamata di ri-onboarding per correggere qualcosa che richiede una frase per essere detto ad alta voce.
Una volta che il tuo server MCP di PushEngage è connesso, esegui i tre gruppi di impostazioni trattati in questa guida alla configurazione delle impostazioni del sito di PushEngage nel modo in cui eseguiresti qualsiasi altro audit di fidelizzazione: rapidamente e secondo il tuo programma, invece di solo quando un report non torna. Funziona su ogni piano PushEngage, incluso il livello gratuito, quindi non c'è alcun ostacolo tra la connessione del server MCP e il suo effettivo utilizzo per controllare i dettagli del tuo sito PushEngage, i valori predefiniti della campagna e le impostazioni del service worker prima che ti costino attribuzione o copertura.
