Panoramica
Liste
Le liste sono i destinatari delle tue campagne. Crea, unisci e archivia liste, gestisci gli iscritti, imposta il double opt-in e un nome pubblico e usa le liste con l’API.
Una lista è un elenco di contatti con un nome, ad esempio «Newsletter» o «Novità di prodotto». Scegli una o più liste come destinatari di una campagna, e puoi aggiungere persone a una lista a mano, con un’importazione, con l’API o con un URL di iscrizione ospitato.
Come funzionano le liste
Ogni persona in una lista è un iscritto: un collegamento tra un contatto e la lista, con un proprio indicatore Subscribed. Lo stesso contatto può essere in più liste, iscritto ad alcune e disiscritto da altre.
- Le campagne vengono inviate agli iscritti con l’indicatore Subscribed attivo, il cui contatto non è disiscritto a livello globale e il cui indirizzo non è soppresso. Un contatto presente in più liste selezionate riceve una sola copia.
- La disiscrizione disattiva l’indicatore ma lascia l’iscritto nella lista, così ne conservi la cronologia. Vedi Disiscrizioni.
- Eliminare un iscritto rimuove la persona dalla lista. Il contatto resta nel workspace.
L’elenco Audiences
Vai a Email MarketingAudiences per vedere le liste con le colonne Name, Visibility, Subscribers e la data Created. Sotto il nome vedi il nome pubblico quando è diverso, e la colonna Visibility mostra Public o Private e un badge Double opt-in quando è attivo. La colonna Subscribers mostra quanti iscritti ha ogni lista rispetto al limite del piano, ad esempio 1.2k/10k. Puoi ordinare tutte le colonne.
Il menu della riga offre Manage subscribers, Rename, Merge into another audience, Archive e Delete. Per agire su più liste, selezionale e usa Actions: Merge, Archive (o Unarchive nella scheda Archived) e Delete.
Per crearne una, seleziona Create audience, compila il campo Name e seleziona Create. I nomi devono essere unici nel workspace.
Archivia una lista
Archivia le liste che non usi più per fare ordine senza perdere nulla. Una lista archiviata passa nella scheda Archived e:
- conserva tutti i suoi iscritti,
- non compare più nei selettori di liste di campagne, moduli, automazioni e contatti,
- non compare nella pagina di gestione delle iscrizioni, tranne che per le persone ancora iscritte,
- non accetta più iscrizioni tramite il suo URL di iscrizione, che restituisce
404.
Le campagne, i moduli e le automazioni che la usano già continuano a funzionare. Seleziona Unarchive per ripristinarla.
Unisci le liste
L’unione copia gli iscritti di una o più liste in un’altra. Seleziona le liste e scegli Actions > Merge, poi scegli la lista in cui unirle, oppure usa Merge into another audience nel menu della riga. Nella pagina di una lista, Merge audiences into this one nel menu fa lo stesso nella direzione opposta.
- Le persone già presenti nella lista di destinazione mantengono lì il loro stato, quindi nessuno che si è disiscritto viene iscritto di nuovo.
- Una persona presente in più liste unite risulta iscritta se è iscritta ad almeno una di esse.
- Con Delete the merged audiences afterwards, le liste unite e le loro iscrizioni vengono eliminate, e le campagne destinate a quelle liste che non hanno ancora finito l’invio vengono inviate alla lista di destinazione. Anche i segmenti che hanno come origine una lista unita, o che hanno una regola su di essa, usano al suo posto la lista di destinazione, e lo stesso vale per le automazioni che partono da quella lista, vi aggiungono persone, la controllano in una condizione o terminano quando qualcuno la lascia. Lo stesso vale per i moduli che vi aggiungono persone o la propongono come scelta, per i link di double opt-in non ancora confermati e per le esecuzioni delle automazioni in attesa di una condizione su quella lista.
L’unione non invia eventi subscriber.*, non avvia automazioni e non invia email di double opt-in o di conferma. I segmenti tracciati aggiornano poi i loro membri. Si applica il limite di iscritti della lista di destinazione: un’unione che lo supererebbe non aggiunge nessuno.
La pagina della lista
Apri una lista per gestirne gli iscritti. L’intestazione mostra il numero di iscritti e il badge del limite, con queste azioni:
| Azione | Cosa fa |
|---|---|
| Subscribe URL | Mostra l’URL di iscrizione di questa lista e ti permette di reimpostarlo. Vedi URL di iscrizione. |
| Import | Importa un file CSV o Excel direttamente in questa lista. Vedi Importa iscritti. |
| Add subscriber | Aggiunge una persona tramite indirizzo email. Viene sostituito da Upgrade quando una lista con Pay as you go è piena. |
| Settings (nel menu) | Apre la scheda Settings. |
| Merge audiences into this one (nel menu) | Copia in questa lista gli iscritti di altre liste. Vedi Unisci le liste. |
| Archive (nel menu) | Archivia la lista, oppure la toglie dall’archivio. Vedi Archivia una lista. |
| Create segment (nel menu) | Crea un nuovo segmento con questa lista come origine. I segmenti sono in alpha e aperti solo al team di Emailit. |
| Delete (nel menu) | Elimina la lista e tutti i suoi iscritti. I contatti restano nel workspace. Questa operazione non si può annullare. |
La scheda Subscribers elenca le persone della lista, con le viste All, Engaged e Unengaged, colonne ordinabili, ricerca, filtri e azioni di massa. Vedi Gestisci gli iscritti.
La scheda Settings contiene:
- Name and visibility: il nome interno, il nome pubblico e la descrizione che vedono gli iscritti, e se la lista è pubblica o privata nella pagina di gestione delle iscrizioni.
- Double opt-in e Confirmation email: vedi Double opt-in ed email di conferma.
- Unengaged contacts: vedi Contatti inattivi.
Limiti
Ogni piano limita il numero di iscritti che una lista può contenere. Il numero di liste non è limitato.
| Pay as you go | Pro | Business | Custom | |
|---|---|---|---|---|
| Iscritti per lista | 10.000 | 50.000 | 250.000 | Illimitati |
Il limite conta tutti gli iscritti della lista, comprese le persone che si sono disiscritte. Per fare spazio, elimina gli iscritti che non ti servono più, passa a un piano superiore oppure chiedi un limite più alto a support@emailit.com.
Quando una lista è piena, Add subscriber è disattivato e ogni modo di aggiungere persone, compresi l’API, le importazioni e l’URL di iscrizione, viene rifiutato con 422 e un messaggio come «Pro includes 50,000 subscribers per audience.». L’errore dell’API include l’usage attuale:
{
"error": "Pro includes 50,000 subscribers per audience.",
"usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}Usa l’API
L’API delle liste ti permette di creare, recuperare, aggiornare, elencare, unire, aggiornare in blocco ed eliminare le liste, e l’API degli iscritti gestisce le persone che contengono. Nell’URL puoi usare il nome di una lista al posto del suo ID aud_. L’API richiede una chiave API con Full Access.
curl https://api.emailit.com/v2/audiences \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Newsletter" }'Le risposte sulle liste includono le impostazioni (visibility, public_name, public_description, double_opt_in, confirmation_email, unengaged, archived, archived_at), subscribers_count e un oggetto usage con used, limit e plan. Creazione, recupero e aggiornamento di una lista restituiscono anche il suo token, la parte segreta del suo URL di iscrizione. Un nome duplicato restituisce 409. Gli elenchi escludono le liste archiviate, a meno che tu non passi archived=true o archived=all.
Eventi
Le modifiche a liste e iscritti generano eventi che puoi ricevere con i webhook e che avviano le automazioni:
| Evento | Quando |
|---|---|
audience.created, audience.updated, audience.deleted |
Una lista viene creata, modificata (archiviazione compresa) o eliminata. L’eliminazione di una lista non invia un evento per ciascuno dei suoi iscritti. |
subscriber.created |
Qualcuno viene aggiunto a una lista dal pannello, con l’API, tramite l’URL di iscrizione, un modulo, un link di double opt-in o la pagina di gestione delle iscrizioni. Avvia le automazioni Added to audience. |
subscriber.updated |
Cambiano i dati di un iscritto o il suo indicatore Subscribed. |
subscriber.deleted |
Un iscritto viene rimosso. Avvia le automazioni Removed from audience. |
Le importazioni e le unioni non inviano eventi sugli iscritti.