# Synchroniser les membres d'une audience

Utilisez votre entrepôt de données, votre CRM ou votre application pour décider qui appartient à une cohorte, puis appliquez cette sélection à une audience Bird. L'API publiée des audiences enregistre une appartenance statique. Ce modèle d'intégration la maintient en accord avec la source qui évalue vos conditions, sans inventer un second ensemble de règles dans le flux d'envoi.

## Avant de commencer

Vous avez besoin d'une audience Bird nommée, des fiches de contact correspondantes et d'un accès aux opérations d'audience documentées. Déterminez quelle source fait autorité pour la sélection et qui peut modifier ses conditions. Utilisez une petite cohorte de test avant d'exécuter l'intégration sur une audience de campagne.

Consignez les conditions d'inclusion, les exclusions et l'heure d'évaluation. Pour une cohorte de clients dont le renouvellement est prévu la semaine prochaine, précisez le fuseau horaire et ce qui se passe lorsque la source enregistre un renouvellement terminé. La sélection doit être suffisamment reproductible pour permettre d'expliquer la présence d'un membre inattendu.

## Résoudre les enregistrements sélectionnés

1. Obtenez le résultat de la source et enregistrez son heure d'évaluation ou sa révision dans votre intégration.
2. Créez ou mettez à jour les contacts Bird correspondants avec l'[opération de contacts par lots](/docs/api/reference/create-contact-batch). Choisissez délibérément comment utiliser votre identifiant source pour établir la correspondance.
3. Examinez le résultat de chaque entrée. Conservez son ID source et l'ID de contact Bird obtenu dans le journal de rapprochement de l'intégration.
4. Résolvez les conflits d'identifiants avant de considérer cette personne comme synchronisée. Une requête comportant des entrées réussies peut aussi contenir des entrées en échec.

Le lot de contacts accepte `audience_ids` lors de l'ajout d'enregistrements à des audiences connues. Utilisez ce champ pour les ajouts lorsque cela convient ; les retraits nécessitent toujours une décision d'appartenance distincte. Une importation qui omet une personne ne demande ni de la retirer d'une audience ni de la supprimer.

## Rapprocher les ajouts et les retraits

Consultez les membres existants avec [Lister les contacts d'une audience](/docs/api/reference/list-audience-contacts) et parcourez toutes les pages. Comparez les ID de contacts Bird avec la sélection source résolue.

| Différence                                       | Action                                                           |
| ------------------------------------------------ | ---------------------------------------------------------------- |
| Sélectionné dans la source, absent de l'audience | Ajouter le contact à l'audience                                  |
| Présent dans l'audience, absent de la source     | Retirer le membre si la source fait autorité pour cette audience |
| Présent dans les deux                            | Conserver l'appartenance                                         |
| Échec de résolution de l'enregistrement source   | Examiner le problème avant de terminer l'actualisation           |

Appliquez les modifications via [Ajouter des contacts à une audience](/docs/api/reference/assign-audience-contacts) et [Retirer des contacts d'une audience](/docs/api/reference/unassign-audience-contacts). Respectez les limites de lot en vigueur dans ces références.

Ne retirez personne au seul motif qu'un export source est incomplet. Vérifiez que vous disposez de la sélection source complète, y compris sa dernière page, avant de calculer les retraits. Évitez aussi de combiner une audience gérée par une intégration avec des modifications manuelles indépendantes de ses membres, sauf si vous avez une politique explicite pour les préserver.

## Terminer l'actualisation

Après avoir appliqué les différences, examinez les opérations en échec et relisez la liste des membres concernés. Marquez l'actualisation comme terminée lorsqu'elle correspond à la sélection source prévue. Enregistrez le résultat dans votre intégration pour que l'exécution suivante distingue une actualisation terminée d'une actualisation interrompue.

Si le processus s'arrête en cours de route, reprenez à partir du travail enregistré ou recalculez la différence par rapport à l'audience actuelle. Ajouter un membre existant laisse son appartenance intacte ; retirer un membre modifie l'appartenance à cette audience, pas sa fiche de contact ni son consentement.

Vérifiez de nouveau les règles d'idempotence et la spécification de réponse en vigueur pour l'opération avant de rejouer automatiquement une requête dont le résultat est incertain. Considérez l'acceptation de la requête, les résultats de chaque entrée et le rapprochement final comme des observations distinctes.

## Relier l'audience à l'envoi

Utilisez la sélection finalisée dans le flux de campagne concerné. Enregistrez la date de dernière actualisation de l'audience et examinez l'estimation actuelle de la diffusion avant l'envoi. Les coordonnées, les préférences et les suppressions peuvent changer après l'actualisation des membres.

Pour une diffusion Email, l'estimation part du nombre total de membres, puis se restreint aux membres possédant une adresse et à ceux pouvant recevoir un envoi. Le résultat final de livraison constitue une observation distincte. Lors de l'analyse des résultats, conservez ensemble la cohorte source, le contexte d'envoi et la définition du résultat métier.

## Dépannage

- **Retraits inattendus :** vérifiez si l'export source est incomplet ou si un autre processus ou utilisateur modifie la même audience.
- **Le même contact en échec revient à chaque exécution :** résolvez le conflit d'identifiant source ou corrigez la propriété invalide au lieu de l'ignorer indéfiniment sans le signaler.
- **Des personnes restent après avoir quitté le segment :** vérifiez que votre intégration applique les retraits aussi bien que les ajouts.
- **Le nombre de membres pouvant recevoir un envoi est plus faible :** examinez les adresses, les préférences et les suppressions au lieu d'ajouter à nouveau des personnes.

## Étapes suivantes

- [Membres et décomptes d'une audience](/docs/guides/email/audiences)
- [Résultats d'importation et correspondance des contacts](/docs/guides/email/contacts)
- [Guide produit sur la sélection des audiences](/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)