Panoramica
Liste
Le liste sono i destinatari delle tue campagne. Crea liste, gestisci gli iscritti, controlla il limite di iscritti del piano 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, Subscribers e la data Created. La colonna Subscribers mostra quanti iscritti ha ogni lista rispetto al limite del piano, ad esempio 1.2k/10k. Il menu della riga di ogni lista offre Manage subscribers, Rename e Delete.
Per crearne una, seleziona Create audience, compila il campo Name e seleziona Create. I nomi devono essere unici nel workspace.
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 |
|---|---|
| Rename | Cambia il nome della lista. |
| Subscribe URL | Mostra l’URL di iscrizione ospitato di questa lista e ti permette di reimpostarlo. Vedi URL di iscrizione. |
| Add subscriber | Aggiunge una persona tramite indirizzo email. Viene sostituito da Upgrade quando una lista con Pay as you go è piena. |
| Delete (nel menu) | Elimina la lista e tutti i suoi iscritti. I contatti restano nel workspace. Questa operazione non si può annullare. |
Più in basso, la tabella degli iscritti elenca Email, First name, Last name, Subscribed e Created, con ricerca, filtri e, per ogni iscritto, un menu della riga con Edit e Delete. Vedi Gestisci gli iscritti.
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 con Request Increase nel riquadro Sending Limits della home page del pannello.
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, rinominare, elencare 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 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.
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, rinominata 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 o con l’API. 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 l’URL di iscrizione non inviano eventi sugli iscritti.