# Doelgroeplidmaatschap synchroniseren

Bepaal met je datawarehouse, CRM of toepassing wie tot een cohort behoort en pas die selectie toe op een Bird-doelgroep. De gepubliceerde doelgroepen-API slaat statisch lidmaatschap op. Dit integratiepatroon houdt het gelijk aan de bron die je voorwaarden beoordeelt, zonder een tweede set regels in het verzendproces te introduceren.

## Voordat je begint

Je hebt een Bird-doelgroep met een naam, de bijbehorende contactrecords en toegang tot de gedocumenteerde doelgroepbewerkingen nodig. Leg vast welke bron de selectie bepaalt en wie de voorwaarden mag aanpassen. Gebruik een klein testcohort voordat je de integratie voor een campagnedoelgroep uitvoert.

Leg de voorwaarden voor opname, de uitsluitingen en het beoordelingsmoment vast. Geef voor een cohort klanten die volgende week verlengen de tijdzone op en bepaal wat er gebeurt wanneer de bron een voltooide verlenging vastlegt. De selectie moet voldoende reproduceerbaar zijn om een onverwacht lid te kunnen onderzoeken.

## De geselecteerde records koppelen

1. Haal het resultaat uit de bron op en leg het beoordelingsmoment of de revisie vast in je integratie.
2. Maak de bijbehorende Bird-contacten aan of werk ze bij met de [batchbewerking voor contacten](/docs/api/reference/create-contact-batch). Kies bewust je bronidentificatiecode voor de koppeling.
3. Controleer het resultaat van elke invoer. Bewaar de bron-ID en de resulterende Bird-contact-ID in het afstemmingslog van de integratie.
4. Los conflicten tussen identificatiegegevens op voordat je die persoon als gesynchroniseerd beschouwt. Een verzoek met geslaagde invoeren kan ook mislukte invoeren bevatten.

De contactbatch accepteert `audience_ids` bij het toevoegen van records aan bekende doelgroepen. Gebruik dit voor toevoegingen waar dat past. Verwijderingen vragen nog steeds om een afzonderlijke beslissing over het lidmaatschap. Een import waarin iemand ontbreekt, is geen opdracht om die persoon uit de doelgroep te halen of te verwijderen.

## Toevoegingen en verwijderingen afstemmen

Lees het bestaande lidmaatschap uit met [Contacten van een doelgroep opvragen](/docs/api/reference/list-audience-contacts) en doorloop alle pagina's. Vergelijk de Bird-contact-ID's met de gekoppelde bronselectie.

| Verschil                                           | Actie                                                         |
| -------------------------------------------------- | ------------------------------------------------------------- |
| Geselecteerd in de bron, ontbreekt in de doelgroep | Voeg het contact toe aan de doelgroep                         |
| Aanwezig in de doelgroep, ontbreekt in de bron     | Verwijder het lidmaatschap als de bron deze doelgroep beheert |
| Aanwezig in beide                                  | Behoud het lidmaatschap                                       |
| Bronrecord kon niet worden gekoppeld               | Onderzoek dit voordat je de vernieuwing voltooit              |

Voer wijzigingen uit via [Contacten toevoegen aan een doelgroep](/docs/api/reference/assign-audience-contacts) en [Contacten verwijderen uit een doelgroep](/docs/api/reference/unassign-audience-contacts). Houd je aan de actuele batchlimieten in die referenties.

Verwijder niemand alleen omdat een bronexport onvolledig was. Controleer of je de volledige bronselectie hebt, inclusief de laatste pagina, voordat je verwijderingen berekent. Vermijd daarnaast losstaande handmatige wijzigingen in een doelgroep die door de integratie wordt beheerd, tenzij je een expliciete regel hebt om die wijzigingen te behouden.

## De vernieuwing voltooien

Controleer na het toepassen van de verschillen welke bewerkingen zijn mislukt en lees het betrokken lidmaatschap opnieuw uit. Markeer de vernieuwing als voltooid zodra het lidmaatschap overeenkomt met de bedoelde bronselectie. Bewaar het resultaat in je integratie, zodat de volgende uitvoering onderscheid kan maken tussen een voltooide en een onderbroken vernieuwing.

Als het proces halverwege stopt, hervat je het vanaf het vastgelegde werk of bereken je opnieuw het verschil met de huidige doelgroep. Een bestaand lid toevoegen laat het lidmaatschap intact. Een lid verwijderen verandert het lidmaatschap van die doelgroep, niet het contactrecord of de toestemming.

Controleer opnieuw de actuele afspraken over idempotentie en antwoorden van de bewerking voordat je een verzoek met een onzekere uitkomst automatisch herhaalt. Beschouw acceptatie van het verzoek, resultaten per invoer en de uiteindelijke afstemming als afzonderlijke waarnemingen.

## De doelgroep gebruiken voor verzending

Gebruik de voltooide selectie in het betreffende campagneproces. Leg vast wanneer de doelgroep voor het laatst is vernieuwd en controleer vóór verzending de actuele schatting van de broadcast. Contactgegevens, voorkeuren en suppressies kunnen veranderen nadat het lidmaatschap is vernieuwd.

Bij een Email-broadcast vernauwt de schatting het totale aantal leden eerst tot leden met een adres en daarna tot leden die kunnen worden aangeschreven. Het uiteindelijke bezorgresultaat is een afzonderlijke waarneming. Houd bij de analyse van resultaten het broncohort, de verzendcontext en de definitie van het bedrijfsresultaat bij elkaar.

## Problemen oplossen

- **Onverwachte verwijderingen:** controleer of de bronexport onvolledig is of dat een tweede proces dezelfde doelgroep wijzigt.
- **Hetzelfde mislukte contact keert elke uitvoering terug:** los het conflict met de bronidentificatiecode of de ongeldige eigenschap op in plaats van het contact steeds stilzwijgend over te slaan.
- **Mensen blijven aanwezig nadat ze het segment verlaten:** controleer of je integratie zowel verwijderingen als toevoegingen uitvoert.
- **Het aantal leden dat je kunt aanschrijven is kleiner:** controleer adressen, voorkeuren en suppressies in plaats van mensen opnieuw toe te voegen.

## Vervolgstappen

- [Doelgroeplidmaatschap en aantallen](/docs/guides/email/audiences)
- [Resultaten van contactimport en koppeling](/docs/guides/email/contacts)
- [Productgids voor doelgroepselectie](/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)