Documentazione

Tutto quello che serve per mandare la prima push e far crescere la tua audience.

Indice
Primi passi Installazione Popup di iscrizione Campagne Audience RSS automatico Statistiche Piani e limiti Migrare a Natom GDPR e privacy API

Primi passi

Crea l'account gratuito su natom.app/app.
Dalla sezione Siti, aggiungi il tuo sito indicando nome e dominio.
Installa il codice come descritto qui sotto: da quel momento i visitatori possono iscriversi alle notifiche.

Installazione sul sito

Servono due cose, entrambe disponibili dal bottone Codice sulla riga del tuo sito:

1. Lo snippet nelle pagine

<script src="https://cdn.natom.app/push.js?k=IL-TUO-CODICE" async></script>

Va inserito in tutte le pagine, idealmente prima della chiusura di </body>. Su WordPress puoi usare il tema (footer.php) o un plugin di inserimento script.

2. Il service worker nella root

Scarica il file natom-sw.js dalla dashboard e caricalo nella root del dominio, in modo che risponda su https://tuosito.com/natom-sw.js. È il componente che riceve e mostra le notifiche anche quando il sito è chiuso.

Le web push funzionano solo su siti serviti in HTTPS. Su iPhone e iPad le notifiche arrivano solo se l'utente ha aggiunto il sito alla schermata Home (limite di iOS, uguale per qualunque piattaforma push).

Dall'editor scegli anche la dimensione (piccolo, medio, grande) e la posizione, separata per desktop e mobile: in alto, al centro o in basso. Il pannello delle categorie usa la stessa dimensione e ha una posizione propria. L'anteprima si aggiorna mentre modifichi.

Il permesso notifiche del browser va chiesto bene: per questo Natom mostra prima un popup tuo, personalizzabile, e solo dopo il click la richiesta di sistema. Dal bottone Popup configuri testi, icona, colori, posizione, ritardo di comparsa e ogni quanti giorni riproporlo a chi ha rimandato, con anteprima live desktop e mobile. Le modifiche arrivano ai visitatori entro 5 minuti.

Se preferisci agganciare l'iscrizione a un tuo bottone, chiama natom.ask() da JavaScript e disattiva il popup automatico.

Campagne

Da Nuova push componi la notifica: titolo, testo, URL di destinazione, icona e immagine opzionali.

Invio immediato o schedulato: imposta data e ora e ci pensa Natom.
Cross-domain: seleziona più siti e la stessa push parte su tutti in un colpo solo, con statistiche aggregate.
TTL: se una notifica non viene consegnata entro le ore impostate (browser spento), scade e non arriva in ritardo.

In alto nella pagina Campagne scegli il periodo (oggi, ieri, 7, 30, 90 giorni, 12 mesi o un intervallo a tua scelta): i riquadri mostrano inviate, consegnate, click e CTR del periodo, il grafico l'andamento e la tabella le campagne di quei giorni. Consegnate e click sono attribuiti al giorno di invio; sui periodi lunghi il grafico raggruppa per settimana o per mese, cosi' anche anni di storico restano leggeri.

Audience

Un'audience è un gruppo di iscritti definito dai tag. Il sito assegna i tag con una riga di JavaScript:

natom.tag('cat_sport', '1')     // sulle pagine di sport
natom.tag('cat_politica', '1')  // su quelle di politica

Su un CMS il valore è dinamico: una sola riga nel template della pagina articolo profila tutti i lettori in automatico. Consiglio: usa un tag per categoria (come sopra), così gli interessi si accumulano e un lettore può appartenere a più audience.

Dal bottone Audience del sito crei il segmento (es. "Lettori sport" = cat_sport = 1): chi già corrisponde viene incluso subito, i nuovi si aggiungono da soli. In Nuova push, con un solo sito selezionato, scegli l'audience destinataria dal menu.

📖 Leggi la guida completa alle audience: tag, convenzioni, esempio WordPress pronto, geolocalizzazione, CAP, creazione a un click e domande frequenti.

Far scegliere al lettore (preferenze esplicite)

Se preferisci che sia il lettore a dire cosa vuole ricevere, attiva Fai scegliere al lettore le categorie nell'editor del popup ed elenca le categorie. Subito dopo l'iscrizione compare un pannello con le caselle: il lettore spunta quelle che gli interessano e puo' cambiarle in qualsiasi momento da un link <a href="#" data-natom-prefs>Gestisci le notifiche</a> che metti dove vuoi (footer, pagina dedicata). Ogni categoria e' un'audience: gli invii per audience e l'instradamento RSS funzionano identici. Chi non sceglie nulla riceve tutto cio' che mandi a "tutti gli iscritti". La scelta e' del lettore: nessun meccanismo automatico lo aggiunge a categorie che non ha spuntato.

Invii geolocalizzati

Ogni iscritto riceve in automatico il tag di sistema geo col paese (es. geo = IT), rilevato dal fuso orario del browser: un'audience "Italia" = filtro geo = IT e la push parte solo lì. Per un targeting più fine (CAP, città, provincia) usa il tagging dal sito nei punti in cui l'utente fornisce il dato: natom.tag('cap','57128') o natom.tag('provincia','LI'), e crei l'audience sul tag corrispondente. È il metodo più preciso che esista: il dato arriva dall'utente, non da una stima sull'IP.

RSS automatico

Dal bottone RSS colleghi uno o più feed (RSS 2.0 o Atom). A ogni nuovo articolo Natom crea la push con titolo, estratto e immagine:

Invio automatico oppure bozza da approvare, a tua scelta.
Instradamento sulle audience: se attivo, l'articolo viene inviato all'audience corrispondente alla sua categoria. La corrispondenza usa la convenzione cat_<categoria> (minuscole, spazi sostituiti da _): un articolo in categoria "Sport" cerca l'audience che filtra su cat_sport. Se non la trova, la push va a tutti.

📖 Leggi la guida completa a RSS e push ricorrenti: come ragiona il feed, instradamento per categoria, limiti e ore di silenzio, ricorrenti a orario fisso, con un esempio per un giornale locale.

Statistiche

Iscritti attivi e andamento giorno per giorno. Il grafico conta solo gli iscritti attivi: se un token viene disattivato dalla pulizia, sparisce anche dallo storico, cosi' il cumulato coincide sempre con il numero in alto.
Consegnate: le notifiche effettivamente mostrate sullo schermo del lettore. Fino a 5.000 iscritti attivi per sito il conteggio e' esatto; oltre, e' una stima campionaria al 20% (il service worker segnala una notifica su cinque e Natom moltiplica), che sui grandi volumi e' precisa e tiene le statistiche leggere.
Click e CTR per ogni campagna, tracciati al 100%.
Popup: quante volte e' stato mostrato, accettato o rimandato, giorno per giorno.

Se stai facendo prove, ricorda che i tuoi dispositivi di test sono iscritti veri: ogni volta che azzeri i dati del sito e ti reiscrivi nasce un nuovo iscritto, e ogni push di prova conta nelle consegne e nei click. Su un sito con pochi iscritti i test si vedono benissimo nei grafici.

Piani e limiti

Piano	Iscritti	Siti
Free	1.000	1
Starter	10.000	1
Pro	50.000	3
Business	150.000	10
Enterprise	oltre 150.000, offerta su misura	illimitati

Le push sono sempre illimitate, su ogni piano. Superato il tetto di iscritti hai 5 giorni per passare al piano superiore: in quel periodo tutto funziona normalmente. Scaduti i 5 giorni, le nuove iscrizioni vengono messe in pausa (l'audience esistente continua a ricevere le push, non perdi nulla). Il piano annuale costa come 10 mensilità: 2 mesi in regalo.

Migrare a Natom da un altro servizio

Se oggi usi un'altra piattaforma di web push, puoi passare a Natom senza perdere la possibilità di raggiungere la tua audience. Prima però una cosa va detta con chiarezza, perché vale per qualunque cambio di fornitore:

Gli iscritti non si trasferiscono con un export. I token push sono legati tecnicamente alle chiavi del fornitore che li ha generati: nessuna piattaforma può importare gli iscritti di un'altra. La migrazione avviene con la re-iscrizione automatica dei tuoi visitatori, ed è molto meno drammatica di quanto sembri.

Come funziona la re-iscrizione

Il permesso notifiche del browser appartiene al tuo dominio, non al fornitore. Chi ha già accettato le notifiche sul tuo sito non vedrà nessun nuovo popup: al primo ritorno sul sito, lo snippet Natom lo iscrive in modo silenzioso e automatico. Nessun click richiesto, nessuna richiesta ripetuta.

I passi

Distingui due cose: lo snippet sulle pagine (raccoglie le iscrizioni) e l'account del vecchio fornitore (può ancora inviare ai suoi iscritti). Si sostituisce subito il primo, si tiene acceso il secondo durante la transizione.

Sostituisci lo snippet, in un colpo solo: nello stesso aggiornamento del sito togli lo snippet del vecchio fornitore dalle pagine e metti quello di Natom (script + natom-sw.js nella root). Non tenere i due snippet insieme: il service worker che riceve le notifiche è uno solo per dominio, quindi la convivenza sulle pagine non funziona.
Tieni acceso l'account del vecchio fornitore: anche senza snippet sul sito può ancora inviare push ai suoi iscritti che non sono ancora tornati sul sito. Durante la transizione hai due canali di invio: il vecchio per chi non è ancora rientrato, Natom per chi è già passato.
Aspetta che l'audience si ricostruisca: chi torna sul sito viene re-iscritto su Natom in automatico, senza nessun popup. I visitatori abituali (quelli che generano la maggior parte delle aperture) rientrano nei primi giorni; il grosso dell'audience attiva si ricostruisce in 2-4 settimane su un sito ad alto traffico.
Chiudi l'account del vecchio fornitore quando i numeri su Natom ti soddisfano.

📖 Leggi la guida completa alla migrazione: cosa succede tecnicamente, la curva dei tempi reali, la checklist passo passo e le domande frequenti (perderò iscritti? e i numeri gonfiati del vecchio fornitore?).

Consigli per non perdere slancio

Fai la migrazione in un periodo di traffico normale o alto, non in un momento morto: più visite = re-iscrizione più veloce.
Se usi le audience, metti i tag (natom.tag) nel template fin dal primo giorno: i lettori si profilano già durante la re-iscrizione.
Gli iscritti che non tornano mai sul sito non rientreranno: è fisiologico, e sono anche quelli che non aprivano le notifiche. Le metriche per iscritto (CTR, aperture) dopo una migrazione tipicamente migliorano.

Le web push inviate tramite Natom sono conformi al GDPR per come funziona il meccanismo stesso:

Consenso esplicito e preventivo: nessuna notifica può essere inviata senza che l'utente abbia accettato la richiesta di permesso del browser, che è un opt-in attivo e granulare (art. 6.1.a GDPR).
Nessun dato personale richiesto: l'iscrizione non chiede email, nome o altri identificativi diretti. Natom tratta un token tecnico pseudonimo generato dal browser, il tipo di browser e sistema operativo, e gli eventuali tag assegnati dal sito.
Revoca in autonomia: l'utente può disattivare le notifiche in ogni momento dalle impostazioni del browser, senza passare da nessuno. Alla revoca il token diventa inservibile e viene rimosso dalle pulizie periodiche.
Minimizzazione: le statistiche sono aggregate; le impressions sono campionate, non tracciate a livello di singolo utente.
Ruoli chiari: per i dati degli iscritti dei tuoi siti, tu sei titolare del trattamento e Natom opera come responsabile ai sensi dell'art. 28 GDPR.

Cosa devi fare tu come publisher: menziona le notifiche push nella privacy policy del tuo sito (finalità, revocabilità dal browser, uso di Natom come fornitore). Se usi i tag per profilare gli interessi dei lettori, indicalo. Non serve un banner cookie aggiuntivo: l'iscrizione push non usa cookie di profilazione.

Domande? Scrivi a support@natom.app.