# Synchronizowanie członkostwa w grupie odbiorców

Użyj hurtowni danych, CRM lub aplikacji, aby ustalić, kto należy do kohorty, a następnie zastosuj ten wybór do grupy odbiorców Bird. Opublikowane API grup odbiorców przechowuje statyczne członkostwo. Ten wzorzec integracji utrzymuje jego zgodność ze źródłem oceniającym warunki, bez tworzenia drugiego zestawu reguł w procesie wysyłki.

## Zanim zaczniesz

Potrzebujesz nazwanej grupy odbiorców Bird, odpowiednich rekordów kontaktów i dostępu do udokumentowanych operacji na grupach odbiorców. Ustal, które źródło odpowiada za wybór i kto może zmieniać jego warunki. Użyj małej kohorty testowej, zanim uruchomisz integrację dla grupy odbiorców kampanii.

Zapisz warunki włączenia, wykluczenia i czas oceny. Dla kohorty klientów, którzy odnawiają usługę w przyszłym tygodniu, określ strefę czasową i to, co ma się stać, gdy źródło zarejestruje ukończone odnowienie. Wybór musi być na tyle odtwarzalny, aby można było sprawdzić obecność nieoczekiwanego członka.

## Dopasuj wybrane rekordy

1. Pobierz wynik ze źródła i zapisz w integracji jego czas oceny lub rewizję.
2. Utwórz lub zaktualizuj odpowiednie kontakty Bird za pomocą [operacji zbiorczej na kontaktach](/docs/api/reference/create-contact-batch). Świadomie użyj identyfikatora źródłowego do dopasowania.
3. Sprawdź wynik każdej pozycji. Zachowaj jej identyfikator źródłowy i wynikowy identyfikator kontaktu Bird w rejestrze uzgodnień integracji.
4. Rozwiąż konflikty identyfikatorów, zanim uznasz daną osobę za zsynchronizowaną. Żądanie zawierające pozycje zakończone sukcesem może też zawierać pozycje zakończone błędem.

Operacja zbiorcza na kontaktach przyjmuje `audience_ids` podczas dodawania rekordów do istniejących grup odbiorców. Używaj tego mechanizmu do dodawania, gdy pasuje do sytuacji. Usuwanie nadal wymaga osobnej decyzji o członkostwie. Import, który pomija osobę, nie jest poleceniem usunięcia jej z grupy ani skasowania kontaktu.

## Uzgodnij dodawanie i usuwanie członków

Odczytaj istniejące członkostwo za pomocą operacji [Wyświetl kontakty grupy odbiorców](/docs/api/reference/list-audience-contacts) i pobierz wszystkie strony wyników. Porównaj identyfikatory kontaktów Bird z dopasowanym wyborem ze źródła.

| Różnica                                              | Działanie                                                  |
| ---------------------------------------------------- | ---------------------------------------------------------- |
| Osoba wybrana w źródle, nieobecna w grupie odbiorców | Dodaj kontakt do grupy odbiorców                           |
| Osoba obecna w grupie odbiorców, nieobecna w źródle  | Usuń członkostwo, jeśli źródło zarządza tą grupą odbiorców |
| Osoba obecna w obu miejscach                         | Zachowaj członkostwo                                       |
| Nie udało się dopasować rekordu źródłowego           | Zbadaj przyczynę przed ukończeniem odświeżenia             |

Zastosuj zmiany za pomocą operacji [Dodaj kontakty do grupy odbiorców](/docs/api/reference/assign-audience-contacts) i [Usuń kontakty z grupy odbiorców](/docs/api/reference/unassign-audience-contacts). Przestrzegaj aktualnych limitów operacji zbiorczych podanych w tej dokumentacji.

Nie usuwaj osoby tylko dlatego, że eksport ze źródła był niepełny. Przed wyznaczeniem kontaktów do usunięcia potwierdź, że masz pełny wybór ze źródła, łącznie z ostatnią stroną. Unikaj też niezależnych ręcznych zmian członkostwa w grupie zarządzanej przez integrację, chyba że masz jasno określoną zasadę zachowywania tych zmian.

## Ukończ odświeżenie

Po zastosowaniu różnic sprawdź operacje zakończone błędem i ponownie odczytaj członkostwo, którego dotyczyły zmiany. Oznacz odświeżenie jako ukończone, gdy członkostwo jest zgodne z zamierzonym wyborem ze źródła. Zapisz wynik w integracji, aby następny przebieg mógł odróżnić odświeżenie ukończone od przerwanego.

Jeśli proces zatrzyma się w trakcie, wznów go na podstawie zapisanych działań lub ponownie oblicz różnicę względem aktualnej grupy odbiorców. Dodanie istniejącego członka pozostawia członkostwo bez zmian. Usunięcie członka zmienia członkostwo w tej grupie, a nie rekord kontaktu ani zgodę.

Ponownie sprawdź aktualne zasady idempotencji i specyfikację odpowiedzi operacji, zanim automatycznie ponowisz żądanie o niepewnym wyniku. Traktuj przyjęcie żądania, wyniki poszczególnych pozycji i końcowe uzgodnienie jako odrębne obserwacje.

## Połącz grupę odbiorców z wysyłką

Użyj ukończonego wyboru w odpowiednim procesie kampanii. Zapisz, kiedy ostatnio odświeżono grupę odbiorców, i przed wysyłką sprawdź aktualny szacunek broadcastu. Dane kontaktowe, preferencje i suppresje mogą zmienić się po odświeżeniu członkostwa.

W przypadku broadcastu Email szacunek zawęża całkowitą liczbę członków najpierw do osób z adresem, a następnie do osób, do których można wysłać wiadomość. Ostateczny wynik dostarczenia jest odrębną obserwacją. Podczas analizy wyników rozpatruj łącznie kohortę źródłową, kontekst wysyłki i definicję wyniku biznesowego.

## Rozwiązywanie problemów

- **Nieoczekiwane usunięcia:** sprawdź, czy eksport ze źródła był niepełny lub czy drugi proces zapisujący zmienia tę samą grupę odbiorców.
- **Ten sam kontakt z błędem powraca przy każdym przebiegu:** rozwiąż konflikt identyfikatora źródłowego lub popraw nieprawidłową właściwość zamiast stale pomijać kontakt bez wyjaśnienia.
- **Osoby pozostają po opuszczeniu segmentu:** sprawdź, czy integracja zarówno usuwa, jak i dodaje członków.
- **Liczba osób, do których można wysłać wiadomość, jest mniejsza:** sprawdź adresy, preferencje i suppresje zamiast ponownie dodawać osoby.

## Kolejne kroki

- [Członkostwo w grupie odbiorców i liczby członków](/docs/guides/email/audiences)
- [Wyniki importu kontaktów i dopasowywanie](/docs/guides/email/contacts)
- [Przewodnik produktowy po wyborze grupy odbiorców](/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)