Documentazione
Sign inGet started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
Changelog

Pubblici

Un pubblico è un elenco di contatti con un nome. Crealo una volta e riutilizzalo: per raggiungere di nuovo lo stesso gruppo, basta indicare l'elenco invece di raccogliere gli indirizzi. Un contatto può appartenere a più pubblici e puoi aggiungere o rimuovere membri man mano che le persone entrano o escono.
Gestisci i pubblici in Contatti > Pubblici nella dashboard, con bird audiences dal terminale, tramite l'API dei pubblici o con uno qualsiasi degli SDK.

La pagina Pubblici

La pagina Pubblici elenca i tuoi pubblici per nome, data di creazione e tipo. Il tipo è Statico per un elenco di cui aggiungi e rimuovi personalmente i membri. Per visualizzare la pagina serve il permesso di lettura email_marketing, mentre per creare o modificare un pubblico serve quello di scrittura.
La pagina Pubblici nella dashboard, con un campo di ricerca per nome, un pulsante Aggiungi pubblico e tre righe di pubblici statici con descrizioni e date di creazione
Per creare un pubblico, inserisci un nome e, facoltativamente, una descrizione di chi ne fa parte. Poi apri il pubblico per gestirne i membri.

Membri

Apri un pubblico per vedere i suoi membri, a partire da quelli aggiunti più di recente. Ogni riga mostra:
  • Il nome e l'indirizzo email del contatto.
  • Le etichette Email o SMS, ricavate dagli identificativi memorizzati del contatto. Non dimostrano che il contatto sia raggiungibile o che tu abbia il permesso di contattarlo.
  • Tutti i pubblici a cui appartiene il contatto, incluso questo.
  • Quando il contatto è entrato in questo pubblico.
Cerca nell'elenco per indirizzo email, poi seleziona una riga per aprire il contatto.
Il riepilogo del pubblico contiene due schede. Membri conta tutte le persone nel pubblico. Email conta i contatti con un indirizzo e fornisce una stima di quelli a cui è possibile inviare dopo aver applicato le preferenze e le soppressioni pertinenti. La stima può cambiare prima dell'esecuzione di un broadcast e non garantisce la consegna.
Il pubblico Iscritti alla newsletter con le schede di riepilogo Membri ed Email, entrambe con il valore 10, seguite da una tabella con nomi dei contatti, canali, pubblici e date di ingresso
Puoi aggiungere persone in due modi:
  • Incolla gli indirizzi email nel pubblico, uno per riga, fino a 1.000 alla volta. Abbiniamo ogni indirizzo a un contatto esistente, oppure ne creiamo uno se non troviamo corrispondenze, quindi li aggiungiamo tutti al pubblico in un solo passaggio.
  • Assegna durante l'importazione aggiungendo i contatti ai pubblici mentre li importi o li crei o aggiorni tramite upsert. L'endpoint per i lotti e bird contacts batch accettano un elenco audience_ids, con un massimo di 10 pubblici per richiesta, insieme ai contatti. Ogni pubblico indicato deve esistere, altrimenti l'intera richiesta fallisce e non viene scritto nulla.
L'aggiunta è idempotente: un contatto che è già membro resta nel pubblico e conserva la data di ingresso originale. Rimuovere un'appartenenza non registra una disiscrizione. Preferenze e soppressioni restano separate. Rimuovere un membro toglie il contatto solo da quel pubblico: il contatto rimane nel tuo spazio di lavoro e in tutti gli altri pubblici a cui appartiene. Rimuovi un membro dalla sua riga oppure selezionane diversi e rimuovili insieme.
Dalla CLI, usa bird audiences add-contacts <audience-id> per aggiungere contatti e bird audiences remove-contacts <audience-id> per rimuoverli. Entrambi i comandi accettano ID di contatti, quindi devi conoscere l'ID di ogni contatto da aggiungere o rimuovere. Se hai soltanto un elenco di indirizzi email, usa bird contacts batch con audience_ids. Il comando cerca ogni indirizzo, crea un contatto per quelli che non riconosce e li aggiunge tutti al pubblico con una sola chiamata.

Mantenere aggiornata una coorte selezionata

L'API pubblica dei pubblici usa un'appartenenza statica ed esplicita. Se un CRM o un data warehouse valuta una coorte in base a regole, sincronizza sia le aggiunte sia le rimozioni e registra l'ultimo aggiornamento completato. Segui la guida Sincronizzare i membri di un pubblico. Aggiornare soltanto le proprietà di un contatto non comporta una nuova valutazione di un pubblico statico.

Inviare a un pubblico

L'invio di un messaggio a un intero pubblico è un broadcast. Scegli il pubblico: all'avvio dell'invio ricaviamo l'elenco dei destinatari dai suoi membri, così il broadcast è rivolto a chi fa parte del pubblico in quel momento. I broadcast si eseguono dalla dashboard, tramite l'API o con i comandi bird email broadcasts.
Per un elenco di destinatari occasionale che non vale la pena salvare come pubblico, invia un lotto.

Passaggi successivi

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Esplora la funzionalitàContacts and audiencesSegui il percorso di apprendimentoBuild your first integration
Ottieni un brief di implementazione