# Sincronizzare i membri di un pubblico

Usa il tuo data warehouse, CRM o applicazione per decidere chi appartiene a una coorte, poi applica la selezione a un pubblico Bird. L'API pubblicata dei pubblici memorizza un'appartenenza statica. Questo modello di integrazione la mantiene allineata al sistema di origine che valuta le tue condizioni, senza inventare un secondo insieme di regole nel flusso di invio.

## Prima di iniziare

Ti servono un pubblico Bird con un nome, i record dei contatti corrispondenti e l'accesso alle operazioni documentate sui pubblici. Stabilisci quale sistema di origine controlla la selezione e chi può modificarne le condizioni. Usa una piccola coorte di prova prima di eseguire l'integrazione su un pubblico di campagna.

Annota le condizioni di inclusione, le esclusioni e il momento della valutazione. Per una coorte di clienti che rinnovano la prossima settimana, specifica il fuso orario e cosa succede quando il sistema di origine registra un rinnovo completato. La selezione deve essere abbastanza riproducibile da consentire di indagare su un membro inatteso.

## Risolvere i record selezionati

1. Ottieni il risultato dal sistema di origine e registra nell'integrazione il momento della valutazione o la revisione.
2. Crea o aggiorna i contatti Bird corrispondenti con l'[operazione sui contatti in lotti](/docs/api/reference/create-contact-batch). Scegli deliberatamente come usare l'identificativo di origine per cercare la corrispondenza.
3. Esamina il risultato di ogni voce. Conserva l'ID di origine e l'ID del contatto Bird risultante nel registro di riconciliazione dell'integrazione.
4. Risolvi i conflitti tra identificativi prima di considerare sincronizzata quella persona. Una richiesta con voci riuscite può comunque contenere voci fallite.

Il lotto di contatti accetta `audience_ids` quando aggiunge record a pubblici noti. Usalo per le aggiunte quando appropriato; le rimozioni richiedono comunque una decisione separata sull'appartenenza. Un'importazione che omette una persona non è un'istruzione per rimuoverla da un pubblico o eliminarla.

## Riconciliare aggiunte e rimozioni

Leggi i membri esistenti con [Elencare i contatti di un pubblico](/docs/api/reference/list-audience-contacts) e scorri tutte le pagine. Confronta gli ID dei contatti Bird con la selezione di origine risolta.

| Differenza                                    | Azione                                                                  |
| --------------------------------------------- | ----------------------------------------------------------------------- |
| Selezionato all'origine, assente nel pubblico | Aggiungi il contatto al pubblico                                        |
| Presente nel pubblico, assente all'origine    | Rimuovi l'appartenenza se il sistema di origine controlla quel pubblico |
| Presente in entrambi                          | Mantieni l'appartenenza                                                 |
| Impossibile risolvere il record di origine    | Indaga prima di completare l'aggiornamento                              |

Applica le modifiche tramite [Aggiungere contatti a un pubblico](/docs/api/reference/assign-audience-contacts) e [Rimuovere contatti da un pubblico](/docs/api/reference/unassign-audience-contacts). Rispetta i limiti correnti dei lotti indicati in quei riferimenti.

Non rimuovere una persona solo perché l'esportazione di origine era incompleta. Prima di calcolare le rimozioni, verifica di avere la selezione di origine completa, inclusa l'ultima pagina. Evita anche di combinare un pubblico gestito dall'integrazione con modifiche manuali indipendenti ai membri, a meno che tu non abbia una politica esplicita per conservarle.

## Completare l'aggiornamento

Dopo aver applicato le differenze, esamina le operazioni fallite e rileggi i membri interessati. Contrassegna l'aggiornamento come completato quando l'appartenenza corrisponde alla selezione di origine prevista. Memorizza il risultato nell'integrazione, così l'esecuzione successiva potrà distinguere un aggiornamento terminato da uno interrotto.

Se il processo si interrompe a metà, riprendi dal lavoro registrato o ricalcola la differenza rispetto al pubblico attuale. Aggiungere un membro esistente lascia intatta l'appartenenza; rimuovere un membro modifica l'appartenenza a quel pubblico, non il record del contatto o il consenso.

Ricontrolla l'idempotenza e la specifica di risposta correnti dell'operazione prima di ripetere automaticamente una richiesta il cui risultato è incerto. Considera l'accettazione della richiesta, gli esiti delle singole voci e la riconciliazione finale come osservazioni distinte.

## Collegare il pubblico all'invio

Usa la selezione completata nel flusso della campagna pertinente. Registra quando il pubblico è stato aggiornato l'ultima volta e verifica la stima attuale del broadcast prima dell'invio. I dati di contatto, le preferenze e le soppressioni possono cambiare dopo l'aggiornamento dei membri.

Per un broadcast Email, la stima passa dal totale dei membri a quelli con un indirizzo e a quelli a cui è possibile inviare. Il risultato finale della consegna è un'osservazione separata. Quando analizzi i risultati, conserva insieme la coorte di origine, il contesto dell'invio e la definizione del risultato aziendale.

## Risoluzione dei problemi

- **Rimozioni inattese:** verifica se l'esportazione di origine è incompleta o se un altro processo o utente sta modificando lo stesso pubblico.
- **Lo stesso contatto fallisce a ogni esecuzione:** risolvi il conflitto dell'identificativo di origine o la proprietà non valida, invece di ignorarlo per sempre senza segnalarlo.
- **Le persone rimangono dopo essere uscite dal segmento:** verifica che l'integrazione applichi le rimozioni oltre alle aggiunte.
- **Il numero di membri a cui è possibile inviare è inferiore:** controlla indirizzi, preferenze e soppressioni invece di aggiungere di nuovo le persone.

## Passaggi successivi

- [Membri e conteggi di un pubblico](/docs/guides/email/audiences)
- [Risultati dell'importazione e corrispondenza dei contatti](/docs/guides/email/contacts)
- [Guida al prodotto per la selezione dei pubblici](/data/segmentation)

## Related resources

- [Getting started with email](/learn/email/getting-started-with-email) (video)
- [Email](/products/email) (product)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=email)